tollboothswap-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@tollboothswap-mcp Check if the token DOGE on BSC is a honeypot"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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-mcpClaude 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).
Related MCP server: RobinX
Tools
Tool | Cost | What it does |
| free | Ticker symbol → contract addresses, ranked by DEX liquidity |
| free | Fee-inclusive indicative swap quote |
| $0.01 | Honeypot / rug-pull / freeze-authority / sell-tax screening with verdict + findings |
| ~$0.005 | Unsigned, ready-to-sign swap transaction + HMAC-signed receipt ( |
| free | Verify a past build receipt by id |
| free | Service 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.
Links
Full tutorial: https://api.tollboothswap.xyz/guides/agent-swaps.md
Agent usage guide: https://api.tollboothswap.xyz/skill.md
Runnable HTTP examples: https://github.com/soundsparkaudiolab/tollbooth-examples
License
MIT
Available Tools
6 toolsbuild_swapBuild swap transactionAInspect
Build an unsigned swap transaction for the taker wallet to sign and submit. Costs an x402 toll (paid automatically when TOLLBOOTH_PAYER_KEY is set). Returns the transaction, the quote, and a signed receipt.
Inputs: chain (required), taker (required), amount (required), inputToken (required), +3 more. Returns: next, chain, error, quote, +4 more
check_tokenCheck token safetyAIdempotentInspect
Token safety screen before trading: honeypot, rug-pull, freeze/mint authority, transfer hooks, sell tax, blacklists. Returns verdict (ok/warn/critical/unknown), a 0-100 risk score, and itemized findings. Costs an x402 toll.
Inputs: chain (required), token (required). Returns: next, chain, error, token, +5 more
get_quoteGet swap quoteARead-onlyIdempotentInspect
Get a free indicative swap quote (output amount includes Tollbooth's fee). Use before build_swap to decide whether to trade.
Inputs: chain (required), amount (required), inputToken (required), outputToken (required), +1 more. Returns: next, chain, feeBps, inputToken, +4 more
get_receiptGet signed receiptARead-onlyIdempotentInspect
Fetch a signed Tollbooth receipt by id and verify its signature.
Inputs: id (required). Returns: id, error, valid, receipt, +1 more
get_service_infoGet service infoARead-onlyIdempotentInspect
Get Tollbooth service metadata: supported chains, swap fee, x402 toll pricing.
Inputs: no named parameters. Returns: name, payment, endpoints, description
resolve_tokenResolve token symbolARead-onlyIdempotentInspect
Resolve a token ticker symbol (e.g. PEPE, WIF, USDC) to contract addresses on a chain, free. Curated majors return one verified match; others return live DEX matches ranked by liquidity so you can pick the real token over imitations. Use before get_quote when you only know the symbol.
Inputs: chain (required), symbol (required). Returns: next, chain, symbol, matches
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool targets a distinct stage of the swap workflow: metadata, token resolution, safety check, pricing, transaction building, and receipt verification. The only near-overlap (get_quote vs build_swap) is clearly separated by free indicative vs paid transaction-building.
All tools follow a consistent verb_noun snake_case pattern, with get_ prefixed for fetch operations and build_, resolve_, check_ for actions. This makes the tool set predictable and easy to navigate.
Six tools is well-scoped for a token swap service, covering every essential step from token discovery to receipt verification without excess. Each tool has a clear purpose and no redundant entries.
The tool surface fully covers the swap lifecycle: resolve_token → check_token → get_quote → build_swap → get_receipt, with get_service_info providing necessary context. There are no obvious missing operations for the stated purpose.
Maintenance
Related MCP Connectors
Crypto market intelligence, token rug-checks, and wallet verification in one MCP server.
Multi-chain wallet MCP. 18 tools: balance, swap, bridge, stake, claim. Pay-per-call USDC (x402 v2).
Token honeypot detector, 360 rug-pull audit, EVM transaction simulator & OFAC compliance MCP.
Multichain DEX router: free MCP tools for swap-quote prices, chains, catalog; paid via x402.
Related MCP Servers
- AlicenseAqualityDmaintenanceAn MCP server that detects potential honeypot tokens on Ethereum, BNB Smart Chain (BSC), and Base.13MIT
- AlicenseNot gradedqualityCmaintenanceMCP server that gives deployer reputation, insider detection, and token buy-risk verdicts for Robinhood Chain memecoins, with paid tools settling via x402.28107 npm1MIT
- AlicenseNot gradedqualityCmaintenanceMCP server for autonomous agents to rug-check tokens, monitor liquidity drains, and get market briefs, with pay-per-call via x402.2MIT
- AlicenseBqualityDmaintenanceMCP server for Autonomous Intelligence, enabling AI agents to perform non-custodial, rug-gated multi-chain token swaps including safety checks, quotes, and execution.753 npmMIT