x402 Doctor
Check x402 endpoints like a paying agent: diagnose, fix plans, pre-payment checks. Free quick check.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"x402-doctor": {
"url": "https://x402-doctor.onrender.com/mcp"
}
}
}Remote endpoints
https://x402-doctor.onrender.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (4)
🟢x402_quick_check(url, method)
Free: does this x402 endpoint work for a paying agent? Returns pass, warn or fail with the number of problems and the top three. Limited to 10 calls per hour. For every check use x402_diagnose ($0.01); for code changes x402_fix ($0.05); before paying someone else's endpoint x402_preflight ($0.001).
Input Schema
{
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "The x402 endpoint (public http(s) URL), e.g. https://api.example.com/paid"
},
"method": {
"type": "string",
"enum": [
"GET",
"POST"
],
"description": "HTTP method of the paid route (default: GET, then POST)"
}
},
"required": [
"url"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢x402_diagnose(url, method)
Paid ($0.01 USDC via x402 on Base or Solana): diagnose an x402 endpoint the way a paying agent would, without paying it: the 402 challenge format, every accepts[] option, the resource URL, Solana settlement readiness, which wallets can pay, Bazaar/OpenAPI discovery and the browser paywall. Returns every check with pass/warn/fail and a fix hint. Same as GET /api/v1/diagnose.
Input Schema
{
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "The x402 endpoint (public http(s) URL), e.g. https://api.example.com/paid"
},
"method": {
"type": "string",
"enum": [
"GET",
"POST"
],
"description": "HTTP method of the paid route (default: GET, then POST)"
}
},
"required": [
"url"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢x402_preflight(url, method, max_usd, network)
Paid ($0.001 USDC via x402 on Base or Solana): call this before your agent pays an x402 endpoint. Returns go, caution or no_go, the recommended payment option, and why: payment would fail, over your budget (max_usd), price above what is advertised, not HTTPS, unknown token, its 30-day track record. Never pays the endpoint. Same as GET /api/v1/preflight.
Input Schema
{
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "The x402 endpoint (public http(s) URL), e.g. https://api.example.com/paid"
},
"method": {
"type": "string",
"enum": [
"GET",
"POST"
],
"description": "HTTP method of the paid route (default: GET, then POST)"
},
"max_usd": {
"type": "number",
"exclusiveMinimum": 0,
"description": "Your budget per call in USD, e.g. 0.05"
},
"network": {
"type": "string",
"description": "CAIP-2 network you want to pay on, e.g. eip155:8453"
}
},
"required": [
"url"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢x402_fix(url, method, stack)
Paid ($0.05 USDC via x402 on Base or Solana): diagnoses your x402 endpoint, then returns per problem the concrete change as code for your stack (express, next, hono, node, python, generic), filled in with your own payTo, amount, network and route. Same as GET /api/v1/fix.
Input Schema
{
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "The x402 endpoint (public http(s) URL), e.g. https://api.example.com/paid"
},
"method": {
"type": "string",
"enum": [
"GET",
"POST"
],
"description": "HTTP method of the paid route (default: GET, then POST)"
},
"stack": {
"type": "string",
"enum": [
"express",
"next",
"hono",
"node",
"python",
"generic"
],
"description": "Your server stack (default: detected)"
}
},
"required": [
"url"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Community
Evidence