# ProvenPaid

> ProvenPaid is a freemium MCP server for finance and payments. Check an x402 endpoint and its on-chain payer history before your agent pays it. It runs locally on your machine and is started by your AI client.

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

## About

A valid x402 paywall proves an endpoint can take payment, not that anyone does. ProvenPaid looks at public Base data for the endpoint's receiving address over 30 days: how many distinct wallets paid, how many came back, and how concentrated the payments are. It also probes the endpoint once, unpaid, to see whether the challenge is valid and which network, price and address it advertises.

The server is meant for a single check before relying on an unfamiliar endpoint. The first 10 checks are free using a local identity key that holds no funds; after that it pays about $0.01 in USDC on Base per check from a wallet you supply. Guardrails run before signing: a price cap (default $0.01, hard ceiling $0.10), a daily limit of 20 paid checks and a fixed network. The README advises a dedicated low-balance wallet.

Results are evidence, not a verdict. Figures describe the receiving address rather than one URL, endpoint ownership of the address is not verified, and payments through other schemes may not appear. Invalid, non-x402 or unsupported-network URLs are not charged.

## Features

- **Payer depth:** Distinct payers, repeat-payer share and top-payer share over the last 30 days.
- **Challenge probe:** Checks whether the x402 challenge is valid and what network and price it advertises.
- **Free checks:** The first 10 checks cost nothing and need no funded wallet.
- **Spending guardrails:** Price cap, daily limit and network lock are enforced before anything is signed.
- **Uncharged failures:** Invalid, unsafe, non-x402 or unsupported URLs are not billed.
- **Stated limits:** The service reports evidence and methodology and does not label sellers.

## Good for

- Vet an x402 endpoint found in a directory before paying it
- Add a pre-payment check to an agent wallet workflow
- Spot endpoints whose revenue comes from a few wallets
- Confirm a paywall's network, price and receiving address

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp --env PROVENPAID_WALLET_PRIVATE_KEY='<PROVENPAID_WALLET_PRIVATE_KEY>' -- uvx provenpaid-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "uvx",
      "args": [
        "provenpaid-mcp"
      ],
      "env": {
        "PROVENPAID_WALLET_PRIVATE_KEY": "<PROVENPAID_WALLET_PRIVATE_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "command": "uvx",
      "args": [
        "provenpaid-mcp"
      ],
      "env": {
        "PROVENPAID_WALLET_PRIVATE_KEY": "<PROVENPAID_WALLET_PRIVATE_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "provenpaid-mcp"
      ],
      "env": {
        "PROVENPAID_WALLET_PRIVATE_KEY": "<PROVENPAID_WALLET_PRIVATE_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "command": "uvx",
      "args": [
        "provenpaid-mcp"
      ],
      "env": {
        "PROVENPAID_WALLET_PRIVATE_KEY": "<PROVENPAID_WALLET_PRIVATE_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "command": "uvx",
      "args": [
        "provenpaid-mcp"
      ],
      "env": {
        "PROVENPAID_WALLET_PRIVATE_KEY": "<PROVENPAID_WALLET_PRIVATE_KEY>"
      }
    }
  }
}
```

## Tools

- `check_x402_endpoint`: Validate an endpoint's x402 challenge and report on-chain payer evidence for its receiving address.
- `provenpaid_methodology`: Explain how signals are computed and when a check is charged.
- `provenpaid_status`: Show free checks left, wallet address, network, price cap and paid checks left today.

## FAQ

### What does a check cost?

The first 10 are free; after that about $0.01 in USDC on Base.

### Do I need a wallet?

Not to try it. Paid checks need a dedicated wallet key set in PROVENPAID_WALLET_PRIVATE_KEY.

### What are the tools?

check_x402_endpoint, provenpaid_methodology and provenpaid_status.

### What does it require?

Python 3.11 or newer; install with uvx provenpaid-mcp or pip.

### Does it say whether a seller is trustworthy?

No. It reports evidence and does not verify service quality.

### Is ProvenPaid free?

ProvenPaid has a free plan, with paid plans for more usage or features.

### How do I add ProvenPaid to Claude Code?

Run this command in your terminal: claude mcp add mcp --env PROVENPAID_WALLET_PRIVATE_KEY='<PROVENPAID_WALLET_PRIVATE_KEY>' -- uvx provenpaid-mcp

### What are the best alternatives to ProvenPaid?

The closest alternatives to ProvenPaid 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/provenpaid
