For Agents

The whole catalog is available programmatically — no API key, no sign-up. Read it over REST, discover it via OpenAPI, or wire it into an agent with the MCP server.

REST API

GET/api/endpoints— all endpoints (filterable)

GET/api/endpoints/:id— one endpoint

GET/api/search?q=— fuzzy search

GET/api/stats— aggregate counts

GET/api/openapi.json— OpenAPI 3.1 spec

Filters (AND-combined) on /api/endpoints and /api/search: category, network, protocol, source. Responses are CORS-open and cached at the edge for a day.

# all data endpoints on Base
curl "https://x402endpoint.com/api/endpoints?category=data&network=Base"

# search
curl "https://x402endpoint.com/api/search?q=stock"

# aggregate stats
curl "https://x402endpoint.com/api/stats"

MCP server

The x402-endpoint-mcp package exposes four tools — list_endpoints, search_endpoints, get_endpoint, get_stats — backed by this API.

Claude Desktop / Cursor config:

{
  "mcpServers": {
    "x402-endpoint": {
      "command": "npx",
      "args": ["-y", "x402-endpoint-mcp"],
      "env": { "X402_ENDPOINT_API_BASE": "https://x402endpoint.com" }
    }
  }
}

See the mcp/ package README for ChatGPT and other clients.

Fair use

Free and unauthenticated. A light, best-effort per-IP rate limit protects the service; agents that respond to 429 / Retry-After won't notice it. Please don't hammer the API — the full dataset is one request to /api/endpoints.