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.

1500 ms750 ms0

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
DayResultChecksMedian
3 Nov (today)No downtime11178 ms
2 NovNo downtime1of 11113 ms
1 NovNo downtime1of 11129 ms
31 OctNo downtime11111 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

Add to ~/.continue/config.yaml:

mcpServers:
  - name: "x402-doctor"
    type: sse
    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_index Add 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_endpoint Check 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_record The 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_health How 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