# TollWarden

> TollWarden is a freemium MCP server for security. Payment firewall that screens x402 agent payments and returns allow, flag or block. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI
- **Website:** https://tollwarden.com
- **Repository:** https://github.com/tollwarden/tollwarden
- **MCP Registry name:** com.tollwarden/tollwarden
- **Categories:** security, finance and payments
- **Listing updated:** 2026-11-16

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add tollwarden -- npx -y tollwarden
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "tollwarden": {
      "command": "npx",
      "args": [
        "-y",
        "tollwarden"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "tollwarden": {
      "command": "npx",
      "args": [
        "-y",
        "tollwarden"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "tollwarden": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "tollwarden"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "tollwarden": {
      "command": "npx",
      "args": [
        "-y",
        "tollwarden"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "tollwarden": {
      "command": "npx",
      "args": [
        "-y",
        "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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Agent Roast](https://ai-powered.com/mcp/agent-roast): Agent Roast is an open-source MCP server for developer tools.
- [Midplane](https://ai-powered.com/mcp/midplane): Midplane is an open-source MCP server for databases.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Leash](https://ai-powered.com/mcp/leash): Leash is a free MCP server for security.
- [Tinplate Edge AI Safety, Security & EU Compliance](https://ai-powered.com/mcp/tinplate-edge-ai-safety-security-and-eu-compliance): Tinplate Edge AI Safety, Security & EU Compliance is a freemium MCP server for security.

---
Source: https://ai-powered.com/mcp/tollwarden
