npm tollboothswap-mcpstreamable-httpMITupdated 1mo ago
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.
What can you do with Tollbooth Swap API?
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
| 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.
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
Install
Add Tollbooth Swap API to your client. Pick the one you use.
{
"servers": {
"tollboothswap-mcp": {
"type": "http",
"url": "https://api.tollboothswap.xyz/mcp"
}
}
}Add to `.vscode/mcp.json` in your workspace.
claude mcp add tollboothswap-mcp -- npx -y tollboothswap-mcpcodex mcp add tollboothswap-mcp -- npx -y tollboothswap-mcpamp mcp add tollboothswap-mcp -- npx -y tollboothswap-mcp{
"mcpServers": {
"tollboothswap-mcp": {
"command": "npx",
"args": [
"-y",
"tollboothswap-mcp"
]
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"tollboothswap-mcp": {
"command": "npx",
"args": [
"-y",
"tollboothswap-mcp"
]
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
{
"mcpServers": {
"tollboothswap-mcp": {
"command": "npx",
"args": [
"-y",
"tollboothswap-mcp"
]
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
{
"mcpServers": {
"tollboothswap-mcp": {
"command": "npx",
"args": [
"-y",
"tollboothswap-mcp"
]
}
}
}Add to `cline_mcp_settings.json` via the MCP Servers panel.
{
"mcpServers": {
"tollboothswap-mcp": {
"command": "npx",
"args": [
"-y",
"tollboothswap-mcp"
]
}
}
}Add to `~/.gemini/settings.json`.
{
"mcpServers": {
"tollboothswap-mcp": {
"type": "local",
"command": "npx",
"args": [
"-y",
"tollboothswap-mcp"
],
"tools": [
"*"
]
}
}
}Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.
{
"context_servers": {
"tollboothswap-mcp": {
"command": {
"path": "npx",
"args": [
"-y",
"tollboothswap-mcp"
]
}
}
}
}Add to your Zed `settings.json`.
npx -y tollboothswap-mcpRun `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.
6 tools
Tollbooth Swap API exposes 6 tools to a connected agent.
- resolve_token
- free
- get_quote
- free
- check_token
- $0.01
- build_swap
- ~$0.005
- get_receipt
- free
- get_service_info
- free
Score
81 / 100
Excellent
- Documentation22/25
- Maintenance25/25
- Trust13/20
- Capability6/15
- Install experience15/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 27 days ago
- Has a release history
- Repository is not archived
- Licensed MIT
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 6 tool(s) documented
- Provides prompt templates
- Provides resources
- 18 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint — no local install
Version history
| Versions | Published |
|---|---|
| 1.0.3Latest | Aug 4, 2026 |
| 1.0.2 | Aug 4, 2026 |
| 1.0.1 | Aug 4, 2026 |