TOLLY x402: paid agent services and jobs on Arc

com.tollylabs/x402-mcp · v0.7.1

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

Website Source code Set it up

Connect Runs on your machine

Terminal

claude mcp add x402-mcp -e TOLLY_X402_NETWORK=<TOLLY_X402_NETWORK> -e BUYER_PRIVATE_KEY=<BUYER_PRIVATE_KEY> -e TOLLY_X402_MAX_PER_CALL=<TOLLY_X402_MAX_PER_CALL> -e TOLLY_X402_BUDGET=<TOLLY_X402_BUDGET> -e TOLLY_X402_PAY_TO=<TOLLY_X402_PAY_TO> -e TOLLY_ACP_ADDRESS=<TOLLY_ACP_ADDRESS> -e TOLLY_ACP_RPC_URL=<TOLLY_ACP_RPC_URL> -e TOLLY_AGENT_WALLET=<TOLLY_AGENT_WALLET> -e TOLLY_RPC_URL=<TOLLY_RPC_URL> -e TOLLY_FLOAT_TARGET_USD=<TOLLY_FLOAT_TARGET_USD> -e TOLLY_FLOAT_MIN_USD=<TOLLY_FLOAT_MIN_USD> -e TOLLY_FLOAT_RESERVE_USD=<TOLLY_FLOAT_RESERVE_USD> -e TOLLY_SPEND_POLICY=<TOLLY_SPEND_POLICY> -e TOLLY_SPEND_POLICY_CODEHASH=<TOLLY_SPEND_POLICY_CODEHASH> -e TOLLY_COMPUTE_API_KEY=<TOLLY_COMPUTE_API_KEY> -e TOLLY_COMPUTE_AUTO_TOPUP=<TOLLY_COMPUTE_AUTO_TOPUP> -- npx -y @tollylabs/[email protected]

claude_desktop_config.json

{
  "mcpServers": {
    "x402-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@tollylabs/[email protected]"
      ],
      "env": {
        "TOLLY_X402_NETWORK": "<TOLLY_X402_NETWORK>",
        "BUYER_PRIVATE_KEY": "<BUYER_PRIVATE_KEY>",
        "TOLLY_X402_MAX_PER_CALL": "<TOLLY_X402_MAX_PER_CALL>",
        "TOLLY_X402_BUDGET": "<TOLLY_X402_BUDGET>",
        "TOLLY_X402_PAY_TO": "<TOLLY_X402_PAY_TO>",
        "TOLLY_ACP_ADDRESS": "<TOLLY_ACP_ADDRESS>",
        "TOLLY_ACP_RPC_URL": "<TOLLY_ACP_RPC_URL>",
        "TOLLY_AGENT_WALLET": "<TOLLY_AGENT_WALLET>",
        "TOLLY_RPC_URL": "<TOLLY_RPC_URL>",
        "TOLLY_FLOAT_TARGET_USD": "<TOLLY_FLOAT_TARGET_USD>",
        "TOLLY_FLOAT_MIN_USD": "<TOLLY_FLOAT_MIN_USD>",
        "TOLLY_FLOAT_RESERVE_USD": "<TOLLY_FLOAT_RESERVE_USD>",
        "TOLLY_SPEND_POLICY": "<TOLLY_SPEND_POLICY>",
        "TOLLY_SPEND_POLICY_CODEHASH": "<TOLLY_SPEND_POLICY_CODEHASH>",
        "TOLLY_COMPUTE_API_KEY": "<TOLLY_COMPUTE_API_KEY>",
        "TOLLY_COMPUTE_AUTO_TOPUP": "<TOLLY_COMPUTE_AUTO_TOPUP>"
      }
    }
  }
}

~/.cursor/mcp.json

