x402 Doctor
by x402fizzlco.huggingface.x402fizzl/x402-doctor
Check x402 paid APIs before an AI agent pays (MCP)
- Remote endpoint
- 4 tools
- MIT
Uptime
Checked · every day
100%from 4 days of checks
Up without downtime on 4 of 4 days with data.
- No downtime
- Degraded
- Down over 5 minutes
- No data
- Not checked yet
Response time
Median 1113 ms, slowest 5% 1244 ms for the handshake and the tool list, over 30 days.
How far each check got
- Reached the address 100%
- Completed the handshake 100%
- Listed its tools 100%
4 tools at the last answer.
Every day
| Day | Result | Checks | Median |
|---|---|---|---|
| 3 Nov (today) | No downtime | 1 | 1178 ms |
| 2 Nov | No downtime | 1of 1 | 1113 ms |
| 1 Nov | No downtime | 1of 1 | 1129 ms |
| 31 Oct | No downtime | 1 | 1111 ms |
A failure counts as down time only when a second check five minutes later fails too. How we check
Connect to the publisher's own endpoint
Paste into Settings › Connectors › Add custom connector:
https://x402fizzl-x402-doctor.hf.space/gradio_api/mcp/sse Run in a terminal:
claude mcp add --transport sse x402-doctor https://x402fizzl-x402-doctor.hf.space/gradio_api/mcp/sse Add to ~/.cursor/mcp.json:
Add to ~/.config/devin/mcp_config.json:
Add to mcp.json (Program › Install › Edit mcp.json):
Add to ~/.gemini/settings.json:
Add to config.json in oterm's data folder (~/Library/Application Support/oterm on macOS, ~/.local/share/oterm on Linux, %APPDATA%\oterm on Windows):
Add to ~/.config/eca/config.json (global) or .eca/config.json in the project:
{
"mcpServers": {
"x402-doctor": {
"url": "https://x402fizzl-x402-doctor.hf.space/gradio_api/mcp/sse"
}
}
} Add to .vscode/mcp.json:
{
"servers": {
"x402-doctor": {
"type": "sse",
"url": "https://x402fizzl-x402-doctor.hf.space/gradio_api/mcp/sse"
}
}
} Add to ~/.config/zed/settings.json:
{
"context_servers": {
"x402-doctor": {
"url": "https://x402fizzl-x402-doctor.hf.space/gradio_api/mcp/sse"
}
}
} This server's endpoint speaks only SSE, which this client's documentation does not list among its transports; use another client for it.
Add to cline_mcp_settings.json (MCP Servers › Configure › Configure MCP Servers):
Add to anythingllm_mcp_servers.json in the AnythingLLM storage plugins directory:
Add to Augment Settings Panel – MCP section – Import from JSON (VS Code extension):
{
"mcpServers": {
"x402-doctor": {
"type": "sse",
"url": "https://x402fizzl-x402-doctor.hf.space/gradio_api/mcp/sse"
}
}
} Add to ~/.continue/config.yaml:
mcpServers:
- name: "x402-doctor"
type: sse
url: "https://x402fizzl-x402-doctor.hf.space/gradio_api/mcp/sse" Add to ~/.config/goose/config.yaml:
extensions:
"x402-doctor":
type: streamable_http
name: "x402-doctor"
enabled: true
uri: "https://x402fizzl-x402-doctor.hf.space/gradio_api/mcp/sse"
headers: {}
env_keys: []
envs: {}
timeout: 300 This server's endpoint speaks only SSE, which this client's documentation does not list among its transports; use another client for it.
Run in a terminal:
codex mcp add x402-doctor --url https://x402fizzl-x402-doctor.hf.space/gradio_api/mcp/sse This server's endpoint speaks only SSE, which this client's documentation does not list among its transports; use another client for it.
Add to ~/.llm/config.json:
Add to resources/assets/config/mcp.json in the installed app:
Add to ~/.boltai/mcp.json:
Add to ~/.bob/settings/mcp.json (global) or .bob/mcp.json (project):
Add to ~/.kiro/settings/mcp.json (user) or .kiro/settings/mcp.json (workspace):
Add to ~/.kiro/settings/mcp.json (user) or .kiro/settings/mcp.json (workspace):
{
"mcpServers": {
"x402-doctor": {
"url": "https://x402fizzl-x402-doctor.hf.space/gradio_api/mcp/sse"
}
}
} This server's endpoint speaks only SSE, which this client's documentation does not list among its transports; use another client for it.
Add to ~/.config/agenvoy/mcp.json:
{
"servers": {
"x402-doctor": {
"url": "https://x402fizzl-x402-doctor.hf.space/gradio_api/mcp/sse"
}
}
} This server's endpoint speaks only SSE, which this client's documentation does not list among its transports; use another client for it.
Add to ~/.config/amp/settings.json (user) or .amp/settings.json (workspace):
{
"amp.mcpServers": {
"x402-doctor": {
"url": "https://x402fizzl-x402-doctor.hf.space/gradio_api/mcp/sse"
}
}
} For agents: the install prompt
Every step above as one Markdown text, for an assistant installing it for you.
# Install the MCP server x402 Doctor (`co.huggingface.x402fizzl/x402-doctor`)
Its page: https://plug.directory/servers/co.huggingface.x402fizzl/x402-doctor
It runs on the publisher's servers; the client connects to its URL.
Use the section for the person's client.
## Claude Desktop
Paste into Settings › Connectors › Add custom connector:
```text
https://x402fizzl-x402-doctor.hf.space/gradio_api/mcp/sse
```
## Claude Code
Run in a terminal:
```sh
claude mcp add --transport sse x402-doctor https://x402fizzl-x402-doctor.hf.space/gradio_api/mcp/sse
```
## Cursor, Devin Desktop, LM Studio, Gemini CLI, oterm, ECA
Merge into the place for the person's client:
- Cursor: ~/.cursor/mcp.json
- Devin Desktop: ~/.config/devin/mcp_config.json
- LM Studio: mcp.json (Program › Install › Edit mcp.json)
- Gemini CLI: ~/.gemini/settings.json
- oterm: config.json in oterm's data folder (~/Library/Application Support/oterm on macOS, ~/.local/share/oterm on Linux, %APPDATA%\oterm on Windows)
- ECA: ~/.config/eca/config.json (global) or .eca/config.json in the project
```json
{
"mcpServers": {
"x402-doctor": {
"url": "https://x402fizzl-x402-doctor.hf.space/gradio_api/mcp/sse"
}
}
}
```
## VS Code
Merge into .vscode/mcp.json:
```json
{
"servers": {
"x402-doctor": {
"type": "sse",
"url": "https://x402fizzl-x402-doctor.hf.space/gradio_api/mcp/sse"
}
}
}
```
## Zed
This server's endpoint speaks only SSE, which this client's documentation does not list among its transports; use another client for it.
## Cline, AnythingLLM, Augment Code
Merge into the place for the person's client:
- Cline: cline_mcp_settings.json (MCP Servers › Configure › Configure MCP Servers)
- AnythingLLM: anythingllm_mcp_servers.json in the AnythingLLM storage plugins directory
- Augment Code: Augment Settings Panel – MCP section – Import from JSON (VS Code extension)
```json
{
"mcpServers": {
"x402-doctor": {
"type": "sse",
"url": "https://x402fizzl-x402-doctor.hf.space/gradio_api/mcp/sse"
}
}
}
```
## Continue
Merge into ~/.continue/config.yaml:
```yaml
mcpServers:
- name: "x402-doctor"
type: sse
url: "https://x402fizzl-x402-doctor.hf.space/gradio_api/mcp/sse"
```
## Goose
This server's endpoint speaks only SSE, which this client's documentation does not list among its transports; use another client for it.
## Codex
This server's endpoint speaks only SSE, which this client's documentation does not list among its transports; use another client for it.
## mcp-client-cli, TUUI, BoltAI, Bob Shell, Kiro, Kiro CLI
This server's endpoint speaks only SSE, which this client's documentation does not list among its transports; use another client for it.
## Agenvoy
This server's endpoint speaks only SSE, which this client's documentation does not list among its transports; use another client for it.
## Amp
Merge into ~/.config/amp/settings.json (user) or .amp/settings.json (workspace):
```json
{
"amp.mcpServers": {
"x402-doctor": {
"url": "https://x402fizzl-x402-doctor.hf.space/gradio_api/mcp/sse"
}
}
}
```
Then restart the client, or reload its MCP servers, and ask it to list the server's tools to confirm it started.
Tools 4
x402_doctor_add_to_trust_indexAdd your own paid endpoint to the x402 Trust Index when no registry lists it yet. The daily scan covers every endpoint listed in the CDP Bazaar, Circle's Agent Marketplace, GoPlausible's discovery list or the MPP directory. Not listed anywhere? x402 Doctor first checks that the endpoint answers 402 with a payment challenge (x402, MPP or L402); the next daily scan then starts its track record, which buyers' agents see before they pay. At most 25 endpoints per host.x402_doctor_check_x402_endpointCheck a paid x402 (or MPP) API endpoint the way a paying agent meets it, without paying. Triggers the 402 challenge once and checks it: protocol version, payment options (network, amount, asset, payout address), the resource URL, sanctions and burn addresses, price against the OpenAPI document, and which wallets could pay. Returns the overall result, every problem with its fix, and the payment options.x402_doctor_trust_recordThe daily track record of a paid endpoint listed in the CDP Bazaar, Circle's Agent Marketplace, GoPlausible's discovery list or the MPP directory, or added by its seller. x402 Doctor checks every listed endpoint once a day without paying. The record shows how many days it was payable, the latest verdict (go, caution or no_go) with its reasons, the price and networks, and what happened when Doctor bought it in its weekly spot-buy sample, if it did.x402_doctor_x402_market_healthHow healthy the x402 market is today: the latest daily check of every endpoint in the CDP Bazaar and the MPP directory. Returns the share of endpoints that are payable, clean, payable with a caution or not payable, the most common reasons a payment would fail, and the networks payable endpoints accept.
From Hugging Face Spaces. Report a problem