
Tollbooth X402
io.github.SolomonisBlackPublished by GitHub account SolomonisBlackv0.6.0Updated Oct 24, 2026
Discover, quote, verify & self-check 56 x402 pay-per-call finance/tax calculators for AI agents.
Overview
A free local MCP server that lets an assistant browse and preview 56 pay-per-call x402 finance and tax calculators, verify paid answers, and learn the payment.
- What you can do
- Browse the calculator catalog with prices, input schemas, methods and golden-vector evidence, and get the x402 payment flow for paid endpoints. Run free rounded previews of calculators such as paycheck, self-employment tax, capital gains, mortgage affordability, LLC cost, debt plan and impermanent loss. Re-derive a paid response's hash to confirm it was not altered. Paid calls themselves are made directly against the x402toll.com gateway by an x402-capable wallet or client, not by this server.
- When to use it
- Useful when an assistant needs 2026-dependent finance or tax figures (brackets, contribution limits, state fees) that a model cannot reliably know, and you want to inspect the catalog and free previews before deciding whether to pay for exact answers.
- Requirements
- Runs locally via npx, so Node.js is needed. No account, API key or wallet is required for the free tools. Paid endpoints need an x402-capable wallet or client paying a few cents of USDC per call on Base. The optional TOLLBOOTH_URL variable points at a different gateway.
Installation
In SourceWeft
- Open Tollbooth X402 in the dashboard and add it to a workspace.
- Enable the server for the chats that should use its tools.
Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.
Other MCP clients
Follow the launch instructions in the repository.
README
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
Add to an MCP client (e.g. Claude Desktop / Cursor):
Tools (all free, no wallet)
tollbooth_catalog— every endpoint with prices, input schemas, methods, and golden-vector evidence.tollbooth_preview— a free rounded preview of a tool (paycheck, self-employment tax, capital gains, mortgage affordability, LLC cost, debt plan, impermanent loss).tollbooth_verify_hash— re-derive a paid response's hash to confirm it wasn't altered.tollbooth_how_to_pay— 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.
Source: README.md at commit 149966e
Tools
0Version history
1- v0.6.0LatestSep 16, 2026
Score
40% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
- Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
- Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
- Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
- DescriptionRequired15 pts
- Logo10 pts
- Documentation15 pts
- License10 pts
Declare a license in the repository or the registry entry.