{
  "mcpServers": {
    "x402-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@tollylabs/[email protected]"
      ],
      "env": {
        "TOLLY_X402_NETWORK": "<TOLLY_X402_NETWORK>",
        "BUYER_PRIVATE_KEY": "<BUYER_PRIVATE_KEY>",
        "TOLLY_X402_MAX_PER_CALL": "<TOLLY_X402_MAX_PER_CALL>",
        "TOLLY_X402_BUDGET": "<TOLLY_X402_BUDGET>",
        "TOLLY_X402_PAY_TO": "<TOLLY_X402_PAY_TO>",
        "TOLLY_ACP_ADDRESS": "<TOLLY_ACP_ADDRESS>",
        "TOLLY_ACP_RPC_URL": "<TOLLY_ACP_RPC_URL>",
        "TOLLY_AGENT_WALLET": "<TOLLY_AGENT_WALLET>",
        "TOLLY_RPC_URL": "<TOLLY_RPC_URL>",
        "TOLLY_FLOAT_TARGET_USD": "<TOLLY_FLOAT_TARGET_USD>",
        "TOLLY_FLOAT_MIN_USD": "<TOLLY_FLOAT_MIN_USD>",
        "TOLLY_FLOAT_RESERVE_USD": "<TOLLY_FLOAT_RESERVE_USD>",
        "TOLLY_SPEND_POLICY": "<TOLLY_SPEND_POLICY>",
        "TOLLY_SPEND_POLICY_CODEHASH": "<TOLLY_SPEND_POLICY_CODEHASH>",
        "TOLLY_COMPUTE_API_KEY": "<TOLLY_COMPUTE_API_KEY>",
        "TOLLY_COMPUTE_AUTO_TOPUP": "<TOLLY_COMPUTE_AUTO_TOPUP>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "x402-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@tollylabs/[email protected]"
      ],
      "env": {
        "TOLLY_X402_NETWORK": "<TOLLY_X402_NETWORK>",
        "BUYER_PRIVATE_KEY": "<BUYER_PRIVATE_KEY>",
        "TOLLY_X402_MAX_PER_CALL": "<TOLLY_X402_MAX_PER_CALL>",
        "TOLLY_X402_BUDGET": "<TOLLY_X402_BUDGET>",
        "TOLLY_X402_PAY_TO": "<TOLLY_X402_PAY_TO>",
        "TOLLY_ACP_ADDRESS": "<TOLLY_ACP_ADDRESS>",
        "TOLLY_ACP_RPC_URL": "<TOLLY_ACP_RPC_URL>",
        "TOLLY_AGENT_WALLET": "<TOLLY_AGENT_WALLET>",
        "TOLLY_RPC_URL": "<TOLLY_RPC_URL>",
        "TOLLY_FLOAT_TARGET_USD": "<TOLLY_FLOAT_TARGET_USD>",
        "TOLLY_FLOAT_MIN_USD": "<TOLLY_FLOAT_MIN_USD>",
        "TOLLY_FLOAT_RESERVE_USD": "<TOLLY_FLOAT_RESERVE_USD>",
        "TOLLY_SPEND_POLICY": "<TOLLY_SPEND_POLICY>",
        "TOLLY_SPEND_POLICY_CODEHASH": "<TOLLY_SPEND_POLICY_CODEHASH>",
        "TOLLY_COMPUTE_API_KEY": "<TOLLY_COMPUTE_API_KEY>",
        "TOLLY_COMPUTE_AUTO_TOPUP": "<TOLLY_COMPUTE_AUTO_TOPUP>"
      }
    }
  }
}

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools

This server runs locally, so its tools are listed by your MCP client once it starts.

Environment variables

Name	Description
`TOLLY_X402_NETWORK` Optional	Payment network for paid tools: eip155:5042 (Arc mainnet). Leave unset for free tools only.
`BUYER_PRIVATE_KEY` Optional, secret	Key of a small dedicated wallet that signs USDC payments. Leave unset for free tools only.
`TOLLY_X402_MAX_PER_CALL` Optional	Most USDC one call may cost (default 0.30).
`TOLLY_X402_BUDGET` Optional	Most USDC spent per day (default 1.00).
`TOLLY_X402_PAY_TO` Optional	Recommended: only ever pay this TOLLY address (0x4caf61991132b7a55d25b85583b203c807407e84).
`TOLLY_ACP_ADDRESS` Optional	Escrowed jobs (Tolly ACP): pin TOLLY's contract, 0x75db32f542f981ca4E545A5B35379e3735104a65 on Arc mainnet. Needed for the ACP wallet tools.
`TOLLY_ACP_RPC_URL` Optional	Arc RPC (https) the ACP wallet tools send their transactions through, e.g. https://arc.drpc.org.
`TOLLY_AGENT_WALLET` Optional	Optional: the agent's ERC-6551 wallet whose owner gave this key a USDC allowance (the float).
`TOLLY_RPC_URL` Optional	Arc RPC (https) for the agent wallet's float and spending-policy transactions. Required with TOLLY_AGENT_WALLET.
`TOLLY_FLOAT_TARGET_USD` Optional	Float: pull up to this balance on the key (default 1.00).
`TOLLY_FLOAT_MIN_USD` Optional	Float: pull when the key holds less than this (default 0.25).
`TOLLY_FLOAT_RESERVE_USD` Optional	Float: gas reserve never spent or returned (default 0.05).
`TOLLY_SPEND_POLICY` Optional	Optional: AgentSpendPolicy address to pay from the agent's wallet within on-chain rules. Not yet enabled on TOLLY.
`TOLLY_SPEND_POLICY_CODEHASH` Optional	Optional: keccak256 of the spend policy's runtime code, checked before any transaction.
`TOLLY_COMPUTE_API_KEY` Optional, secret	Optional: Tolly Compute API key (tck_...) for tolly_compute_chat (Claude, GPT/Codex, Gemini, Grok and more).
`TOLLY_COMPUTE_AUTO_TOPUP` Optional	Optional: <minUsd>:<topUpToUsd>, e.g. 1:5. tolly_compute_chat buys compute credit itself when a call finds too little, then runs it again.

Details

Package	`@tollylabs/[email protected]` (NPM, stdio)
First published	5 Nov 2026
Last updated	5 Nov 2026
Registry name	`com.tollylabs/x402-mcp`

More ai and media servers See all

Live status

Local install

Installed and run on your own machine, so there is no public endpoint to check.

Pair it with live search

Agents that use TOLLY x402: paid agent services and jobs on Arc often also need current facts. NestDaddy MCP gives your AI today's internet: web search, real-time breaking news and full page reading in one connector.

See NestDaddy MCP

For maintainers

[![NestDaddy MCP](https://nestdaddy.com/mcp/servers/com-tollylabs-x402-mcp/badge.svg)](https://nestdaddy.com/mcp/servers/com-tollylabs-x402-mcp)

Add the badge to your README. It turns green while your server passes our daily check. Listing details come from the official MCP registry; update them there.

Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.