Skip to content
MCP server

probe402-check

Check an x402 payment endpoint against probe402's public record before paying

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.2.1
Listing updated
1 day ago

About probe402-check

probe402-check is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

Built for agents that pay for APIs over the x402 protocol, this package looks up what an independent observatory has recorded about a route before any money moves. Given the URL the agent is about to pay, check_before_paying reads that route's free grade and reports whether it was quoting at the newest reading, what it quoted, whether probe402 has paid it and how the result was graded, and how old the reading is. If you pass the payment request you hold, it compares that against the recorded one.

The repository holds three pieces under Apache-2.0: the MCP server and CLI, a fetch wrapper that checks every 402 response against a policy you write before the payment is signed, and verify-head, which recomputes a sealed day's archive head and prints whether it links. It never touches a signer, key or wallet and uses no account.

The tool reports facts and leaves the decision to the agent's policy. probe402 itself says its collector only performs the unpaid quote handshake and cannot pay.

Install

Run in a terminal

claude mcp add probe402-check -- npx -y probe402-check

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

{
  "servers": {
    "probe402-check": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "probe402-check"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "probe402-check": {
      "command": "npx",
      "args": [
        "-y",
        "probe402-check"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "probe402-check": {
      "command": "npx",
      "args": [
        "-y",
        "probe402-check"
      ]
    }
  }
}

Tools this server provides (1)

Taken from the project documentation; the running server may differ.

check_before_paying
Check a route's recorded grade before an agent pays it

What it does

Pre-payment check
Looks up a route's recorded grade from the URL the agent is about to pay.
Quote comparison
Compares the payment request you hold with the one probe402 recorded.
x402 fetch hook
wrapFetchWithCheck checks each 402 against your policy before the payment is signed.
Archive verification
verify-head recomputes a sealed day's head and prints LINKS or DOES NOT LINK.
No keys or accounts
Reads public probe402 surfaces and never touches a signer or wallet.

Good for

  • Block an agent from paying an endpoint with a poor recorded history
  • Verify a route's quote still matches what was observed
  • Add a policy gate under an x402 payment client
  • Audit probe402's published archive from your own terminal

Pricing

Open source

Apache-2.0, free to use

Prices change. Check probe402.com before you buy.

probe402-check FAQ

How do I run it?

Add npx -y probe402-check --mcp as a stdio server in Claude Desktop, or use claude mcp add for Claude Code.

Does it need an API key?

No. The README says there is no key, account or payment anywhere in it.

Which licence is it under?

Apache-2.0.

Does it make the pay or don't-pay decision?

No. It reports facts and the agent's own policy decides.

Is probe402-check free?

Yes. probe402-check is open source, so you can use and self-host it for free.

How do I add probe402-check to Claude Code?

Run this command in your terminal: claude mcp add probe402-check -- npx -y probe402-check

What are the best alternatives to probe402-check?

The closest alternatives to probe402-check are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to probe402-check

  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. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools