@tollylabs/x402-mcp

An MCP server that gives an AI agent TOLLY's paid services on Arc (Circle's chain): market search, token intelligence and risk, price candles, wallet balances, trades and LP positions, creator profiles, best-route swap quotes with unsigned transactions, a live market feed, and launch preparation. Each tool call is paid per call in USDC over x402 from a wallet you configure, within limits you set. Nothing is free except listing the catalog and re-reading what you paid for.

It never signs anything but a USDC transferWithAuthorization to the service, never more than a tool's listed price, never above your per-call cap or daily budget, and only on the network you name. Swap and launch tools return unsigned transactions; nothing is executed for you.

Setup

Use a dedicated wallet that holds only what you are willing to spend.

Claude Code:

claude mcp add tolly -e BUYER_PRIVATE_KEY=0x... -e TOLLY_X402_NETWORK=eip155:5042002 -- npx -y @tollylabs/x402-mcp

Claude Desktop / other MCP clients (mcpServers entry):

{
  "tolly": {
    "command": "npx",
    "args": ["-y", "@tollylabs/x402-mcp"],
    "env": {
      "BUYER_PRIVATE_KEY": "0x...",
      "TOLLY_X402_NETWORK": "eip155:5042002",
      "TOLLY_X402_MAX_PER_CALL": "0.30",
      "TOLLY_X402_BUDGET": "1.00"
    }
  }
}

| Variable | Meaning | |---|---| | BUYER_PRIVATE_KEY | Key of the paying wallet (USDC on the payment network). Without it only the free tools appear. | | TOLLY_X402_NETWORK | Payment network, required for paid tools: eip155:5042002 (Arc testnet, current) or eip155:5042 (Arc mainnet, when enabled). Services priced on another network are not offered. | | TOLLY_X402_MAX_PER_CALL | Hard cap per call in USDC (default 0.30). | | TOLLY_X402_BUDGET | Spend cap per wallet per UTC day in USDC (default 1.00), kept across restarts in TOLLY_X402_LEDGER (default ~/.tolly-x402/spend.json). | | TOLLY_X402_PAY_TO | Optional: refuse any payee but this address. | | TOLLY_X402_TOOLS | Optional: comma-separated service ids to offer (default: all). | | TOLLY_X402_URL | Service URL (default https://agent.tollylabs.com; https only). |

Tools

One tool per purchasable service (tolly_<service id>), with the price in its description and the service's JSON Schema as input, plus three free tools: tolly_list_services, tolly_recover_result (re-read a paid answer with its job token) and tolly_stream_read (read a purchased market-stream ticket). The catalog, schemas and limits: https://agent.tollylabs.com, /llms.txt, /openapi.json.

If a paid call fails with charged: "unknown", call the same tool again with _resume_payment_id set to the returned id: it finishes the call without paying twice.