x402 Doctor MCP Server

by twelvepermissions Your server? Claim it

answering

x402 Doctor is answering right now. Last checked 15 min ago. It exposes 3 tools. Last commit 17 Aug 2026.

Diagnose x402 seller endpoints: what is wrong with your 402 challenge, and how to fix it.

Uptime history 15 days of history

15 days agonow

100.0%

Uptime 24h

91 of 91 checks

Tools

read from the server

71 ms

Response time

average over 24h

Stars

last commit 17 Aug 2026

Nothing serious here today

Today is the operative word: we check x402 Doctor every 15 minutes and re-read its code on every release. Watch it and you find out the day that stops being true.

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 15 min ago.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

claude mcp add x402-doctor --transport http https://x402-doctor.tsharpe.workers.dev/mcp

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "x402-doctor": {
      "url": "https://x402-doctor.tsharpe.workers.dev/mcp"
    }
  }
}

~/.codex/config.toml

[mcp_servers.x402-doctor]
url = "https://x402-doctor.tsharpe.workers.dev/mcp"

.cursor/mcp.json

{
  "mcpServers": {
    "x402-doctor": {
      "url": "https://x402-doctor.tsharpe.workers.dev/mcp"
    }
  }
}

.vscode/mcp.json

{
  "mcpServers": {
    "x402-doctor": {
      "url": "https://x402-doctor.tsharpe.workers.dev/mcp"
    }
  }
}

Available tools 3

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

checks

list_checks

The whole rule table. Knowing what was NOT checked is part of knowing what a clean result means.

explain

explain_defect

Full explanation of one rule by id — what it checks, why it matters, how to fix it, and where the rule came from. Use when you want the reasoning without re-probing.

probe

probe_x402_endpoint

Probe an x402 seller endpoint and report what it observes about it. Performs the handshake a paying client would: GET with no X-PAYMENT header, then checks the 402 challenge against 16 rules. Every finding says whether the rule comes from the x402 spec or from an observed facilitator rejection. Reports status "healthy" (nothing to report), "advisories" (only warn/info findings — the endpoint works), "defects_found" (at least one error-severity finding), "not_x402" or "unreachable".

Endpoints

URL	Transport	State	Latency	Checked
https://x402-doctor.tsharpe.workers.dev/mcp	streamable-http	answering	166 ms	15 min ago

Alternatives to x402 Doctor

same job, measured the same way

Deadchannel

by plus8bit

Check an x402 endpoint before you pay it: verdict, risk score and what is wrong. $0.005 in USDC.

353 installs/wk local only

Agentmarketplace MCP

by stevemilton

Discover MCP servers + tools, auto-install into any client, pay for x402 endpoints in USDC.

216 installs/wk local only

X402 MCP

by carboncashmere

177 crypto market intel endpoints with auto x402 USDC micropayments from your AI agent

80 installs/wk local only

nohumans.directory

by nohumans

We buy from x402 endpoints with real USDC and publish delivery outcomes. Check before you spend.

3 tools answering

PointBagel

by pointbagel

Which card to use, what your points are worth, and whether each annual fee earns its keep.

answering

todoglow

by devglow

See what each of your coding agents is working on, and read or advance your todos.

102 installs/wk local only

Valoria

by jamesrez

Make money with x402. See what's earning, find profitable gaps, and price your service right.

24 installs/wk local only

YouTube data for agents

by fetcher-youtube

15 YouTube endpoints. Pay per call in USDC via x402.

6 tools answering

x402 Doctor — questions

Answers built from our own checks of this server.

What can x402 Doctor do?

It exposes 3 tools, read directly from the server on our last check. Among them: explain_defect, list_checks, probe_x402_endpoint. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →

Is x402 Doctor working right now?

We send a real MCP handshake every 15 minutes. Over the last 24 hours 91 of 91 checks got a reply (100.0%), average response time 71 ms. The bar chart above shows every period we have measured.

How do I connect x402 Doctor?

Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.

Does x402 Doctor need an API key?

No. x402 Doctor completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 3 of them are readable on this page. This is what we observed, not what the docs claim.

How fast is x402 Doctor?

It answers our handshake in 71 ms on average, which is faster than 96% of all working MCP servers we measure. That puts it in the quick quarter of the ecosystem. The comparison comes from our own checks across the whole registry, every 15 minutes.

Is x402 Doctor open source?

Yes — written in JavaScript and 0 stars on GitHub. The source link is on this page, so you can read exactly what it does with your data before you connect it.