@x402relay/mcp

MCP server for the x402 Hub Directory — search and discover x402-enabled APIs directly from Claude Desktop, Cursor, or any MCP-compatible client.

Tools

| Tool | Description | |------|-------------| | search_services | Search x402-enabled services by keyword or category | | get_service_detail | Get detailed info about a specific service | | list_categories | List all service categories with counts | | check_service_status | Check operational status and trust score | | why_this_api | Explain why an API was selected (trust, tier, alternatives) |

Quick Start

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "x402-hub": {
      "command": "npx",
      "args": ["@x402relay/mcp"]
    }
  }
}

With a custom database path

{
  "mcpServers": {
    "x402-hub": {
      "command": "npx",
      "args": ["@x402relay/mcp"],
      "env": {
        "X402_DB_PATH": "/path/to/your/x402-hub.db"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "x402-hub": {
      "command": "npx",
      "args": ["@x402relay/mcp"]
    }
  }
}

Environment Variables

| Variable | Default | Description | |----------|---------|-------------| | X402_DB_PATH | ./x402-hub.db | Path to the SQLite database | | DB_PATH | ./x402-hub.db | Alternative (legacy) |

Development

pnpm install
pnpm build
pnpm dev   # run with tsx

License

MIT