English Français العربية

Tollbooth Swap API

السجل الرسمي المالية والمدفوعات

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

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

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

متغيرات البيئة

  • TOLLBOOTH_PAYER_KEY سري 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)

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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

الأسئلة الشائعة

ما هو Tollbooth Swap API؟

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

كيف أثبّت Tollbooth Swap API؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http tollbooth-swap-api 'https://api.tollboothswap.xyz/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Tollbooth Swap API إلى مفتاح API؟

نعم. يتطلب TOLLBOOTH_PAYER_KEY، وتضبطها في إعداداته.

هل Tollbooth Swap API مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Tollbooth Swap API؟

ينشره soundsparkaudiolab. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.