MCP Server
x402 Doctor
io.github.Fizzl13/x402-doctor
What this MCP does
Diagnoses x402 payment endpoints, generates implementation fix plans, and checks endpoint payments before funds are sent.
Capabilities
Tools
7
tools
feedback
Send feedback (free)
Report a bug, a missing feature or anything else about this service, in a structured way. Free. A person reads every report; nothing is run or changed automatically.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['message'], 'properties': {'type': {'enum': ['bug', 'feature', 'other'], 'type': 'string', 'description': 'bug, feature (something missing) or other'}, 'contact': {'type': 'string', 'description': 'Optional: how to reach you about it'}, 'message': {'type': 'string', 'description': 'What happened or what you need'}, 'endpoint': {'type': 'string', 'description': 'Optional: the route or tool it is about, e.g. /v1/token'}}, 'additionalProperties': False}
x402_diagnose
Diagnose an x402 endpoint ($0.01 via x402)
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. The answer carries a signed receipt (EIP-191, bound to your arguments) that proves later which verdict you got.
Read only
Open world
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['url'], 'properties': {'url': {'type': 'string', 'description': 'The x402 endpoint (public http(s) URL), e.g. https://api.example.com/paid'}, 'method': {'enum': ['GET', 'POST'], 'type': 'string', 'description': 'HTTP method of the paid route (default: GET, then POST)'}}, 'additionalProperties': False}
x402_fix
Fix plan for an x402 endpoint ($0.05 via x402)
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. The answer carries a signed receipt (EIP-191, bound to your arguments) that proves later which verdict you got.
Read only
Open world
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['url'], 'properties': {'url': {'type': 'string', 'description': 'The x402 endpoint (public http(s) URL), e.g. https://api.example.com/paid'}, 'stack': {'enum': ['express', 'next', 'hono', 'node', 'python', 'generic'], 'type': 'string', 'description': 'Your server stack (default: detected)'}, 'method': {'enum': ['GET', 'POST'], 'type': 'string', 'description': 'HTTP method of the paid route (default: GET, then POST)'}}, 'additionalProperties': False}
x402_preflight
Check an x402 endpoint before paying it ($0.001 via x402)
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. The answer carries a signed receipt (EIP-191, bound to your arguments) that proves later which verdict you got.
Read only
Open world
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['url'], 'properties': {'url': {'type': 'string', 'description': 'The x402 endpoint (public http(s) URL), e.g. https://api.example.com/paid'}, 'method': {'enum': ['GET', 'POST'], 'type': 'string', 'description': 'HTTP method of the paid route (default: GET, then POST)'}, 'max_usd': {'type': 'number', 'description': 'Your budget per call in USD, e.g. 0.05', 'exclusiveMinimum': 0}, 'network': {'type': 'string', 'description': 'CAIP-2 network you want to pay on, e.g. eip155:8453'}}, 'additionalProperties': False}
x402_preflight_batch
Check up to 10 x402 endpoints before paying ($0.005 via x402)
Paid ($0.005 USDC via x402 on Base or Solana): the pre-payment check for up to 10 x402 endpoints at once. Per endpoint go, caution or no_go, the recommended payment option and why, plus totals. For marketplaces and agents that weigh several services. Never pays the endpoints. Same as GET /api/v1/preflight/batch. The answer carries a signed receipt (EIP-191, bound to your arguments) that proves later which verdict you got.
Read only
Open world
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['urls'], 'properties': {'urls': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 10, 'minItems': 1, 'description': 'The x402 endpoints to check (public http(s) URLs), at most 10'}, 'method': {'enum': ['GET', 'POST'], 'type': 'string', 'description': 'HTTP method of the paid route (default: GET, then POST)'}, 'max_usd': {'type': 'number', 'description': 'Your budget per call in USD, e.g. 0.05', 'exclusiveMinimum': 0}, 'network': {'type': 'string', 'description': 'CAIP-2 network you want to pay on, e.g. eip155:8453'}}, 'additionalProperties': False}
x402_preflight_deep
Deep check of an x402 endpoint before an expensive payment ($0.01 via x402)
Paid ($0.01 USDC via x402 on Base or Solana): for expensive calls. The pre-payment verdict (go, caution or no_go) plus the full diagnosis, the 30-day history per day, how reliable the seller's other endpoints are and whether the endpoint moved domains. Never pays the endpoint. Same as GET /api/v1/preflight/deep. The answer carries a signed receipt (EIP-191, bound to your arguments) that proves later which verdict you got.
Read only
Open world
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['url'], 'properties': {'url': {'type': 'string', 'description': 'The x402 endpoint (public http(s) URL), e.g. https://api.example.com/paid'}, 'method': {'enum': ['GET', 'POST'], 'type': 'string', 'description': 'HTTP method of the paid route (default: GET, then POST)'}, 'max_usd': {'type': 'number', 'description': 'Your budget per call in USD, e.g. 0.5', 'exclusiveMinimum': 0}, 'network': {'type': 'string', 'description': 'CAIP-2 network you want to pay on, e.g. eip155:8453'}}, 'additionalProperties': False}
x402_quick_check
Quick x402 endpoint check (free)
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).
Read only
Open world
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['url'], 'properties': {'url': {'type': 'string', 'description': 'The x402 endpoint (public http(s) URL), e.g. https://api.example.com/paid'}, 'method': {'enum': ['GET', 'POST'], 'type': 'string', 'description': 'HTTP method of the paid route (default: GET, then POST)'}}, 'additionalProperties': False}
History
Recent tool changes
Added
x402_preflight_deep
Oct. 1, 2026, 2:42 a.m.
Added
x402_preflight_batch
Oct. 1, 2026, 2:42 a.m.
Added
feedback
Sept. 29, 2026, 2:48 a.m.
Changed
x402_fix
Sept. 29, 2026, 2:48 a.m.
Changed
x402_preflight
Sept. 29, 2026, 2:48 a.m.
Changed
x402_diagnose
Sept. 29, 2026, 2:48 a.m.
Added
x402_fix
Sept. 27, 2026, 2:40 a.m.
Added
x402_preflight
Sept. 27, 2026, 2:40 a.m.
Added
x402_diagnose
Sept. 27, 2026, 2:40 a.m.
Added
x402_quick_check
Sept. 27, 2026, 2:40 a.m.
Discover
Similar MCP servers
PayRam Helper MCP Server
io.github.PayRam/payram-helper-mcp
Helps integrate and operate self-hosted PayRam crypto payment and payout systems with readiness checks, payment links, status flo…
Slid Phi Labs
io.github.ceedot-rock/slid-phi-labs
Provides searchable catalogs and documentation for agent services, issues agent API keys, exposes x402-purchasable SKUs, and offe…
AgentPay — Pay-per-call AI Microservices
io.github.ronaldanton/agentpay
Exposes pay-per-call microservices for research, translation, code review, security checks, web access, financial data, and other…
SALT19 Agent Utility Grid
io.github.GabrielAllit1/salt19-agent-utility-grid
Provides paid agent decision gates, code and dependency risk checks, repository intelligence, blockchain facts, payment-policy ch…
SparkPay
dev.sparkpay/sparkpay
Manages Stripe-based billing for indie applications, including plans, pricing, coupons, subscriptions, customers, revenue reporti…
ROKI Connect
la.roki/connect
Provides documentation, schemas, validation, examples, sandbox execution, and troubleshooting tools for integrating ROKI Connect …
trading-mcp
com.ai-rook.agents/trading-mcp
Catalogs and quotes paid trading, AI, blockchain, developer, and escrow endpoints, and provides previews, escrow inspection, atte…
htmlweb.ru — справочники и проверки для AI
ru.htmlweb/mcp
Provides access to HTMLWeb's Russian reference and checking APIs through a generic catalog and call interface, along with agent r…