Skip to main content
Glama

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).

Related MCP server: RobinX

Tools

Tool

Cost

What it does

resolve_token

free

Ticker symbol → contract addresses, ranked by DEX liquidity

get_quote

free

Fee-inclusive indicative swap quote

check_token

$0.01

Honeypot / rug-pull / freeze-authority / sell-tax screening with verdict + findings

build_swap

~$0.005

Unsigned, ready-to-sign swap transaction + HMAC-signed receipt (safeMode screens both tokens first)

get_receipt

free

Verify a past build receipt by id

get_service_info

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.

License

MIT

Available Tools

6 tools
build_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 safetyA
Idempotent
Inspect

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 quoteA
Read-onlyIdempotent
Inspect

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 receiptA
Read-onlyIdempotent
Inspect

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 infoA
Read-onlyIdempotent
Inspect

Get Tollbooth service metadata: supported chains, swap fee, x402 toll pricing.

Inputs: no named parameters. Returns: name, payment, endpoints, description

resolve_tokenResolve token symbolA
Read-onlyIdempotent
Inspect

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

    A4.4/5.0

    Scored across 6 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness5/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers