# x402-list-mcp

Inspects x402 payment APIs before triggering a transaction, tracking uptime, pricing, and on-chain settlement numbers directly from your agent.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 26
- Author: mcccsm
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/mcccsm/x402-list-mcp
- Updated: 2026-10-13
- HTML: https://affpapa.org/en/nevibecode/mcp/x402-list-mcp

## What it does

The package acts as a light interface to the public x402-list JSON API. It does not touch databases, never alters registry records, and stores no keys.

Seven tools are exposed to the model. Six functions handle read-only queries free of charge. They search service listings, check uptime streaks, read USD pricing per endpoint, and inspect settlement volume. The seventh tool, `x402_assess_services`, is a paid benchmark costing 0.25 USDC on Base. It works strictly as a relay. You must sign the payment challenge on your client, because the server does not store private credentials or execute transfers.

You can point your client to the hosted HTTP endpoint or execute the npm package locally over stdio. Running it locally requires Node.js 20 or newer alongside npm.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.x402-list.com/mcp`
- Environment variables: `X402_LIST_BASE_URL`, `X402_LIST_TIMEOUT_MS` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http x402-list-mcp https://mcp.x402-list.com/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env X402_LIST_BASE_URL=<X402_LIST_BASE_URL> --env X402_LIST_TIMEOUT_MS=<X402_LIST_TIMEOUT_MS> --transport stdio x402-list-mcp -- npx -y x402-list-mcp
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add x402-list-mcp --url https://mcp.x402-list.com/mcp
```

2. **Platform CLI**
```bash
codex mcp add x402-list-mcp --env X402_LIST_BASE_URL=<X402_LIST_BASE_URL> --env X402_LIST_TIMEOUT_MS=<X402_LIST_TIMEOUT_MS> -- npx -y x402-list-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "x402-list-mcp": {
            "url": "https://mcp.x402-list.com/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "x402-list-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "x402-list-mcp"
            ],
            "env": {
                "X402_LIST_BASE_URL": "<X402_LIST_BASE_URL>",
                "X402_LIST_TIMEOUT_MS": "<X402_LIST_TIMEOUT_MS>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "x402-list-mcp": {
            "type": "http",
            "url": "https://mcp.x402-list.com/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "x402-list-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "x402-list-mcp"
            ],
            "env": {
                "X402_LIST_BASE_URL": "<X402_LIST_BASE_URL>",
                "X402_LIST_TIMEOUT_MS": "<X402_LIST_TIMEOUT_MS>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http x402-list-mcp https://mcp.x402-list.com/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e X402_LIST_BASE_URL=<X402_LIST_BASE_URL> -e X402_LIST_TIMEOUT_MS=<X402_LIST_TIMEOUT_MS> x402-list-mcp npx -y x402-list-mcp
```
Replace <…> with your own values

## When to use it
- discover APIs accepting x402 micropayments
- verify endpoint response times and recent outages
- review on-chain facilitator settlement volume
- monitor payout address and pricing changes

## Example prompts
- Search the x402 directory for transcription services sorted by uptime.
- Identify the top-ranked endpoint using x402_find_best_service.
- Review price and schema modifications via x402_change_events for the past 30 days.

## Similar
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16717
- [PostHog MCP Server](https://affpapa.org/en/nevibecode/mcp/posthog-mcp-server.md) — MCP server · ★ 40409
- [OpenWork MCP Gateway](https://affpapa.org/en/nevibecode/mcp/openwork-mcp-gateway.md) — MCP server · ★ 24242
- [Keploy](https://affpapa.org/en/nevibecode/mcp/keploy.md) — MCP server · ★ 18727
- [Nhost](https://affpapa.org/en/nevibecode/mcp/nhost.md) — MCP server · ★ 9366
- [basebalance.cloud — x402 RPC & MCP gateway](https://affpapa.org/en/nevibecode/mcp/basebalancecloud-x402-rpc-mcp-gateway.md) — MCP server · ★ 7506

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md