Tollbooth Swap API

NPM · TOLLBOOTHSWAP-MCP · 2 COMPONENTS · SCANNED AUG 6

Token swaps and honeypot/rug checks for AI agents on 8 chains, paid per-call in USDC via x402.

Available components

remote · api.tollboothswap.xyz 64 npm · tollboothswap-mcp 66

66 66 Trust /100

Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →

Supply Chain Security87

No malware found by supply-chain analysis.Pass
Known CVEs were checked across the 113 of 117 dependencies we could resolve, so this covers what we could see, not the whole tree.Partial
No install/post-install scripts declared.Pass
Dependency health was assessed across the 113 of 117 dependencies we could resolve, so this covers what we could see, not the whole tree. View diagnostics → Partial

Provenance & Transparency45

Source repository is publicly reachable at the declared URL. View diagnostics → Pass
Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
Clear OSI-approved license (MIT).Pass
Actively maintained (last published 1 days ago).Pass
Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail

Schema Quality & AI Usability78

AI-judged instruction clarity (excellent).Pass
Context-footprint check failed: tool/resource definitions use about 765 tokens (~127/item across 6 items; 6 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
Usage-examples check failed: none of the tools include examples. See how to fix → Fail

Stability & Change Management0

Stability not yet verified: not enough scan history yet (needs a 30-day window).Unverified

Tool Coverage100

100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
100% of tool parameters carry a description.Pass
Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass

Capabilities100

Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Unverified: 1 category

A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · tollboothswap-mcp

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

claude mcp add xyz-tollboothswap-api-tollbooth -- npx -y tollboothswap-mcp

# add to Codex CLI

codex mcp add xyz-tollboothswap-api-tollbooth -- npx -y tollboothswap-mcp

// opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "xyz-tollboothswap-api-tollbooth": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "tollboothswap-mcp"
      ],
      "enabled": true
    }
  }
}

# add to OpenClaw

openclaw mcp add xyz-tollboothswap-api-tollbooth --command npx --arg -y --arg tollboothswap-mcp

# ~/.hermes/config.yaml

mcp_servers:
  xyz-tollboothswap-api-tollbooth:
    command: "npx"
    args: ["-y", "tollboothswap-mcp"]

// mcp.json

{
  "mcpServers": {
    "xyz-tollboothswap-api-tollbooth": {
      "command": "npx",
      "args": [
        "-y",
        "tollboothswap-mcp"
      ]
    }
  }
}

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

5 Aug 26 +22
- Known CVEs: unverified → partial ▲ security
- Malware scan: unverified → pass ▲ security
- Dependency health: unverified → partial ▲ functional
4 Aug 26 44

First indexed and scored.

Show 1 earlier entry Hide earlier entries

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 6 Aug 2026 · Analysed npm/[email protected]

Provenance No attestation

The registry publishes no build provenance for this version, so there is nothing to verify.

Result	No attestation
Ecosystem	npm

Dependencies 113 packages

Packages resolved	113
Deprecated	112
Stale	29
Tree resolution	Partial

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools · 6 exposed · ~616 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens

build_swap Build swap transaction ~202

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.

Input Output Examples

Name	Type	Req	Description
amount	string	yes	Sell amount as an integer string in the input token's base units
chain	string	yes	Chain to swap on
inputToken	string	yes	Token being sold: mint address (solana) or ERC-20 address (EVM chains)
outputToken	string	yes	Token being bought: mint address (solana) or ERC-20 address (EVM chains)
safeMode	boolean	–	Screen both tokens first; refuses the build if either is critical-risk (honeypot etc.)
slippageBps	integer	–	Max slippage in bps (default 100)
taker	string	yes	Wallet address that will sign and send the swap

Name	Type	Req	Description
accepts	array	–	x402 payment options when unpaid
chain	string	–	–
error	string	–	Present when the request failed or payment is required
next	object	–	Suggested follow-up calls
quote	object	–	Quote the transaction was built from
receipt	object	–	Signed receipt for this build
safety	object	–	Safety reports when safeMode was requested
transaction	object	–	Unsigned transaction for the taker to sign

No examples provided.

check_token Check token safety ~103

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.

Input Output Examples

Name	Type	Req	Description
chain	string	yes	Chain to swap on
token	string	yes	Token to screen: mint address (solana) or ERC-20 address (EVM chains)

Name	Type	Req	Description
accepts	array	–	x402 payment options when unpaid
chain	string	–	–
error	string	–	Present when the request failed or payment is required
findings	array	–	Individual risk findings
next	object	–	Suggested follow-up calls
riskScore	number	–	0 (safe) to 100 (critical)
source	string	–	Data source used for the screen
token	string	–	–
verdict	string	–	ok, warn, critical, or unknown

No examples provided.

get_quote Get swap quote ~139

Get a free indicative swap quote (output amount includes Tollbooth's fee). Use before build_swap to decide whether to trade.

Input Output Examples

Name	Type	Req	Description
amount	string	yes	Sell amount as an integer string in the input token's base units
chain	string	yes	Chain to swap on
inputToken	string	yes	Token being sold: mint address (solana) or ERC-20 address (EVM chains)
outputToken	string	yes	Token being bought: mint address (solana) or ERC-20 address (EVM chains)
slippageBps	integer	–	Max slippage in bps (default 100)

Name	Type	Req	Description
chain	string	–	–
feeBps	number	–	Tollbooth fee in basis points
inputAmount	string	–	Sell amount in base units
inputToken	string	–	–
next	object	–	How to build the swap transaction
outputAmount	string	–	Estimated buy amount in base units, after fees
outputToken	string	–	–
slippageBps	number	–	–

No examples provided.

get_receipt Get signed receipt ~36

Fetch a signed Tollbooth receipt by id and verify its signature.

Input Output Examples

Name	Type	Req	Description
id	string	yes	Receipt id returned by build_swap

Name	Type	Req	Description
error	string	–	Present when the receipt was not found
id	string	–	Receipt id
receipt	object	–	Receipt payload
signature	string	–	Server signature over the receipt
valid	boolean	–	Whether the signature verified

No examples provided.

get_service_info Get service info ~27

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

Input Output Examples

Input schema present but exposes no named parameters.

Name	Type	Req	Description
description	string	–	What the service does
endpoints	object	–	HTTP endpoints exposed by the service
name	string	–	Service name
payment	object	–	x402 payment networks and pricing

No examples provided.

resolve_token Resolve token symbol ~109

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.

Input Output Examples

Name	Type	Req	Description
chain	string	yes	Chain to swap on
symbol	string	yes	Ticker symbol to resolve, e.g. USDC, PEPE, WIF

Name	Type	Req	Description
chain	string	–	Chain searched
matches	array	–	Matching tokens, best first
next	object	–	Suggested follow-up calls
symbol	string	–	Symbol searched

No examples provided.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

4 Aug 6 Aug