English Français العربية

Tollbooth Swap API

Official registry Finance and payments

Token swaps and honeypot/rug checks for AI agents on 8 chains, paid per-call in USDC via x402.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http tollbooth-swap-api 'https://api.tollboothswap.xyz/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "tollbooth-swap-api": {
            "type": "http",
            "url": "https://api.tollboothswap.xyz/mcp"
        }
    }
}
NPM package tollboothswap-mcp
Claude Code 
claude mcp add tollbooth-swap-api -e 'TOLLBOOTH_PAYER_KEY=<your tollbooth_payer_key>' -e 'TOLLBOOTH_URL=<TOLLBOOTH_URL>' -- npx -y tollboothswap-mcp@1.0.3
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "tollbooth-swap-api": {
            "command": "npx",
            "args": [
                "-y",
                "tollboothswap-mcp@1.0.3"
            ],
            "env": {
                "TOLLBOOTH_PAYER_KEY": "<your tollbooth_payer_key>",
                "TOLLBOOTH_URL": "<TOLLBOOTH_URL>"
            }
        }
    }
}

Environment variables

  • TOLLBOOTH_PAYER_KEY secret Optional 0x-prefixed EVM private key holding USDC on Base; pays x402 tolls automatically and gaslessly. Free tools work without it.
  • TOLLBOOTH_URL Tollbooth API base URL (default https://api.tollboothswap.xyz)

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. tollboothswap-mcp — Token Swaps & Honeypot Checks for AI Agents (MCP Server)
  2. Quick start
  3. Tools
  4. Trust model
  5. Links
  6. License

tollboothswap-mcp — Token Swaps & Honeypot Checks for AI Agents (MCP Server)

MCP server for Tollbooth: non-custodial token swap execution and token safety screening on 8 chains — Solana, Base, Ethereum, Arbitrum, Polygon, Optimism, BSC, Avalanche. Quotes and symbol resolution are free; swap builds (~$0.005) and safety checks ($0.01) are paid per-call in USDC via the x402 protocol — no API keys, no accounts, no subscriptions.

Quick start

npx tollboothswap-mcp
Claude Desktop / Cursor / any MCP client
{
  "mcpServers": {
    "tollbooth": {
      "command": "npx",
      "args": ["-y", "tollboothswap-mcp"],
      "env": {
        "TOLLBOOTH_PAYER_KEY": "0x<EVM private key holding USDC on Base>"
      }
    }
  }
}

TOLLBOOTH_PAYER_KEY is optional: without it the free tools (resolve_token, get_quote, get_service_info, get_receipt) work fully, and paid tools return x402 payment instructions instead of results. With it, tolls are paid automatically and gaslessly (EIP-3009 — the key never spends gas, only USDC).

Tools

ToolCostWhat it does
resolve_tokenfreeTicker symbol → contract addresses, ranked by DEX liquidity
get_quotefreeFee-inclusive indicative swap quote
check_token$0.01Honeypot / rug-pull / freeze-authority / sell-tax screening with verdict + findings
build_swap~$0.005Unsigned, ready-to-sign swap transaction + HMAC-signed receipt (safeMode screens both tokens first)
get_receiptfreeVerify a past build receipt by id
get_service_infofreeService manifest: chains, fees, pricing

Trust model

Tollbooth is non-custodial: it builds transactions but never holds keys or funds. Your agent signs and submits everything with its own wallet. Every paid build returns a signed receipt for audit trails.

License

MIT

Frequently asked questions

What is Tollbooth Swap API?

Token swaps and honeypot/rug checks for AI agents on 8 chains, paid per-call in USDC via x402.

How do I install Tollbooth Swap API?

It runs as a remote server. In Claude Code: claude mcp add --transport http tollbooth-swap-api 'https://api.tollboothswap.xyz/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Tollbooth Swap API need an API key?

Yes. It expects TOLLBOOTH_PAYER_KEY, which you set in its configuration.

Is Tollbooth Swap API open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Tollbooth Swap API?

It is published by soundsparkaudiolab. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.