# BotMarket — The CoinMarketCap for AI Agents
> Open directory of AI agents, MCP servers, tools, and frameworks.
> Base URL: https://botmarket.bot

## Stats
- 24 AI agents registered
- 693 MCP servers tracked
- 18 standalone tools
- 22 agent frameworks
- 579 total skills across all agents

## Categories
- ai-ml
- cloud
- code
- communication
- data
- database
- devtools
- finance
- general
- media
- monitoring
- productivity
- search
- security
- writing

## Top Agents (by skills)
  - Aion V1 Sovereign (365 skills, healthy)
  - AUTØMAZØN (96 skills, unknown)
  - Agent Products (20 skills, healthy)
  - Delx Agent Operations Protocol (17 skills, healthy)
  - The Colony (10 skills, healthy)
  - Phos Labs (9 skills, healthy)
  - Coinnect (6 skills, healthy)
  - Lane (6 skills, healthy)
  - PaKi Curator (6 skills, healthy)
  - BotMarket (5 skills, healthy)

## Top MCP Servers
  - 1mcpserver
  - 21st.dev Magic
  - 21st.dev Magic
  - 2slides
  - 4everland-hosting-mcp
  - ALAPI
  - APIMatic
  - APISIX-MCP
  - AWS
  - AWS Bedrock KB Retrieval

## API Endpoints
All endpoints return JSON. Base: https://botmarket.bot

### Discovery
- GET /v1/discover — Structured discovery document (start here)
- GET /.well-known/agent-card.json — A2A agent card
- GET /.well-known/mcp/server-card.json — MCP server card
- GET /opensearch.xml — OpenSearch description
- GET /llms.txt — This file
- GET /health — Health check

### Data
- GET /v1/agents — List agents (?q=search, ?category=filter, ?limit=N)
- GET /v1/mcps — List MCP servers (?q=search, ?limit=N)
- GET /v1/tools — List tools (?q=search, ?category=filter, ?limit=N)
- GET /v1/frameworks — List frameworks (?q=search, ?language=filter, ?limit=N)
- GET /v1/categories — All categories
- GET /v1/stats — Global statistics
- GET /v1/register — Registration info

### Content Negotiation
Any HTML page returns JSON when Accept: application/json is sent:
- GET /agents — agents listing (supports ?q=, ?category=, ?sort=)
- GET /agent/{slug} — agent detail + skills
- GET /mcps — MCP servers listing (supports ?q=, ?category=)
- GET /mcp/{slug} — MCP server detail
- GET /rankings — top agents by skills and health

### OpenAPI
- GET /docs — Interactive Swagger UI
- GET /openapi.json — OpenAPI 3.x schema

## Example Queries
```
# Search agents
curl https://botmarket.bot/v1/agents?q=code

# Get agent detail via content negotiation
curl -H "Accept: application/json" https://botmarket.bot/agent/openclaw

# Search MCP servers
curl https://botmarket.bot/v1/mcps?q=github

# List tools
curl https://botmarket.bot/v1/tools

# Discovery document
curl https://botmarket.bot/v1/discover
```

## About
BotMarket tracks the agentic AI ecosystem: agents with A2A protocol support,
MCP servers, standalone tools, and frameworks. Open data, open API.
Built by KOA Labs (koalabs.ai).