x402 Oracle
Paid MCP consults on x402 payment errors, MCP manifests and Bazaar listings
- Pricing
- Paid
- Platforms
- API
- Runs
- Remotely
- Version
- 0.1.0
- Listing updated
- 2 days ago
About x402 Oracle
x402 Oracle is a paid MCP server for finance and payments. It runs as a hosted remote server, so there is nothing to install locally.
This server sells short expert-style answers about the x402 payment protocol and the agent ecosystem around it. An unpaid call returns HTTP 402 with a payment envelope; you pay in USDC on Base and retry with a PAYMENT-SIGNATURE header. The operator says it never asks for private keys and that the public host is seller-only.
Two tools are free: oracle_health and oracle_pricing. Paid tools are priced per call: oracle_ask at $0.10, oracle_diagnose_402 at $0.50, oracle_bazaar_rewrite at $1.50, oracle_review_mcp at $3 and complete_oracle_task at $10, with prices clamped to a $25 maximum. Paid replies come as a structured envelope with a verdict, wisdom, an implementation prompt, risk, citations and a receipt.
Discovery files include a catalog at /.well-known/x402, an A2A agent card, llms.txt and an OpenAPI description. The README warns not to put a spend key on the server, and describes Bazaar cataloguing as triggered by settlement.
Install
Run in a terminal
claude mcp add --transport http x402orcle https://x402orcle.vercel.app/mcpAdd to Settings → Connectors → Add custom connector
https://x402orcle.vercel.app/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"x402orcle": {
"url": "https://x402orcle.vercel.app/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"x402orcle": {
"type": "http",
"url": "https://x402orcle.vercel.app/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"x402orcle": {
"serverUrl": "https://x402orcle.vercel.app/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"x402orcle": {
"type": "http",
"url": "https://x402orcle.vercel.app/mcp"
}
}
}Tools this server provides (7)
Taken from the project documentation; the running server may differ.
- oracle_health
- Free health check.
- oracle_pricing
- Free price list.
- oracle_ask
- Paid question, $0.10.
- oracle_diagnose_402
- Paid 402 error diagnosis, $0.50.
- oracle_review_mcp
- Paid MCP manifest review, $3.
- oracle_bazaar_rewrite
- Paid Bazaar listing rewrite, $1.50.
- complete_oracle_task
- Paid task completion, $10.
What it does
- Pay-per-call consults
- Each paid tool charges a listed USDC price.
- 402 diagnosis
- Debugs why a 402 flow or listing is failing.
- MCP manifest review
- Reviews a server's MCP manifest.
- Bazaar listing rewrite
- Rewrites listings for x402 Bazaar.
- Structured replies
- Returns verdict, implementation prompt, risk and citations.
- Discovery endpoints
- Publishes catalog, agent card, llms.txt and OpenAPI.
Good for
- Debug an x402 endpoint returning 402
- Get a review of an MCP manifest before publishing
- Rewrite a Bazaar listing that is unranked
- Check pricing before paying for a consult
Pricing
Paid
Per call in USDC on Base: $0.10 to $10; two free tools
Prices change. Check x402orcle.vercel.app before you buy.
x402 Oracle FAQ
How much do the tools cost?
From $0.10 for oracle_ask up to $10 for complete_oracle_task; health and pricing are free.
Which network and currency?
USDC on Base (eip155:8453).
Does it ask for my private key?
The operator says it never does.
Is it a token sale?
The README says payments are for delivered consults or a voluntary tip, not a token or equity.
Is x402 Oracle free?
No. x402 Oracle is a paid product.
How do I add x402 Oracle to Claude Code?
Run this command in your terminal: claude mcp add --transport http x402orcle https://x402orcle.vercel.app/mcp
What are the best alternatives to x402 Oracle?
The closest alternatives to x402 Oracle are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to x402 Oracle

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

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools