
x402 Doctor
Preflight any x402, MPP or L402 paid endpoint before an agent spends money on it
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://x402-doctor.fizzl.eu/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"x402-doctor": {
"url": "https://x402-doctor.fizzl.eu/mcp"
}
}
}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

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