{
  "markdown": "# tollboothswap-mcp — Token Swaps & Honeypot Checks for AI Agents (MCP Server)\n\nMCP server for [Tollbooth](https://api.tollboothswap.xyz): non-custodial token\nswap execution and token safety screening on **8 chains** — Solana, Base,\nEthereum, Arbitrum, Polygon, Optimism, BSC, Avalanche. Quotes and symbol\nresolution are free; swap builds (~$0.005) and safety checks ($0.01) are paid\nper-call in USDC via the [x402 protocol](https://www.x402.org) — no API keys,\nno accounts, no subscriptions.\n\n## Quick start\n\n```bash\nnpx tollboothswap-mcp\n```\n\n### Claude Desktop / Cursor / any MCP client\n\n```json\n{\n  \"mcpServers\": {\n    \"tollbooth\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"tollboothswap-mcp\"],\n      \"env\": {\n        \"TOLLBOOTH_PAYER_KEY\": \"0x<EVM private key holding USDC on Base>\"\n      }\n    }\n  }\n}\n```\n\n`TOLLBOOTH_PAYER_KEY` is optional: without it the free tools\n(`resolve_token`, `get_quote`, `get_service_info`, `get_receipt`) work fully,\nand paid tools return x402 payment instructions instead of results. With it,\ntolls are paid automatically and gaslessly (EIP-3009 — the key never spends\ngas, only USDC).\n\n## Tools\n\n| Tool | Cost | What it does |\n| --- | --- | --- |\n| `resolve_token` | free | Ticker symbol → contract addresses, ranked by DEX liquidity |\n| `get_quote` | free | Fee-inclusive indicative swap quote |\n| `check_token` | $0.01 | Honeypot / rug-pull / freeze-authority / sell-tax screening with verdict + findings |\n| `build_swap` | ~$0.005 | Unsigned, ready-to-sign swap transaction + HMAC-signed receipt (`safeMode` screens both tokens first) |\n| `get_receipt` | free | Verify a past build receipt by id |\n| `get_service_info` | free | Service manifest: chains, fees, pricing |\n\n## Trust model\n\nTollbooth is non-custodial: it builds transactions but never holds keys or\nfunds. Your agent signs and submits everything with its own wallet. Every\npaid build returns a signed receipt for audit trails.\n\n## Links\n\n- Full tutorial: https://api.tollboothswap.xyz/guides/agent-swaps.md\n- Agent usage guide: https://api.tollboothswap.xyz/skill.md\n- Runnable HTTP examples: https://github.com/soundsparkaudiolab/tollbooth-examples\n\n## License\n\nMIT\n",
  "bytes": 2176,
  "sha": "ef90e17c5b224bfe6ef4fda46bba13df5c69bddb87e229325505c9197119cc59",
  "repo_slug": "soundsparkaudiolab/tollboothswap-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_xyz_tollboothswap_api_tollbooth_f8f2687a/readme"
}