TollWarden
Payment firewall that screens x402 agent payments and returns allow, flag or block
- Pricing
- Freemium
- Platforms
- API, CLI
- Runs
- Locally
- Version
- 1.6.0
- Listing updated
- 1 day ago
About TollWarden
TollWarden is a freemium MCP server for security. It runs locally on your machine and is started by your AI client.
TollWarden sits between an AI agent and settlement on x402, the protocol that uses HTTP 402 for stablecoin micropayments. The agent submits a payment and gets a verdict with per-check reasons and an Ed25519 attestation bound to that exact payment. It is advisory and non-custodial; it never touches keys, wallets or funds.
Its strongest check blocks a payment whose payee address appeared in content the agent just read, such as a poisoned web page, and it handles obfuscation like encoding, invisible Unicode and homoglyphs. Other checks cover replayed authorizations, amounts far above the quoted price, secrets in payment metadata, lookalike USDC contracts and vanity addresses, sellers with a poor delivery history, and rate or hourly spend caps. The site reports 997 payments screened and 74 blocked, and a measured 0.6 ms per scan on a dev server.
Clients ship for TypeScript and Python, with integrations for LangChain, CrewAI, NeMo Agent Toolkit, Coinbase AgentKit and the Vercel AI SDK, each with scan, reputation and report tools. An enforcement kit wraps a viem or ethers signer so it refuses to sign without a fresh allow verdict. A free key is minted automatically with 100 free scans.
Install
Run in a terminal
claude mcp add tollwarden -- npx -y tollwardenAdd to claude_desktop_config.json
{
"mcpServers": {
"tollwarden": {
"command": "npx",
"args": [
"-y",
"tollwarden"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"tollwarden": {
"command": "npx",
"args": [
"-y",
"tollwarden"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"tollwarden": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"tollwarden"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"tollwarden": {
"command": "npx",
"args": [
"-y",
"tollwarden"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"tollwarden": {
"command": "npx",
"args": [
"-y",
"tollwarden"
]
}
}
}What it does
- Injection-triggered payment detection
- Blocks payments to addresses that came from content the agent just read.
- Replay and overpayment checks
- Catches reused nonces and amounts well above the quoted price.
- Lookalike detection
- Flags non-canonical USDC contracts and addresses matching a counterparty's first and last characters.
- Seller reputation
- Uses a shared registry and measured delivery history to flag non-delivering sellers.
- Signed verdicts
- Ed25519 attestations bound to a hash of the exact payment, with a short expiry.
- Spend caps
- Rate and hourly limits stop a compromised agent from draining a wallet.
- Signer enforcement
- guardSigner makes a wallet refuse to sign without a fresh allow verdict.
Good for
- Screen an agent's x402 payments before they settle
- Stop a prompt-injected page from redirecting funds
- Add scan-before-pay to a LangChain or CrewAI agent
- Check a seller's reputation before paying
- Make a wallet signer require a signed allow verdict
Pricing
Freemium
100 free scans; paid plans available
Prices change. Check tollwarden.com before you buy.
TollWarden FAQ
Does it hold my funds or keys?
No. The site says it is advisory and non-custodial.
How many free scans do I get?
The README says a free API key is auto-minted with 100 free scans.
Which frameworks are supported?
LangChain, CrewAI, NeMo Agent Toolkit, Coinbase AgentKit and the Vercel AI SDK.
How fast is a scan?
The site reports about 0.6 ms per scan in an offline test, with deployed latency dominated by network round trips.
Is TollWarden free?
TollWarden has a free plan, with paid plans for more usage or features.
How do I add TollWarden to Claude Code?
Run this command in your terminal: claude mcp add tollwarden -- npx -y tollwarden
What are the best alternatives to TollWarden?
The closest alternatives to TollWarden are REA, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Agent Roast and Midplane.
Alternatives to TollWarden

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Solana MCP by Vybe
MCP serverRemote MCP server exposing the Vybe Solana API to AI clients and code editors
- 44 tools
- Remote
- 2.8K GitHub stars
- Finance and payments

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments
Agent Roast
MCP serverOffline review that flags agent changes which weaken tests, assertions or CI
Runs locally- Open source
- 4 Hacker News points
- Developer tools

Midplane
MCP serverPostgres gateway for AI agents with table grants, column masking and approval for writes
Runs locally- Open source
- 5 GitHub stars
- Databases
Budget Tracker
MCP serverLocal MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling
- 14 tools
- Remote
- Freemium
- 2 GitHub stars
- Finance and payments