Do I need to install anything to use Toll402?

Yes. Toll402 runs as a local process, so the package has to be installed on the machine where the client runs.

How do I install Toll402?

Install the npm package toll402-mcp and run it with npx -y toll402-mcp.

Does Toll402 need an API key?

Yes. It reads 4 environment variables from the environment, so you need to supply TOLL402_WALLET_KEY, TOLL402_URL, TOLL402_MAX_USD, TOLL402_REF before the server will start.

What is TOLL402_WALLET_KEY used for in Toll402?

0x private key of a wallet holding USDC on Base (pays per call). Omit to use the free trial.

Which transport does Toll402 use?

Stdio. Your client has to support that transport to connect.

Where is the source code for Toll402?

The publisher lists https://gitlab.com/toll402/toll402-sdk as the source repository.

Is Toll402 an official server?

It is published under the namespace dev.toll402, which means the publisher proved control of that domain when registering. That confirms who published it, not that it has been reviewed for quality or security.

Which version of Toll402 is listed here?

Version 0.3.1, taken from the latest registry entry.

Toll402 MCP server

Name: Toll402
Author: toll402

Pay-per-call tools for AI agents via x402: web, PDF, provenance, trusted lookup, business directory.

Install this server Visit publisher site View source

63/100?Number 208 of 1,259 in Files and Storage

verified publishersource repositoryupdated recentlyactive entry

How this score is calculated

Local VERIFIED Files and Storage

Details

Registry name: dev.toll402/toll402-mcp
Publisher: toll402
Version: 0.3.1
Distribution: Local. the server runs as a process on your own machine and talks to the client over stdio. You install the package first, and your data stays on your machine.
Transports: stdio
Source repository: toll402/toll402-sdk
Website: https://toll402.dev
First published: 2026-09-08
Registry updated: 2026-09-08
Credentials required: 4 environment variables
Schema generation: 2025-12-11

Packages

npm toll402-mcp

Version: 0.3.1
Transport: stdio
Runtime: npx

Environment variables
Variable	Required	Secret	Purpose
TOLL402_WALLET_KEY	Yes	Yes	0x private key of a wallet holding USDC on Base (pays per call). Omit to use the free trial.
TOLL402_URL	Yes	No	Gateway URL
TOLL402_MAX_USD	Yes	No	Max USD per single call
TOLL402_REF	Yes	No	Referrer wallet (0x) that earns a share of your calls

Install Toll402

Pick your client. The configuration below is generated from this server's published package and endpoint data.

Claude Code command line

Configuration file: .mcp.json or ~/.claude.json

Local package (npm)

claude mcp add toll402 --env TOLL402_WALLET_KEY=<toll402_wallet_key> --env TOLL402_URL=<toll402_url> --env TOLL402_MAX_USD=<toll402_max_usd> --env TOLL402_REF=<toll402_ref> -- npx -y toll402-mcp

Replace each placeholder with your own value before saving.

Check it worked: Run claude mcp list and check the server reports connected.

Official Claude Code MCP documentation

Cursor IDE

Configuration file: .cursor/mcp.json or ~/.cursor/mcp.json

Local package (npm)

{
  "mcpServers": {
    "toll402": {
      "command": "npx",
      "args": ["-y", "toll402-mcp"],
      "env": {
        "TOLL402_WALLET_KEY": "<toll402_wallet_key>",
        "TOLL402_URL": "<toll402_url>",
        "TOLL402_MAX_USD": "<toll402_max_usd>",
        "TOLL402_REF": "<toll402_ref>"
      }
    }
  }
}

Replace each placeholder with your own value before saving.

Check it worked: The server appears under Settings, then MCP with a green dot.

Official Cursor MCP documentation

Claude Desktop desktop app

Configuration file: ~/Library/Application Support/Claude/claude_desktop_config.json or %APPDATA%\Claude\claude_desktop_config.json

Local package (npm)

{
  "mcpServers": {
    "toll402": {
      "command": "npx",
      "args": ["-y", "toll402-mcp"],
      "env": {
        "TOLL402_WALLET_KEY": "<toll402_wallet_key>",
        "TOLL402_URL": "<toll402_url>",
        "TOLL402_MAX_USD": "<toll402_max_usd>",
        "TOLL402_REF": "<toll402_ref>"
      }
    }
  }
}

