x402 Doctor
Check x402 endpoints like a paying agent: diagnose, fix plans, pre-payment checks. Free quick check.
我该使用它吗
质量与安全性
基于对工具定义和协议合规性的自动分析。
上下文开销
这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高，可用于其他任务的注意力就越少。
安装
一键安装
将以下内容添加到你的 `claude_desktop_config.json` 文件中：
{
"mcpServers": {
"x402-doctor": {
"url": "https://x402-doctor.onrender.com/mcp"
}
}
}远程端点
https://x402-doctor.onrender.com/mcpstreamable-httphttps://x402-doctor.fizzl.eu/mcpstreamable-http它能做什么
工具清单
工具（8）
🟢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).
输入模式
{
"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#"
}🟢check_payment_proof(header)
Free: after paying an x402 endpoint, pass the PAYMENT-RESPONSE header it returned (X-PAYMENT-RESPONSE in v1). Returns the transaction, network and payer it names, whether that transaction exists on-chain and succeeded, and which USDC moved from whom to whom, with an explorer link. Read-only. Limited to 10 calls per hour.
输入模式
{
"type": "object",
"properties": {
"header": {
"type": "string",
"minLength": 8,
"maxLength": 20000,
"description": "The PAYMENT-RESPONSE header value (base64 JSON)"
}
},
"required": [
"header"
],
"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. The answer carries a signed receipt (EIP-191, bound to your arguments) that proves later which verdict you got.
输入模式
{
"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. The answer carries a signed receipt (EIP-191, bound to your arguments) that proves later which verdict you got.
输入模式
{
"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. The answer carries a signed receipt (EIP-191, bound to your arguments) that proves later which verdict you got.
输入模式
{
"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#"
}🟢x402_preflight_batch(urls, method, max_usd, network)
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.
输入模式
{
"type": "object",
"properties": {
"urls": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"maxItems": 10,
"description": "The x402 endpoints to check (public http(s) URLs), at most 10"
},
"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": [
"urls"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢x402_preflight_deep(url, method, max_usd, network)
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.
输入模式
{
"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.5"
},
"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#"
}⚪feedback(type, message, endpoint, contact)
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.
输入模式
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"bug",
"feature",
"other"
],
"description": "bug, feature (something missing) or other"
},
"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"
},
"contact": {
"type": "string",
"description": "Optional: how to reach you about it"
}
},
"required": [
"message"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}社区
证据