Tollbooth Swap API

tollboothswap-mcp — 面向 AI Agent 的代币兑换与蜜罐检测（MCP 服务）

适用于 Tollbooth 的 MCP 服务：在 8 条链上执行非托管代币兑换并筛查代币安全性——Solana、Base、Ethereum、Arbitrum、Polygon、Optimism、BSC、Avalanche。报价和符号解析免费；兑换构建（约 $0.005）和安全检查（$0.01）按次通过 x402 protocol 使用 USDC 付费——无需 API 密钥、账户或订阅。

快速开始

npx tollboothswap-mcp

Claude Desktop / Cursor / 任意 MCP 客户端

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

TOLLBOOTH_PAYER_KEY 为可选项：不设置时，免费工具（resolve_token、get_quote、get_service_info、get_receipt）仍可正常使用，付费工具则会返回 x402 付款指引，而非结果。设置后，费用会自动支付且无需支付 Gas（EIP-3009 — 密钥不会支付 Gas，仅支付 USDC）。

工具

工具	费用	功能
resolve_token	免费	代币代码 → 合约地址，并按 DEX 流动性排序
get_quote	免费	包含费用的参考兑换报价
check_token	$0.01	蜜罐 / Rug Pull / 冻结权限 / 卖出税筛查，并提供判定结果和发现
build_swap	约 $0.005	未签名、可直接签名的兑换交易 + HMAC 签名收据（safeMode 会先筛查两种代币）
get_receipt	免费	按 ID 验证过往的构建收据
get_service_info	免费	服务清单：链、费用、定价

信任模型

Tollbooth 采用非托管模式：它会构建交易，但绝不持有密钥或资金。你的 Agent 使用自己的钱包签署并提交所有交易。每次付费构建都会返回一份已签名的收据，以便审计追踪。

链接

• 完整教程：https://api.tollboothswap.xyz/guides/agent-swaps.md
• Agent 使用指南：https://api.tollboothswap.xyz/skill.md
• 可运行的 HTTP 示例：https://github.com/soundsparkaudiolab/tollbooth-examples

许可证

MIT