Replace each placeholder with your own value before saving.

Quit the app completely and reopen it.

Check it worked: Look for the tools icon in the message composer.

Official Claude Desktop MCP documentation

Visual Studio Code IDE

Configuration file: .vscode/mcp.json or user settings.json under mcp

Local package (npm)

{
  "servers": {
    "toll402": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "toll402-mcp"],
      "env": {
        "TOLL402_WALLET_KEY": "<toll402_wallet_key>",
        "TOLL402_URL": "<toll402_url>",
        "TOLL402_MAX_USD": "<toll402_max_usd>",
        "TOLL402_REF": "<toll402_ref>"
      }
    }
  }
}

Replace each placeholder with your own value before saving.

Check it worked: Open the Copilot chat tools picker and confirm the server is listed.

Official Visual Studio Code MCP documentation

Codex CLI command line

Configuration file: ~/.codex/config.toml

Local package (npm)

codex mcp add toll402 -- npx -y toll402-mcp

Replace each placeholder with your own value before saving.

Check it worked: Run codex mcp list and check the server is present.

Official Codex CLI MCP documentation

More clients (9), including automation platforms

Cline IDE

Configuration file: cline_mcp_settings.json, reachable from the MCP Servers pane

Local package (npm)

{
  "mcpServers": {
    "toll402": {
      "command": "npx",
      "args": ["-y", "toll402-mcp"],
      "env": {
        "TOLL402_WALLET_KEY": "<toll402_wallet_key>",
        "TOLL402_URL": "<toll402_url>",
        "TOLL402_MAX_USD": "<toll402_max_usd>",
        "TOLL402_REF": "<toll402_ref>"
      }
    }
  }
}

Replace each placeholder with your own value before saving.

Check it worked: The server appears in the MCP Servers pane with its tool count.

Official Cline MCP documentation

Goose desktop app

Configuration file: ~/.config/goose/config.yaml

Local package (npm)

extensions:
  toll402:
    type: stdio
    cmd: npx
    args: ["-y", "toll402-mcp"]
    enabled: true

Replace each placeholder with your own value before saving.

Check it worked: Run goose session and confirm the extension loads.

Official Goose MCP documentation

LangChain agent framework

Install the MCP adapter package and construct a client in code

Local package (npm)

client = MultiServerMCPClient({
    "toll402": {
        "command": "npx",
        "args": ["-y", "toll402-mcp"],
        "transport": "stdio",
    }
})

Replace each placeholder with your own value before saving.

Check it worked: Print the loaded tool list before running the agent.

Official LangChain MCP documentation

Windsurf IDE

Configuration file: ~/.codeium/windsurf/mcp_config.json

Local package (npm)

{
  "mcpServers": {
    "toll402": {
      "command": "npx",
      "args": ["-y", "toll402-mcp"],
      "env": {
        "TOLL402_WALLET_KEY": "<toll402_wallet_key>",
        "TOLL402_URL": "<toll402_url>",
        "TOLL402_MAX_USD": "<toll402_max_usd>",
        "TOLL402_REF": "<toll402_ref>"
      }
    }
  }
}

Replace each placeholder with your own value before saving.

Check it worked: The server appears in the Cascade plugin list.

Official Windsurf MCP documentation

Zed IDE

Configuration file: ~/.config/zed/settings.json

Local package (npm)

{
  "context_servers": {
    "toll402": {
      "command": {
        "path": "npx",
        "args": ["-y", "toll402-mcp"]
      }
    }
  }
}

Replace each placeholder with your own value before saving.

Check it worked: The agent panel lists the server under context servers.

Official Zed MCP documentation

Tools

The publisher has not disclosed a tool manifest. The tool list can only be seen by connecting to the server, which this catalogue does not do on the publisher's behalf.

Command line alternative

None found. The published package declares no executable and no matching Homebrew formula exists, so the MCP server appears to be the only route. This is a negative result from automated checks, not a statement from the publisher.

Repository signals

The repository is hosted somewhere we do not read yet, so these signals could not be determined.

Security, privacy and enterprise use

The publisher's website links no privacy policy, terms, security page or enterprise information that could be found automatically. It may still exist somewhere less obvious on their site.

Publisher

