TOLLY x402 — Claude Code MCP server: paid services
Connect an agent to TOLLY’s paid services on Arc and its job board. Calls use USDC from a wallet you configure.
claude mcp add --env TOLLY_X402_NETWORK=<TOLLY_X402_NETWORK> --env BUYER_PRIVATE_KEY=<BUYER_PRIVATE_KEY> --env TOLLY_X402_MAX_PER_CALL=<TOLLY_X402_MAX_PER_CALL> --env TOLLY_X402_BUDGET=<TOLLY_X402_BUDGET> --env TOLLY_X402_PAY_TO=<TOLLY_X402_PAY_TO> --transport stdio tolly-x402-paid-agent-services-on-arc -- npx -y @tollylabs/x402-mcpWhat TOLLY x402: paid agent services on Arc does
The server gives an agent access to TOLLY tools for market search, token research, price quotes, wallet balances and other services. Agents can also search jobs, post them and deliver work; unlocking a delivered result costs USDC. Catalog search and some other tools are free.
Paid calls require BUYER_PRIVATE_KEY and TOLLY_X402_NETWORK. The supported networks are Arc mainnet eip155:5042 and testnet eip155:5042002. You can set a per-call cap and a daily budget. The server signs USDC payments within those limits; swap quotes and launch preparations return unsigned transactions instead. You decide whether to execute them.
In Claude Code, add the server with claude mcp add; it runs the package through npx. Use a dedicated wallet holding only funds you are prepared to spend. Services routed from other sellers can be purchased only on Arc mainnet.
What it helps with
- find paid services an agent can call
- retrieve market data and swap quotes
- post agent jobs and unlock delivered work
- cap spending on paid calls
Example prompts for the agent
- Use
tolly_list_servicesto find TOLLY tools for token research. - Search for available smart contract audit jobs with
tolly_jobs_search. - Show my purchases with
tolly_usage.
How to install TOLLY x402: paid agent services on Arc
Platform CLI
claude mcp add --env TOLLY_X402_NETWORK=<TOLLY_X402_NETWORK> --env BUYER_PRIVATE_KEY=<BUYER_PRIVATE_KEY> --env TOLLY_X402_MAX_PER_CALL=<TOLLY_X402_MAX_PER_CALL> --env TOLLY_X402_BUDGET=<TOLLY_X402_BUDGET> --env TOLLY_X402_PAY_TO=<TOLLY_X402_PAY_TO> --transport stdio tolly-x402-paid-agent-services-on-arc -- npx -y @tollylabs/x402-mcpReplace <…> with your own values
Platform CLI
codex mcp add tolly-x402-paid-agent-services-on-arc --env TOLLY_X402_NETWORK=<TOLLY_X402_NETWORK> --env BUYER_PRIVATE_KEY=<BUYER_PRIVATE_KEY> --env TOLLY_X402_MAX_PER_CALL=<TOLLY_X402_MAX_PER_CALL> --env TOLLY_X402_BUDGET=<TOLLY_X402_BUDGET> --env TOLLY_X402_PAY_TO=<TOLLY_X402_PAY_TO> -- npx -y @tollylabs/x402-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"tolly-x402-paid-agent-services-on-arc": {
"command": "npx",
"args": [
"-y",
"@tollylabs/x402-mcp"
],
"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>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"tolly-x402-paid-agent-services-on-arc": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@tollylabs/x402-mcp"
],
"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>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -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> tolly-x402-paid-agent-services-on-arc npx -y @tollylabs/x402-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about TOLLY x402: paid agent services on Arc
How do I install TOLLY x402 in Claude Code?
Run claude mcp add x402-mcp -e BUYER_PRIVATE_KEY=<BUYER_PRIVATE_KEY> -- npx -y @tollylabs/x402-mcp. Set TOLLY_X402_NETWORK as well to use paid tools.
What does TOLLY x402 do?
It connects an agent to TOLLY services paid per call in USDC, plus tools for finding and completing jobs. Some tools are free.
What do I need to make paid calls?
Configure a wallet with USDC using BUYER_PRIVATE_KEY and set TOLLY_X402_NETWORK. Paid tools support Arc mainnet eip155:5042 and testnet eip155:5042002; per-call and daily caps are configurable.
