npm tollbooth-x402stdioupdated 1mo ago
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.
What can you do with tollbooth x402?
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-x402
Add to an MCP client (e.g. Claude Desktop / Cursor):
{
"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.
Install
Add tollbooth x402 to your client. Pick the one you use.
claude mcp add tollbooth-x402 -- npx -y tollbooth-x402codex mcp add tollbooth-x402 -- npx -y tollbooth-x402amp mcp add tollbooth-x402 -- npx -y tollbooth-x402{
"mcpServers": {
"tollbooth-x402": {
"command": "npx",
"args": [
"-y",
"tollbooth-x402"
]
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"tollbooth-x402": {
"command": "npx",
"args": [
"-y",
"tollbooth-x402"
]
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
code --add-mcp '{"name":"tollbooth-x402","command":"npx","args":["-y","tollbooth-x402"]}'Or add the block manually to `.vscode/mcp.json` under `servers`.
{
"mcpServers": {
"tollbooth-x402": {
"command": "npx",
"args": [
"-y",
"tollbooth-x402"
]
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
{
"mcpServers": {
"tollbooth-x402": {
"command": "npx",
"args": [
"-y",
"tollbooth-x402"
]
}
}
}Add to `cline_mcp_settings.json` via the MCP Servers panel.
{
"mcpServers": {
"tollbooth-x402": {
"command": "npx",
"args": [
"-y",
"tollbooth-x402"
]
}
}
}Add to `~/.gemini/settings.json`.
{
"mcpServers": {
"tollbooth-x402": {
"type": "local",
"command": "npx",
"args": [
"-y",
"tollbooth-x402"
],
"tools": [
"*"
]
}
}
}Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.
{
"context_servers": {
"tollbooth-x402": {
"command": {
"path": "npx",
"args": [
"-y",
"tollbooth-x402"
]
}
}
}
}Add to your Zed `settings.json`.
npx -y tollbooth-x402Run `goose configure`, choose **Add Extension โ Command-line Extension**, and paste this command.
Score
39 / 100
Incomplete
- Documentation22/25
- Maintenance22/25
- Trust6/20
- Capability0/15
- Install experience12/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 49 days ago
- Has a release history
- Repository is not archived
- No licence detected
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 0 tool(s) documented
- Provides prompt templates
- Provides resources
- 12 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint โ no local install
Version history
| Versions | Published |
|---|---|
| 0.6.0Latest | Jul 18, 2026 |
| 0.5.0 | Jul 16, 2026 |
| 0.3.1 | Jul 13, 2026 |