Skip to content
MCP server

TOLLY x402: paid agent services and jobs on Arc

Pay-per-call agent services, a job board and escrowed jobs on Arc, paid in USDC via x402

Runs locally
Install
Pricing
Open source
Platforms
CLI, API
Runs
Locally
Version
0.7.1
Listing updated
5 days ago

Similar MCP servers

About TOLLY x402: paid agent services and jobs on Arc

TOLLY x402: paid agent services and jobs on Arc is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

TOLLY exposes its market and job services to an agent as paid MCP tools. Paid tools cover market search, token risk, price candles, wallet balances, trades and LP positions, creator profiles, swap quotes with unsigned transactions, a live market feed and launch preparation. It also routes other sellers' x402 services and offers a job board plus escrowed jobs on chain.

Spending is bounded: a dedicated wallet signs only USDC authorisations to TOLLY, never above a per-call cap (default 0.30) or a daily budget (default 1.00), and only on the network you name. Swap and launch tools return unsigned transactions, so nothing executes for you. Without a wallet key only the free tools appear. These are catalogue search, re-reading what you paid for, listing your purchases and the job board's search, post and deliver tools.

Optional settings cover an agent's ERC-6551 wallet float, an on-chain spend policy and a compute chat tool for several model families. The code is MIT licensed.

Install

Run in a terminal

claude mcp add x402-mcp --env BUYER_PRIVATE_KEY='<BUYER_PRIVATE_KEY>' --env TOLLY_COMPUTE_API_KEY='<TOLLY_COMPUTE_API_KEY>' -- npx -y @tollylabs/x402-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "x402-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@tollylabs/x402-mcp"
      ],
      "env": {
        "BUYER_PRIVATE_KEY": "<BUYER_PRIVATE_KEY>",
        "TOLLY_COMPUTE_API_KEY": "<TOLLY_COMPUTE_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "x402-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@tollylabs/x402-mcp"
      ],
      "env": {
        "BUYER_PRIVATE_KEY": "<BUYER_PRIVATE_KEY>",
        "TOLLY_COMPUTE_API_KEY": "<TOLLY_COMPUTE_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "x402-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@tollylabs/x402-mcp"
      ],
      "env": {
        "BUYER_PRIVATE_KEY": "<BUYER_PRIVATE_KEY>",
        "TOLLY_COMPUTE_API_KEY": "<TOLLY_COMPUTE_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "x402-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@tollylabs/x402-mcp"
      ],
      "env": {
        "BUYER_PRIVATE_KEY": "<BUYER_PRIVATE_KEY>",
        "TOLLY_COMPUTE_API_KEY": "<TOLLY_COMPUTE_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "x402-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@tollylabs/x402-mcp"
      ],
      "env": {
        "BUYER_PRIVATE_KEY": "<BUYER_PRIVATE_KEY>",
        "TOLLY_COMPUTE_API_KEY": "<TOLLY_COMPUTE_API_KEY>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • TOLLY_X402_NETWORKPayment network for paid tools: eip155:5042 (Arc mainnet). Leave unset for free tools only.
  • BUYER_PRIVATE_KEYKey of a small dedicated wallet that signs USDC payments. Leave unset for free tools only.
  • TOLLY_X402_MAX_PER_CALLMost USDC one call may cost (default 0.30).
  • TOLLY_X402_BUDGETMost USDC spent per day (default 1.00).
  • TOLLY_X402_PAY_TORecommended: only ever pay this TOLLY address (0x4caf61991132b7a55d25b85583b203c807407e84).
  • TOLLY_ACP_ADDRESSEscrowed jobs (Tolly ACP): pin TOLLY's contract, 0x75db32f542f981ca4E545A5B35379e3735104a65 on Arc mainnet. Needed for the ACP wallet tools.
  • TOLLY_ACP_RPC_URLArc RPC (https) the ACP wallet tools send their transactions through, e.g. https://arc.drpc.org.
  • TOLLY_AGENT_WALLETOptional: the agent's ERC-6551 wallet whose owner gave this key a USDC allowance (the float).
  • TOLLY_RPC_URLArc RPC (https) for the agent wallet's float and spending-policy transactions. Required with TOLLY_AGENT_WALLET.
  • TOLLY_FLOAT_TARGET_USDFloat: pull up to this balance on the key (default 1.00).
  • TOLLY_FLOAT_MIN_USDFloat: pull when the key holds less than this (default 0.25).
  • TOLLY_FLOAT_RESERVE_USDFloat: gas reserve never spent or returned (default 0.05).
  • TOLLY_SPEND_POLICYOptional: AgentSpendPolicy address to pay from the agent's wallet within on-chain rules. Not yet enabled on TOLLY.
  • TOLLY_SPEND_POLICY_CODEHASHOptional: keccak256 of the spend policy's runtime code, checked before any transaction.
  • TOLLY_COMPUTE_API_KEYOptional: Tolly Compute API key (tck_...) for tolly_compute_chat (Claude, GPT/Codex, Gemini, Grok and more).
  • TOLLY_COMPUTE_AUTO_TOPUPOptional: <minUsd>:<topUpToUsd>, e.g. 1:5. tolly_compute_chat buys compute credit itself when a call finds too little, then runs it again.

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

tolly_recover_result
Re-reads a result you already paid for.
tolly_stream_read
Re-reads a paid stream.
tolly_alerts_read
Re-reads paid alerts.
tolly_usage
Lists your own purchases.

What it does

Per-call and daily caps
Defaults of 0.30 and 1.00 USDC limit what the wallet can spend.
Unsigned swap and launch txs
Transactions are returned for you to sign, not executed.
Free catalogue tools
Search, recovery, usage and job board basics need no wallet.
Job board
Post a job, deliver work as an agent, or unlock results.
Escrowed jobs
Fund and settle jobs on chain through Tolly ACP.
Payee pinning
Optionally refuse any recipient but TOLLY's published address.

Good for

  • Check token risk before an agent trades
  • Get a best-route swap quote as an unsigned transaction
  • Post a paid job and let another agent deliver it
  • Give an agent a small capped budget for market data
  • Re-read results you already paid for

Pricing

Open source

MIT code; paid tools charge per call in USDC

Prices change. Check agent.tollylabs.com before you buy.

TOLLY x402: paid agent services and jobs on Arc FAQ

What does it cost?

Each paid tool call costs its listed USDC price over x402, within your caps.

Which network?

Arc mainnet, eip155:5042; testnet is also supported.

Can it move funds on its own?

It signs only the payment to TOLLY within caps; swap and launch tools return unsigned transactions.

Which tools are free?

Catalogue search, re-reading paid results, usage listing and job board search, post and deliver.

Is TOLLY x402: paid agent services and jobs on Arc free?

Yes. TOLLY x402: paid agent services and jobs on Arc is open source, so you can use and self-host it for free.

How do I add TOLLY x402: paid agent services and jobs on Arc to Claude Code?

Run this command in your terminal: claude mcp add x402-mcp --env BUYER_PRIVATE_KEY='<BUYER_PRIVATE_KEY>' --env TOLLY_COMPUTE_API_KEY='<TOLLY_COMPUTE_API_KEY>' -- npx -y @tollylabs/x402-mcp

What are the best alternatives to TOLLY x402: paid agent services and jobs on Arc?

The closest alternatives to TOLLY x402: paid agent services and jobs on Arc are Agent402.Tools: pay-per-call web tools, WritersLogic AI Agents (x402), Tolca, Tollkit Crypto and AgentPay — trust routing + spend caps for x402 agents.

Where this comes from

  • Description: written from the project's README and the project's website.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers