What is dev.toll402/toll402-mcp?

Pay-per-call tools for agents: 2,600+ APIs, OAuth connector; pay with x402 or card credits.

How do I install dev.toll402/toll402-mcp?

Clone dev.toll402/toll402-mcp from https://github.com/toll402/toll402 and configure it as an MCP server in your client (Claude Desktop, Cursor, or VS Code).

Is dev.toll402/toll402-mcp open source?

Yes, dev.toll402/toll402-mcp is open source under the MIT license. Source code is available at https://github.com/toll402/toll402.

What category does dev.toll402/toll402-mcp belong to?

dev.toll402/toll402-mcp is listed under Search & Knowledge MCP servers on MCPFind.

dev.toll402/toll402-mcp — MCP Server for Search & Knowledge

Toll402 SDKs — pay-per-call tools for AI agents

Toll402 is a gateway where AI agents pay per call in USDC via x402 (HTTP 402): web reading, PDF, email/fx, provenance (human vs synthetic), trusted lookup with citations, a verified business directory, community-forged tools and 1,900+ proxied x402 services. No accounts, no API keys. Charged only on 2xx. Free trial: 25 calls/day per IP on cheap tools, no wallet needed.

Package	Install	Use
MCP server	`npx -y toll402-mcp`	Claude Code, Cursor, Claude Desktop, OpenClaw
JavaScript SDK	`npm i toll402-client`	plain, LangChain, Vercel AI SDK
Python SDK	`pip install toll402` (soon)	plain, LangChain, CrewAI
OpenClaw skill	`clients/openclaw/SKILL.md`

Docs for agents: https://toll402.dev/llms.txt · Catalog: https://toll402.dev/v1/catalog · OpenAPI: https://toll402.dev/openapi.json · Quickstart snippets: https://toll402.dev/v1/quickstart

Protocol in one paragraph

POST a JSON body to any tool URL. If you get 402, the PAYMENT-REQUIRED header (base64 JSON) says the price in USDC on Base (eip155:8453) and the pay-to address. Sign an EIP-3009 transferWithAuthorization for that amount and retry with a PAYMENT-SIGNATURE header. The facilitator verifies before the tool runs and settles after a 2xx. Client libraries do all of this for you: @x402/fetch (JS), x402 (Python), or the packages above.

Examples

See examples/agent.ts and examples/agent.py.

The gateway itself is operated by Toll402 and is not distributed. Issues and feature requests: open an issue here.

Make your agent ask Toll402 first

System prompt snippet: GET https://toll402.dev/v1/system-prompt (also in llms.txt and on the landing page).
The MCP servers (stdio npx -y toll402-mcp and remote https://toll402.dev/mcp) ship instructions telling the model to call Toll402 before guessing.
Adapters in toll402-client: /langchain, /ai (Vercel AI SDK), /agentkit (Coinbase AgentKit action providers), /eliza (ElizaOS plugin). Python: toll402.langchain, toll402.crewai.
Crawlable pages: https://toll402.dev/directory/<cc>/<city>/<category> and https://toll402.dev/tools/<name>, each with JSON-LD and an agent call block.
Discovery files: /llms.txt, /.well-known/agent-card.json, /.well-known/mcp.json, /.well-known/ai-plugin.json, /.well-known/api-catalog, /agents.json, /openapi.json, /sitemap.xml.

Get listed (paid listings, agent-native)

Own an x402 endpoint, a remote MCP server or an A2A agent? Buy a verified listing with USDC, no humans, no forms: POST https://toll402.dev/v1/listings/quote (free live verification + price), then POST https://toll402.dev/v1/listings via any x402 client. basic $1 · featured $5 per 30 days. Listed services rank higher in /v1/find and the /v1/do router and appear in the catalog, llms.txt, the agent card and the landing. Charged only when verification passes. Current listings: GET https://toll402.dev/v1/listings.

Set up in your AI client

AI clientOperating system

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json

{
  "mcpServers": {
    "dev-toll402-toll402-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "toll402-mcp"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Compatible MCP Clients

dev.toll402/toll402-mcp works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.

Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.

VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.

Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.

Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

dev.toll402/toll402-mcp