Tollbooth X402 MCP server
io.github.SolomonisBlack/tollbooth-x402·v0.6.0Discover, quote, verify & self-check 56 x402 pay-per-call finance/tax calculators for AI agents.
0 stars40 downloads/wk
Reviews
Write oneNobody has reviewed Tollbooth X402 yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Tollbooth X402 tools (10, 1 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
tollbooth_catalogList every Tollbooth paid endpoint at x402toll.com — verified calculators for tax, crypto/DeFi, lending, real estate, retirement, and business — with x402 prices, input schemas, methods, and golden-vector evidence. Free.
tollbooth_goldenFree verifiability check: returns a tool's published golden vector — for most tools, machine-checkable {sampleInputs, expectedResult, expectedResponseHash}. POST the sampleInputs to the paid endpoint and confirm the result + hash match to verify our math without trusting us.
tollbooth_gvp_checkNeutral Golden-Vector Provenance check for ANY service's answer (not just Tollbooth's). Pass a GVP response object plus the inputs it was computed from; this recomputes the response's OWN sha256 over {endpoint, inputs, result, method, dataVintage} and reports whether it is self-consistent and GVP-1 complete (formula trace + data vintage + reproducible hash), with a "self-consistent · reproducible"
tollbooth_how_to_paywrite actionHow an agent pays a Tollbooth endpoint with x402 (v2) on Base: the 402 flow, the PAYMENT-SIGNATURE header, and client library pointers. Free.
tollbooth_previewFree coarse preview of a Tollbooth tool (rounded headline figure only; the paid endpoint returns the full verified breakdown). Previewable tools include paycheck, self-employment-tax, capital-gains-tax, mortgage-affordability, llc-cost, debt-plan, impermanent-loss.
tollbooth_quoteSee the exact price AND the response shape BEFORE you pay. Give a tool id (e.g. "paycheck", see tollbooth_catalog) or a full paid path ("/v1/paycheck") and this decodes the endpoint's HTTP 402 x402 challenge — returning the amount in USDC atomic units + USD, asset, network, payTo, timeout, the resource URL, and (when discoverable) example input + paid-response shape. Nothing is spent. Call this fi
tollbooth_recommendGiven a plain-English need (e.g. "how much tax on my bonus", "required minimum distribution"), returns the Tollbooth tools most likely to answer it, ranked, with their x402 prices and URLs. Free.
tollbooth_specThe open provenance standard Tollbooth implements and authors — the rules a verified-computation service follows so agents can trust and re-derive its answers. Free.
tollbooth_verifyConfirm or deny a claimed answer — from ANY source (another model, a spreadsheet, a competitor) — against Tollbooth's verified engine, for free. It returns ONLY whether the claim matches and which field NAMES were wrong; it NEVER reveals the correct value, so you can check a number you got elsewhere without getting the answer for free. Pass the same inputs the answer was computed from plus the cla
tollbooth_verify_hashFree provenance check: re-derives the SHA-256 response hash of a previous Tollbooth paid response from its inputs and reports whether it matches (detects tampering).
Public scan report
scanner v0.1.9 · 2026-09-25 · same rubric, same numbers if you re-run it
- Code scan2 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 74 days ago12/15
- Maintainer identityregistry namespace matches repository owner6/10
How Tollbooth X402 compares
Against every graded Finance MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 85/100
- higher than 80% of 1,761 Finance servers
- Tools
- 10
- the typical Finance server has 8
- Tools that change things
- 10%
- typical: 0%. Fewer write tools means less an agent can break
- Downloads a week
- 40
- more than 34% of 421 Finance servers with a package
What its tools let an agent do: 9 read · 1 change
Install Tollbooth X402 in Claude Code, Cursor or VS Code
Runs npx -y tollbooth-x402 on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add tollbooth-x402 -- npx -y tollbooth-x402
What the publisher says
From the Tollbooth X402 repository's README, as published. We do not edit it. Read it on GitHub
tollbooth-x402
Free MCP server for x402toll.com — a toll plaza of verified, pay-per-call calculators for AI agents. Discover the catalog, run free coarse previews, verify any paid response's provenance hash, and learn how to pay. The paid endpoints charge a few cents of USDC per call over the x402 protocol on Base — no account, no API key.
Why agents pay: the answers depend on exact 2026 data (tax brackets, contribution limits, state fees) a model can't reliably know, every answer is checked against hand-verified reference values, and each ships with a formula trace and a reproducible SHA-256 hash.
Install
npx -y tollbooth-x402Add to an MCP client (e.g. Claude Desktop / Cursor):
{
"mcpServers": {
"tollbooth": { "command": "npx", "args": ["-y", "tollbooth-x402"] }
}
}Tools (all free, no wallet)
- tollboothcatalog** — every endpoint with prices, input schemas, methods, and golden-vector evidence.
- tollboothpreview** — a free rounded preview of a tool (paycheck, self-employment tax, capital gains, mortgage affordability, LLC cost, debt plan, impermanent loss).
- tollboothverifyhash — re-derive a paid response's hash to confirm it wasn't altered.
- tollboothhowtopay** — the x402 payment flow for the paid endpoints.
Paid calls are made directly against https://x402toll.com by an x402-capable wallet/client. Set TOLLBOOTH_URL to point at a different gateway.
Categories
Tax & payroll · Crypto & DeFi · Lending · Real estate · Retirement · Business.
MIT licensed. Estimates only — not financial, legal, or tax advice.
Nothing above is checked by us. What we check is on the safety report.
Tollbooth X402: common questions
- Is Tollbooth X402 MCP server safe?
- Yes, by our scan: it is graded A (85/100). Read the Tollbooth X402 safety report
- How do I install Tollbooth X402?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Tollbooth X402 need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is Tollbooth X402 maintained?
- The last commit was 113 days ago (2026-07-13). The latest release is v0.6.0.
- What can I use instead of Tollbooth X402?
- Servers from other publishers that do the same job: Blockrun MCP server, Agent402.Tools: pay-per-call web tools MCP server and three.ws Agent Payments MCP server.
- How does Tollbooth X402 compare with other Finance MCP servers?
- safety score 85/100 (higher than 80% of 1,761 Finance servers); tools 10 (the typical Finance server has 8); tools that change things 10% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Tollbooth X402
Same job from other publishers: the closest match first, then the best rated.
- BlockrunWeb search, deep research, prediction markets & crypto data for AI agents. Pay per call via x402.not reviewedEstablishedB
- Agent402.Tools: pay-per-call web toolsAgentic Finance: 500+ agent tools, multi-chain USDC over x402 or MPP, or free via proof-of-worknot reviewedEstablishedA
- three.ws Agent PaymentsGoverned x402 payment sessions: pay any endpoint with budget, allowlist & per-tx caps, no key.not reviewedEstablishedB
- Pulsefeed X402Verify x402 payment endpoints before an AI agent pays: scam scan, on-chain checks, trust scores.not reviewedGrowingA
Norman Finance — AI Bookkeeping, Accounting & TaxesBookkeeping, invoices and tax workflows for European businesses, including Polish KPiR and JPK.not reviewedGrowingA