Skip to content
MCP server

TollWarden

Payment firewall that screens x402 agent payments and returns allow, flag or block

Runs locallyStatus and history
Install
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 tollwarden

Add to claude_desktop_config.json

{
  "mcpServers": {
    "tollwarden": {
      "command": "npx",
      "args": [
        "-y",
        "tollwarden"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "tollwarden": {
      "command": "npx",
      "args": [
        "-y",
        "tollwarden"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  3. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  4. Agent Roast

    MCP server

    Offline review that flags agent changes which weaken tests, assertions or CI

    Runs locally
    • Open source
    • 4 Hacker News points
    • Developer tools
  5. Midplane

    MCP server

    Postgres gateway for AI agents with table grants, column masking and approval for writes

    Runs locally
    • Open source
    • 5 GitHub stars
    • Databases
  6. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments