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
claude mcp add --transport http toll402-mcp https://toll402.dev/connector/mcpWhat 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/mcp2Platform 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-mcpReplace <…> with your own values
1Platform CLI: remote server
codex mcp add toll402-mcp --url https://toll402.dev/connector/mcp2Platform CLI
codex mcp add toll402-mcp --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> -- npx -y toll402-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"toll402-mcp": {
"url": "https://toll402.dev/connector/mcp"
}
}
}{
"mcpServers": {
"toll402-mcp": {
"command": "npx",
"args": [
"-y",
"toll402-mcp"
],
"env": {
"TOLL402_WALLET_KEY": "<TOLL402_WALLET_KEY>",
"TOLL402_API_KEY": "<TOLL402_API_KEY>",
"TOLL402_URL": "<TOLL402_URL>",
"TOLL402_MAX_USD": "<TOLL402_MAX_USD>",
"TOLL402_REF": "<TOLL402_REF>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"toll402-mcp": {
"type": "http",
"url": "https://toll402.dev/connector/mcp"
}
}
}{
"servers": {
"toll402-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"toll402-mcp"
],
"env": {
"TOLL402_WALLET_KEY": "<TOLL402_WALLET_KEY>",
"TOLL402_API_KEY": "<TOLL402_API_KEY>",
"TOLL402_URL": "<TOLL402_URL>",
"TOLL402_MAX_USD": "<TOLL402_MAX_USD>",
"TOLL402_REF": "<TOLL402_REF>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http toll402-mcp https://toll402.dev/connector/mcp2Platform CLI
gemini mcp add -e TOLL402_WALLET_KEY=<TOLL402_WALLET_KEY> -e TOLL402_API_KEY=<TOLL402_API_KEY> -e TOLL402_URL=<TOLL402_URL> -e TOLL402_MAX_USD=<TOLL402_MAX_USD> -e TOLL402_REF=<TOLL402_REF> toll402-mcp npx -y toll402-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 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.