# probe402-check

> probe402-check is an open-source MCP server for finance and payments. Check an x402 payment endpoint against probe402's public record before paying. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://probe402.com/method
- **Repository:** https://github.com/probe402/probe402-check
- **MCP Registry name:** io.github.probe402/probe402-check
- **Categories:** finance and payments, developer tools
- **Listing updated:** 2026-11-16

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## Tools

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

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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/probe402-check