Website: toll402.dev
Profiles: none listed on the publisher's site
Community: no subreddit linked from the publisher's site

Review platforms

CAPTERRA G2 OMR TRUSTPILOT

Ratings are not shown. G2, Trustpilot and Capterra all prohibit republishing their scores without a licence, and marking up a borrowed rating as our own would breach search engine policy. These are profile links only, and a profile may not exist for every publisher.

Frequently asked questions

What does the Toll402 MCP server do?: Pay-per-call tools for AI agents via x402: web, PDF, provenance, trusted lookup, business directory.
Do I need to install anything to use Toll402?: Yes. Toll402 runs as a local process, so the package has to be installed on the machine where the client runs.
How do I install Toll402?: Install the npm package toll402-mcp and run it with npx -y toll402-mcp.
Does Toll402 need an API key?: Yes. It reads 4 environment variables from the environment, so you need to supply TOLL402_WALLET_KEY, TOLL402_URL, TOLL402_MAX_USD, TOLL402_REF before the server will start.
What is TOLL402_WALLET_KEY used for in Toll402?: 0x private key of a wallet holding USDC on Base (pays per call). Omit to use the free trial.
What is TOLL402_URL used for in Toll402?: Gateway URL.
Which transport does Toll402 use?: Stdio. Your client has to support that transport to connect.
Where is the source code for Toll402?: The publisher lists https://gitlab.com/toll402/toll402-sdk as the source repository.
Is Toll402 an official server?: It is published under the namespace dev.toll402, which means the publisher proved control of that domain when registering. That confirms who published it, not that it has been reviewed for quality or security.
Which version of Toll402 is listed here?: Version 0.3.1, taken from the latest registry entry.

Related servers
Server	Publisher	Category	Package	Version
CodeSampleX Compatibility evidence from real builds: does this library API work on your versions and runtime?	r2cuerdame	Files and Storage	mcpb	0.1.149
CADBridge MCP Server for AutoCAD VERIFIEDControl AutoCAD with AI: commands, read/edit/write drawing database, AutoLISP, scripts, PDF plots.	dmytro-prototypes	Files and Storage	npm	0.1.12
Razi Tools PDF, image, video, OCR, screenshot, SQL, QR and text tools for agents. No API key, no signup.	razikallayi	Files and Storage	npm	2.1.2
Bettermemory Memory for coding agents, checked against the filesystem and git before it is believed.	0Mattias	Files and Storage	pypi	7.6.0
MCP Unlimited agent mailboxes, create identities, read/wait for mail, extract OTPs, send email.	openagentemail	Files and Storage	npm	0.7.1
MCP Server Keyword, semantic, hybrid, and SQL retrieval for AI agents, local or on Infino Cloud.	infino-ai	Files and Storage	npm	0.14.0
mcp-v8 Run JavaScript and TypeScript in sandboxed V8 isolates with policy-controlled host capabilities.	r33drichards	Files and Storage	oci	0.21.0-rc.2
Leafwright VERIFIEDRender HTML, URLs, and templates to PDF. AI drafts templates and fixes them from logs.	leafwright	Files and Storage	npm	0.2.4

Toll402 MCP server

Details

Packages

npm toll402-mcp

Install Toll402

Claude Code command line

Cursor IDE

Claude Desktop desktop app

Visual Studio Code IDE

Codex CLI command line

ChatGPT web app

Cline IDE

Goose desktop app

LangChain agent framework

Make automation platform

n8n automation platform

Windsurf IDE

Zapier automation platform

Zed IDE

Tools

Command line alternative

Repository signals

Security, privacy and enterprise use

Publisher

Review platforms

Frequently asked questions

CodeSampleX

CADBridge MCP Server for AutoCAD

Razi Tools

Bettermemory

MCP

MCP Server

mcp-v8

Leafwright

Details

Packages

npm toll402-mcp

Install Toll402

Claude Code command line

Cursor IDE

Claude Desktop desktop app

Visual Studio Code IDE

Codex CLI command line

ChatGPT web app

Cline IDE

Goose desktop app

LangChain agent framework

Make automation platform

n8n automation platform

Windsurf IDE

Zapier automation platform

Zed IDE

Tools

Command line alternative

Repository signals

Security, privacy and enterprise use

Publisher

Review platforms

Frequently asked questions

Other servers in Files and Storage