Skip to main content
MCP server CX Codex

toll402-mcp — Claude Code MCP server: what it does, how to install

toll402-mcp connects an agent to a paid toolkit — web and PDF reading, email checks, currency rates — and bills only when a call succeeds.

MIT updated 2026-09-29

Install into Claude Code · Platform CLI: remote server All methods and platforms ↓
claude mcp add --transport http toll402-mcp https://toll402.dev/connector/mcp
Open on GitHub

What toll402-mcp does

The server exposes a catalog of tools: fetching pages and PDFs as clean Markdown, validating email addresses against MX records and disposable domains, pulling ECB currency rates, turning a page into JSON against a schema you supply, scoring a candidate answer against a task, pulling cited passages from sources like Wikipedia and Crossref, and searching or verifying businesses in a global directory. Separate tools build a profile of a company straight from its own website or shortlist suppliers for a stated need.

Payment runs through one of two rails: prepaid credits bought by card and sent as the TOLL402_API_KEY, or a wallet holding USDC on Base authenticated with TOLL402_WALLET_KEY, with TOLL402_MAX_USD capping how much a single call can spend under the x402 protocol. Either way, money moves only after a call returns successfully.

Setup in Claude Code over HTTP needs no environment variables, while the npx -y toll402-mcp route takes an API key or wallet key, a server URL and a dollar cap. The gateway that processes the calls runs on toll402.dev and isn't shipped as a separate package.

What it helps with

  • fetch a web page or PDF as clean Markdown
  • validate an email address against MX records and disposable domains
  • look up a currency exchange rate from ECB data
  • convert a page into JSON matching a given schema
  • check whether a business has a live site and working phone number

Example prompts for the agent

  • Read this page through toll402 and return it as Markdown
  • Validate [email protected] and give me a score out of 100
  • Look up today's USD to EUR exchange rate

How to install toll402-mcp

1Platform CLI: remote server

claude mcp add --transport http toll402-mcp https://toll402.dev/connector/mcp

2Platform CLI

claude mcp add --env TOLL402_WALLET_KEY=<TOLL402_WALLET_KEY> --env TOLL402_API_KEY=<TOLL402_API_KEY> --env TOLL402_URL=<TOLL402_URL> --env TOLL402_MAX_USD=<TOLL402_MAX_USD> --env TOLL402_REF=<TOLL402_REF> --transport stdio toll402-mcp -- npx -y toll402-mcp

Replace <…> 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 toll402-mcp

How do I install toll402-mcp in Claude Code?

Over HTTP: claude mcp add --transport http toll402-mcp https://toll402.dev/connector/mcp. Over stdio with environment variables: `claude mcp add --env TOLL402_WALLET_KEY=<TOLL402_WALLET_KEY> --env TOLL402_API_KEY=<TOLL402_API_KEY> --env TOLL402_URL=<TOLL402_URL> --env TOLL402_MAX_USD=<TOLL402_MAX_USD> --env TOLL402_REF=<TOLL402_REF> --transport stdio toll402-mcp -- npx -y toll402-mcp`.

What does toll402-mcp do?

It gives an agent access to a set of paid tools: reading web pages and PDFs, validating emails, pulling currency rates, extracting structured data, judging model output, citing trusted sources, and checking whether businesses in a directory are real.

How are calls to toll402-mcp billed?

Either through prepaid credits tied to the TOLL402_API_KEY, bought by card in advance, or through a wallet holding USDC on Base authenticated with TOLL402_WALLET_KEY, where TOLL402_MAX_USD caps spend per call under x402. Billing happens only after a call succeeds.

Similar MCP servers

All MCP servers for Agent setup: memory, context, orchestration →

Project sponsors

Companies that keep this analytics open