Skip to content
MCP server

x402 Oracle

Paid MCP consults on x402 payment errors, MCP manifests and Bazaar listings

Install
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/mcp

Add to Settings → Connectors → Add custom connector

https://x402orcle.vercel.app/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "x402orcle": {
      "url": "https://x402orcle.vercel.app/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  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