# EntRoute

> Machine-first API discovery for AI agents. EntRoute returns ranked, verified x402-compatible endpoints so agents can find and pay for APIs at runtime without human intervention.

EntRoute solves the discovery problem for the x402 ecosystem. Agents describe what they need (natural language or capability ID), and EntRoute returns endpoints ranked by success rate, latency, price, and stability. Every endpoint is probed every 10 minutes to verify it returns a proper 402 response. Top endpoints are further verified with real paid requests to confirm they return useful data after payment.

- Public API: `https://api.entroute.com`
- npm SDK: `@entroute/sdk-agent-ts`
- MCP Server: `@entroute/mcp-server` (install: `claude mcp add entroute -- npx @entroute/mcp-server`)
- 2,000+ endpoints across 34 capabilities with live endpoints, 375+ providers
- Every endpoint probed every 10 minutes for a valid 402 response; top endpoints additionally verified with real paid requests

## Docs

- [Quick Start](https://entroute.com/docs/quickstart): Get running in 5 minutes with cURL, TypeScript SDK, or MCP server
- [Core Concepts](https://entroute.com/docs/concepts): Capabilities, endpoints, ranking presets, and how discovery works
- [TypeScript SDK](https://entroute.com/docs/sdk): Reference for @entroute/sdk-agent-ts
- [MCP Server](https://entroute.com/docs/mcp): Integration guide for Claude and other MCP-compatible agents
- [REST API](https://entroute.com/docs/api): Full API reference for POST /discover, GET /capabilities, POST /submit
- [x402 Protocol](https://entroute.com/docs/x402): How x402 payments work with EntRoute
- [Verification](https://entroute.com/docs/verification): How endpoints are probed and verified

## Key API Endpoints

- `POST /discover`: Find ranked endpoints by capability_id or natural language intent
- `GET /capabilities`: List all available capabilities with metadata and tags
- `GET /providers`: Browse all providers with endpoint and capability counts
- `POST /submit`: Register a new x402 endpoint (provider self-service)
- `POST /report_outcome`: Report call success/failure for ranking feedback
- `POST /report`: Flag a bad endpoint (no_data, wrong_capability, payment_failed, misleading_price, offline)

## Capabilities

Browse all capabilities at https://entroute.com/capabilities. Browse all providers at https://entroute.com/providers. Categories include:
- `defi.*` (token prices, swaps, portfolio, yield, gas estimation)
- `web.*` (search, scraping)
- `ai.*` (chat completion, image generation, embeddings)
- `crypto.*` (token analysis, risk intelligence, smart money)
- `identity.*` (wallet profiles, ENS resolution)
- `social.*` (Twitter user data)
- `news.*` (search, trending)
- `security.*` (compliance, contract audits)
- `prediction.*` (market data, odds)
- `image.*` (generation)

## Blog

- [How AI Agents Discover and Pay for APIs with x402](https://entroute.com/blog/how-ai-agents-discover-and-pay-for-apis-with-x402): First-person account of building the discovery layer for x402
- [I Gave Claude Code $5 of USDC and Asked It to Research a Token](https://entroute.com/blog/i-gave-claude-code-five-dollars-and-asked-it-to-research-a-token): Walkthrough of an autonomous agent discovering, paying for, and using x402 APIs at runtime — no API keys

## Leaderboard & Ecosystem

- [Payment Volume Leaderboard](https://entroute.com/leaderboard): On-chain USDC payment volume per provider (Base network)
- [Ecosystem Dashboard](https://entroute.com/ecosystem): Live view of the x402 endpoint ecosystem
- [Live Stats](https://entroute.com/stats): Discovery traffic, trending capabilities, verification metrics