English Français العربية

Tollbooth Swap API

Registre officiel Finance et paiements

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

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http tollbooth-swap-api 'https://api.tollboothswap.xyz/mcp'
Configuration JSON (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
Configuration JSON (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>"
            }
        }
    }
}

Variables d'environnement

  • 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

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  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

Questions fréquentes

Qu'est-ce que Tollbooth Swap API ?

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

Comment installer Tollbooth Swap API ?

Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http tollbooth-swap-api 'https://api.tollboothswap.xyz/mcp'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour Tollbooth Swap API ?

Oui. Il attend TOLLBOOTH_PAYER_KEY, à renseigner dans sa configuration.

Tollbooth Swap API est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient Tollbooth Swap API ?

Il est publié par soundsparkaudiolab. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.