# BotFriendly.xyz

BotFriendly is a curated directory of services AI agents can actually use.
We list APIs, tools, and merchants that support machine-to-machine auth,
MCP servers, and agent payment protocols (MPP, x402, ACP, UCP).
Every service is manually verified against bot-friendly criteria.

## API

Base URL: https://www.botfriendly.xyz/api/v1

### Endpoints

- GET /api/v1/services — List and filter all services
  Query params: ?category=browse&has_mcp=true&accepts_mpp=true&has_skill_file=true&has_llms_txt=true&has_agent_protocol=true&auth_method=api-key&search=browser&min_score=4&sort=score&page=1&per_page=20
  Sort options: score (default), votes, name, newest
- GET /api/v1/services/{slug} — Get a single service by slug (full details)
- GET /api/v1/search?q=... — Full-text search across services
  Query params: ?q=vector+database&category=remember&page=1&per_page=20
- GET /api/v1/categories — List all categories with service counts
- GET /api/v1/featured — Get site-wide promoted/featured services (max 3)
- GET /api/v1/protocols — Protocol adoption stats (MCP, OpenAPI, MPP, x402, ACP, UCP)
- GET /api/v1/stats — Directory stats (total services, per-category counts, protocol coverage)
- POST /api/v1/submissions — Submit a new service for review (no auth required)
- GET /api/v1/health — Health check and endpoint discovery
- GET /api/v1/openapi.json — Full OpenAPI 3.1 specification

### Authentication

No authentication required for read endpoints. Rate limited to 100 req/min by IP.
For higher limits, use an API key: Authorization: Bearer bf_your_key_here (1,000 req/min).

### Machine-Readable Interfaces

- OpenAPI Spec: https://www.botfriendly.xyz/api/v1/openapi.json
- MCP Server: https://www.botfriendly.xyz/mcp (Streamable HTTP transport)
- MCP Server Config: https://www.botfriendly.xyz/mcp.json
- AI Plugin Manifest: https://www.botfriendly.xyz/.well-known/ai-plugin.json

## Categories

  - think: Think — LLM providers, reasoning APIs, embeddings, classification
  - see: See — Vision, OCR, document parsing, visual reasoning
  - hear-speak: Hear + Speak — Speech-to-text, text-to-speech, voice cloning, audio gen
  - create: Create — Image gen, video gen, music gen, design APIs
  - remember: Remember — Vector DBs, key-value stores, databases, agent memory
  - search: Search — Web search, semantic search, content retrieval for agents
  - browse: Browse — Headless browsers, scraping, web automation
  - communicate: Communicate — Email, SMS, chat, notification APIs
  - execute: Execute — Code execution sandboxes, serverless compute, GPUs
  - pay: Pay — Agent payment rails — MPP, x402, crypto gateways
  - shop: Shop — Merchants/services accepting agent-initiated purchases
  - identify: Identify — M2M auth, agent identity, API key management
  - connect: Connect — Agent frameworks, tool platforms, orchestration
  - automate: Automate — Workflow engines with APIs agents can trigger
  - monitor: Monitor — Observability, tracing, error tracking for agent ops

## Example Queries

Search for browser automation tools with MCP:
  curl "https://www.botfriendly.xyz/api/v1/services?category=browse&has_mcp=true"

Find all services accepting x402 payments:
  curl "https://www.botfriendly.xyz/api/v1/services?accepts_x402=true"

Full-text search for services:
  curl "https://www.botfriendly.xyz/api/v1/search?q=vector+database"

Get services with a bot-friendly score of 5, sorted by votes:
  curl "https://www.botfriendly.xyz/api/v1/services?min_score=5&sort=votes"

Find services with skill files or llms.txt:
  curl "https://www.botfriendly.xyz/api/v1/services?has_skill_file=true"
  curl "https://www.botfriendly.xyz/api/v1/services?has_llms_txt=true"

Get featured/promoted services:
  curl "https://www.botfriendly.xyz/api/v1/featured"

## Submitting a Service

POST https://www.botfriendly.xyz/api/v1/submissions
Content-Type: application/json

{
  "name": "YourService",
  "url": "https://yourservice.dev",
  "category": "browse",
  "description": "What your service does for agents",
  "auth_method": "api-key",
  "has_mcp_server": true,
  "contact_email": "you@example.com"
}

No authentication required. All submissions are manually reviewed.