Skip to content
MCP server

x402 Doctor

Preflight any x402, MPP or L402 paid endpoint before an agent spends money on it

Install
Pricing
Freemium
Platforms
Web, API, CLI
Runs
Remotely
Version
1.0.3
Listing updated
2 days ago

About x402 Doctor

x402 Doctor is a freemium MCP server for developer tools. It runs as a hosted remote server, so there is nothing to install locally.

Built for the new world of agents paying for APIs. You give it the URL of a paid endpoint and it reads the payment challenge the way a paying agent would, with no wallet or payment, then reports which part of the flow is broken. Verdicts are go, caution or no_go, plus the payment option to use; a seller whose payout address appears on the OFAC sanctions list is a no_go. It covers x402 over HTTP and MCP, Stripe and Tempo's MPP, and Lightning L402.

The free quick check sits beside paid extras. A preflight costs $0.001, the code fix for your stack is $0.05, and a delivery check at $0.25 actually buys the endpoint once, for at most $0.10, and publishes whether it paid and delivered with the charge measured on chain. Prepaid credits are offered at a discount. Payment is in USDC on Base or other listed chains.

It also checks MCP servers for tool descriptions that hide instructions to the agent, and offers a Concordium badge check on whether the seller is a registered agent. An hourly watch can alert you by phone, Telegram, Discord or Slack when an endpoint stops being payable.

Install

Run in a terminal

claude mcp add --transport http x402-doctor https://x402-doctor.fizzl.eu/mcp

Add to Settings → Connectors → Add custom connector

https://x402-doctor.fizzl.eu/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "x402-doctor": {
      "url": "https://x402-doctor.fizzl.eu/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "x402-doctor": {
      "type": "http",
      "url": "https://x402-doctor.fizzl.eu/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "x402-doctor": {
      "serverUrl": "https://x402-doctor.fizzl.eu/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "x402-doctor": {
      "type": "http",
      "url": "https://x402-doctor.fizzl.eu/mcp"
    }
  }
}

Tools this server provides (1)

Taken from the project documentation; the running server may differ.

concordium_badge_check
Check whether the seller is a registered agent in Concordium's Agent Registry.

What it does

Read-only diagnosis
Reads the payment challenge without a wallet or payment.
Go or no-go verdict
Returns go, caution or no_go with the payment option and reason.
OFAC check
Flags sellers whose payout address is on the sanctions list.
Delivery check
Buys the endpoint once and verifies what was delivered.
Tool-poisoning scan
Looks for hidden instructions in MCP tool descriptions.
Endpoint watch
Notifies you when an endpoint stops being payable.
Prepaid credits
Discounted credits valid for a year.

Good for

  • Check an x402 endpoint before an agent pays it
  • Debug why your own paid API's payment flow fails
  • Batch-compare several paid services
  • Verify that a paid endpoint delivers what it declares

Pricing

Freemium

Free quick check; preflight $0.001, fix $0.05, delivery check $0.25 in USDC

Prices change. Check x402-doctor.fizzl.eu before you buy.

x402 Doctor FAQ

Does the free check need a wallet?

No. The site says the read-only diagnostics need no wallet, no payment and carry no risk.

What does a preflight cost?

$0.001, or 1 credit; a deeper diagnosis is 10 credits.

What does the delivery check do?

It buys the endpoint once for at most $0.10, checks the answer against its declared schema and measures the charge on chain, for $0.25.

Which protocols does it cover?

x402 over HTTP or MCP, MPP from Stripe and Tempo, and L402 over Lightning.

Is x402 Doctor free?

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

How do I add x402 Doctor to Claude Code?

Run this command in your terminal: claude mcp add --transport http x402-doctor https://x402-doctor.fizzl.eu/mcp

What are the best alternatives to x402 Doctor?

The closest alternatives to x402 Doctor are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to x402 Doctor

  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