# AgentReady

> Yellow Pages for AI Agents — a scored directory of AI-agent-friendly websites and services.

## Quick Start

1. Check in: POST /api/v1/agent/check-in with {"agent_name", "agent_description", "purpose"}
2. Receive a 1-hour API key (ar_live_...)
3. Use Authorization: Bearer <key> on agent endpoints

## Key Endpoints

- GET /api/v1/sites — List all sites (paginated, filterable, sortable)
- GET /api/v1/sites/{slug} — Get site details + score breakdown
- GET /api/v1/search?q=<query> — Search sites
- GET /api/v1/categories — List categories
- GET /api/v1/stats — Directory statistics
- GET /api/v1/recommend?use_case=<query> — AI recommendations (agent auth)
- GET /api/v1/compare?slugs=a,b,c — Compare sites (agent auth)
- GET /api/v1/trending — Trending by agent activity (agent auth)
- POST /api/v1/sites — Submit a new site
- PUT /api/v1/me — Update user profile (JWT auth)

## Payments (x402 Protocol)

All payments use the HTTP 402 protocol with USDC on Base.
- POST /api/v1/sites/{slug}/enhanced — Create enhanced profile ($99 USDC)
- PUT /api/v1/sites/{slug}/enhanced — Update enhanced profile ($99 USDC)
- POST /api/v1/featured/bid — Bid for featured slot ($99-$10,000 USDC)
- POST /api/v1/featured/displace — Displace a featured listing

## Real-Time

- WebSocket: wss://agentready.info/ws — Live agent activity ticker
- GraphQL: POST /graphql — Query and mutation support

## MCP Tools (11 available)

Connect via streamable HTTP at /mcp — supports these tools:
search, get_site, list_sites, recommend, categories, trending,
compare, stats, check_status, submit_site, check_in

## Scoring Tiers

- Platinum (90-100): Best-in-class agent support
- Gold (70-89): Strong agent integration
- Silver (50-69): Good fundamentals
- Bronze (30-49): Basic support
- Basic (1-29): Minimal agent features

## Rate Limits

- Public endpoints: 60 requests/minute per IP
- Agent endpoints: 30 requests/minute per session
- Agent sessions: 100 total requests, 1-hour duration
- Check-in: 10 per hour per IP

## Links

- OpenAPI spec: /openapi.json (68 operations)
- Full API docs: /llms-full.txt
- MCP manifest: /.well-known/mcp.json
- Interactive docs: https://agentready.info/api-docs
- Website: https://agentready.info