ProvenPaid
Check an x402 endpoint and its on-chain payer history before your agent pays it
- Pricing
- Freemium
- Platforms
- CLI, API
- Runs
- Locally
- Version
- 0.2.0
- Listing updated
- 2 days ago
About ProvenPaid
ProvenPaid is a freemium MCP server for finance and payments. It runs locally on your machine and is started by your AI client.
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.
Install
Run in a terminal
claude mcp add mcp --env PROVENPAID_WALLET_PRIVATE_KEY='<PROVENPAID_WALLET_PRIVATE_KEY>' -- uvx provenpaid-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "uvx",
"args": [
"provenpaid-mcp"
],
"env": {
"PROVENPAID_WALLET_PRIVATE_KEY": "<PROVENPAID_WALLET_PRIVATE_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "uvx",
"args": [
"provenpaid-mcp"
],
"env": {
"PROVENPAID_WALLET_PRIVATE_KEY": "<PROVENPAID_WALLET_PRIVATE_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"provenpaid-mcp"
],
"env": {
"PROVENPAID_WALLET_PRIVATE_KEY": "<PROVENPAID_WALLET_PRIVATE_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp": {
"command": "uvx",
"args": [
"provenpaid-mcp"
],
"env": {
"PROVENPAID_WALLET_PRIVATE_KEY": "<PROVENPAID_WALLET_PRIVATE_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcp": {
"command": "uvx",
"args": [
"provenpaid-mcp"
],
"env": {
"PROVENPAID_WALLET_PRIVATE_KEY": "<PROVENPAID_WALLET_PRIVATE_KEY>"
}
}
}
}Configuration
PROVENPAID_WALLET_PRIVATE_KEYOptional. Private key of a dedicated low-balance wallet holding USDC on Base, used only to sign payments after the 10 free checks. Not needed to try it.PROVENPAID_DAILY_LIMITMaximum paid checks per UTC day (default 20).PROVENPAID_MAX_PRICE_USDRefuse checks priced above this (default 0.01, hard ceiling 0.10).
Tools this server provides (3)
Taken from the project documentation; the running server may differ.
- 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.
What it does
- 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
Pricing
Freemium
10 free checks, then about $0.01 USDC per check on Base
Prices change. Check api.provenpaid.com before you buy.
ProvenPaid 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 to ProvenPaid

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Solana MCP by Vybe
MCP serverRemote MCP server exposing the Vybe Solana API to AI clients and code editors
- 44 tools
- Remote
- 2.8K GitHub stars
- Finance and payments

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments
Agent Roast
MCP serverOffline review that flags agent changes which weaken tests, assertions or CI
Runs locally- Open source
- 4 Hacker News points
- Developer tools

Midplane
MCP serverPostgres gateway for AI agents with table grants, column masking and approval for writes
Runs locally- Open source
- 5 GitHub stars
- Databases
Budget Tracker
MCP serverLocal MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling
- 14 tools
- Remote
- Freemium
- 2 GitHub stars
- Finance and payments