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.

VerifiedSTDIODesktop onlyFinanceBusiness & Commerce

Overview

AI-generated 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.
Before you install
Paid endpoints spend real USDC per call through an external wallet or client, so costs accrue outside this server. Answers are estimates only, not financial, legal or tax advice. Requests go to the third-party x402toll.com gateway, which can be redirected with TOLLBOOTH_URL.

Installation

In SourceWeft

  1. Open Tollbooth X402 in the dashboard and add it to a workspace.
  2. 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

bash
npx -y tollbooth-x402

Add to an MCP client (e.g. Claude Desktop / Cursor):

json
{  "mcpServers": {    "tollbooth": { "command": "npx", "args": ["-y", "tollbooth-x402"] }  }}

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

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

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