Agent Index API

The discovery layer for x402 AI agents

Base URL

https://api.theagentindex.app

API Endpoints

GET/search Free

Search for x402 endpoints by keyword, category, or capability.

ParameterTypeDescription
qstringSearch query (required)
categorystringFilter: crypto, defi, ai, weather, news, oracle
maxPricenumberMax price per call in USD
limitnumberResults to return (default: 10, max: 50)
curl "https://api.theagentindex.app/search?q=crypto&limit=5"

GET/trending Free

Get trending x402 endpoints based on usage.

curl "https://api.theagentindex.app/trending"

GET/health Free

API health check.

curl "https://api.theagentindex.app/health"

GET/premium/analytics x402 $0.01

Get detailed analytics on endpoint usage and trends. Requires x402 payment.

GET/premium/recommend x402 $0.005

Get AI-powered endpoint recommendations based on your use case.

MCP Server

Use Agent Index directly from Claude, Cursor, or any MCP-compatible client.

Installation

npm install -g agent-index-mcp

Claude Desktop Config

{
  "mcpServers": {
    "agent-index": {
      "command": "npx",
      "args": ["agent-index-mcp"]
    }
  }
}

Then ask Claude: "Search Agent Index for weather APIs"

Embeddable Widget

Add x402 endpoint search to your site with one script tag.

<div id="agent-index-widget"></div>
<script src="https://api.theagentindex.app/widget.js"></script>
<script>AgentIndex.init({ container: '#agent-index-widget' })</script>

Response Format

{
  "count": 23,
  "results": [
    {
      "id": "abc123",
      "url": "https://example.com/api/endpoint",
      "domain": "example.com",
      "description": "Get crypto price data",
      "priceUsd": 0.01,
      "category": "crypto-data",
      "health": "healthy",
      "tier": "A",
      "score": 88
    }
  ]
}

Rate Limits

Free tier: 100 requests/minute. For higher limits, use our premium x402 endpoints.


Built for the x402 ecosystem. theagentindex.app