# toll402-mcp

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

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: toll402
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/toll402/toll402
- Updated: 2026-09-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/toll402-mcp

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://toll402.dev/connector/mcp`
- Environment variables: `TOLL402_WALLET_KEY`, `TOLL402_API_KEY`, `TOLL402_URL`, `TOLL402_MAX_USD`, `TOLL402_REF` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http toll402-mcp https://toll402.dev/connector/mcp
```

2. **Platform CLI**
```bash
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

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add toll402-mcp --url https://toll402.dev/connector/mcp
```

2. **Platform CLI**
```bash
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-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "toll402-mcp": {
            "url": "https://toll402.dev/connector/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "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

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "toll402-mcp": {
            "type": "http",
            "url": "https://toll402.dev/connector/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "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

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http toll402-mcp https://toll402.dev/connector/mcp
```

2. **Platform CLI**
```bash
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-mcp
```
Replace <…> with your own values

## When to use it
- 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
- Read this page through toll402 and return it as Markdown
- Validate client@example.com and give me a score out of 100
- Look up today's USD to EUR exchange rate

## Similar
- [Skavio USDC Payment Verification & Proof MCP](https://affpapa.org/en/nevibecode/mcp/skavio-usdc-payment-verification-proof-mcp.md) — MCP server
- [mcp](https://affpapa.org/en/nevibecode/mcp/clawfetch-mcp.md) — MCP server
- [CoreNexis API](https://affpapa.org/en/nevibecode/mcp/corenexis-api.md) — MCP server
- [Shipping Rates](https://affpapa.org/en/nevibecode/mcp/shipping-rates.md) — MCP server · 1820 installs
- [MoltPe](https://affpapa.org/en/nevibecode/mcp/moltpe.md) — MCP server · 170 installs
- [fetcher](https://affpapa.org/en/nevibecode/skills/fetcher.md) — skill · 4700 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
