# cbp-guard

> cbp-guard is a paid MCP server for security. Scam and lookalike wallet checks before your agent pays over x402. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** CLI, API
- **Website:** https://certbeforepay.com
- **Repository:** https://github.com/teddytigers/cbp-guard
- **MCP Registry name:** io.github.teddYTIgers/certbeforepay
- **Categories:** [security](https://ai-powered.com/categories/security), [crypto security](https://ai-powered.com/categories/crypto-security), [agent payments](https://ai-powered.com/categories/agent-payments)
- **Listing updated:** 2026-11-22

## About

cbp-guard is a local stdio MCP server that screens the wallet your agent is about to pay. It asks the CertBeforePay service whether a payTo address appears on a scam or phishing list, or imitates a known address by matching its first and last characters, a trick used in address poisoning.

The server also exposes a gate for scanning skills, MCP manifests and retrieved text, and a peer challenge for accepting or rejecting another agent's signed certificate. The same package ships a pre-sign hook for the x402 v2 client, which refuses payments by default when the answer is block or caution.

Each check is paid from a wallet you supply, in USDC on Base, and a daily spend cap limits what one server process can use. It is a risk signal, not a guarantee and not a sanctions screen.

## Features

- **Wallet scam check:** Returns clear, caution or block for a payTo address based on a public scam and phishing database.
- **Lookalike detection:** Flags addresses that start and end like a known address, including addresses you pass in as known recipients.
- **Fail-closed pre-sign hook:** For the x402 v2 client, refuses to sign when the verdict is block, or caution by default, or when no answer is available.
- **Skill and MCP gate:** Scans a skill file, MCP manifest or retrieved text for injection markers, embedded secrets and missing TLS.
- **Daily budget cap:** Limits spending per UTC day for the server process; the default is 2.50 USD.
- **Peer challenge:** Lets an agent accept or reject a partner against its own minimum score and tier.

## Good for

- Block an autonomous agent from paying a known scam wallet
- Catch address-poisoning lookalikes before signing an x402 payment
- Scan a third-party skill or MCP manifest before loading it
- Verify a counterparty agent's signed certificate before trusting it

## Install

### Claude Code (Terminal)

```sh
claude mcp add certbeforepay --env CBP_GUARD_PRIVATE_KEY='<CBP_GUARD_PRIVATE_KEY>' -- npx -y cbp-guard
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "certbeforepay": {
      "command": "npx",
      "args": [
        "-y",
        "cbp-guard"
      ],
      "env": {
        "CBP_GUARD_PRIVATE_KEY": "<CBP_GUARD_PRIVATE_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "certbeforepay": {
      "command": "npx",
      "args": [
        "-y",
        "cbp-guard"
      ],
      "env": {
        "CBP_GUARD_PRIVATE_KEY": "<CBP_GUARD_PRIVATE_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "certbeforepay": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "cbp-guard"
      ],
      "env": {
        "CBP_GUARD_PRIVATE_KEY": "<CBP_GUARD_PRIVATE_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "certbeforepay": {
      "command": "npx",
      "args": [
        "-y",
        "cbp-guard"
      ],
      "env": {
        "CBP_GUARD_PRIVATE_KEY": "<CBP_GUARD_PRIVATE_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "certbeforepay": {
      "command": "npx",
      "args": [
        "-y",
        "cbp-guard"
      ],
      "env": {
        "CBP_GUARD_PRIVATE_KEY": "<CBP_GUARD_PRIVATE_KEY>"
      }
    }
  }
}
```

## Tools

- `wallet_check`: Checks a payTo wallet against a scam and phishing list and for lookalikes.
- `gate`: Scans skills, MCP manifests or text before they reach the agent.
- `peer_challenge`: Accepts or rejects a partner agent against a minimum score and tier.

## FAQ

### What does a check cost?

Each wallet check is $0.01 in USDC on Base, paid through x402.

### What does cbp-guard need to run?

A private key for a wallet that pays for the checks, set as CBP_GUARD_PRIVATE_KEY. A low-balance wallet is recommended.

### Does cbp-guard guarantee a wallet is safe?

No. It is a scam and phishing risk signal and lookalike check, not a guarantee and not an OFAC sanctions screen.

### Can I cap spending?

Yes. CBP_GUARD_DAILY_BUDGET_USD sets a per-day cap for the process, default 2.50 USD.

### How do I add cbp-guard to Claude Code?

Run this command in your terminal: claude mcp add certbeforepay --env CBP_GUARD_PRIVATE_KEY='<CBP_GUARD_PRIVATE_KEY>' -- npx -y cbp-guard

### What are the best alternatives to cbp-guard?

The closest alternatives to cbp-guard are REA, AiSOC, redamon, x64dbg-mcp-server and Agent Roast.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [AiSOC](https://ai-powered.com/mcp/aisoc): AiSOC is an open-source MCP server for ai models and llm tooling.
- [redamon](https://ai-powered.com/mcp/redamon): redamon is an open-source MCP server for ai models and llm tooling.
- [x64dbg-mcp-server](https://ai-powered.com/mcp/x64dbg-mcp-server): x64dbg-mcp-server is an open-source MCP server for ai models and llm tooling.
- [Agent Roast](https://ai-powered.com/mcp/agent-roast): Agent Roast is an open-source MCP server for developer tools.
- [Runeward](https://ai-powered.com/mcp/runeward): Runeward 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.
- [Treasure Map](https://ai-powered.com/mcp/treasure-map): Treasure Map is an open-source MCP server for security.

---
Source: https://ai-powered.com/mcp/cbp-guard
