$ endpoints

GET/api/v1/services

List and filter all services. Returns paginated results with full protocol details.

// parameters

- category — filter by category slug (think, browse, pay, etc.)
- has_mcp=true — only services with MCP servers
- accepts_mpp=true — only services accepting MPP
- accepts_x402=true — only services accepting x402
- has_skill_file=true — only services with skill files
- has_plugin_manifest=true — only services with plugin manifests
- has_llms_txt=true — only services with llms.txt
- has_agent_protocol=true — only services with agent protocol endpoints
- auth_method — filter by auth (api-key, m2m-oauth, bot-token, wallet, x402-none, none)
- search — full-text search across name, description, tags
- min_score — minimum bot-friendly score (1-5)
- sort — score (default), votes, name, newest
- promoted — true for promoted only, false for organic only
- page, per_page — pagination (default 1, 20; max 100)

// example

curl "https://www.botfriendly.xyz/api/v1/services?category=browse&has_mcp=true"

GET/api/v1/services/{slug}

Get full details for a single service including all protocol support, URLs, and metadata.

// example

curl "https://www.botfriendly.xyz/api/v1/services/browserbase"

GET/api/v1/search

Full-text search across services. Returns results ranked by bot_score.

// parameters

- q (required) — search query (supports websearch syntax)
- category — filter by category slug
- page, per_page — pagination (default 1, 20; max 100)

// example

curl "https://www.botfriendly.xyz/api/v1/search?q=vector+database"

GET/api/v1/categories

List all categories with service counts

// example

curl "https://www.botfriendly.xyz/api/v1/categories"

GET/api/v1/featured

Get site-wide promoted/featured services (max 3). Clearly marked as ads.

// example

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

GET/api/v1/protocols

Protocol adoption stats — MCP, OpenAPI, MPP, x402, ACP, UCP

// example

curl "https://www.botfriendly.xyz/api/v1/protocols"

GET/api/v1/stats

Directory statistics — total services, per-category counts, protocol coverage

// example

curl "https://www.botfriendly.xyz/api/v1/stats"

POST/api/v1/submissions

Submit a new service for review. No auth required.

// parameters

- name (required) — service name
- url (required) — service URL
- category (required) — category slug
- description (required) — max 120 chars
- auth_method — api-key, m2m-oauth, bot-token, wallet, x402-none, none
- has_mcp_server, mcp_server_url — MCP server support
- has_openapi_spec, openapi_spec_url — OpenAPI spec support
- accepts_mpp, accepts_x402 — payment protocol support
- has_skill_file, has_plugin_manifest, has_llms_txt — integration files
- has_agent_protocol, agent_protocol_type — agent protocol support
- billing_model — pay-per-request, subscription, free, etc.
- has_free_tier — boolean
- tags — array of strings
- contact_email — for verification

// example

curl -X POST "https://www.botfriendly.xyz/api/v1/submissions" \
  -H "Content-Type: application/json" \
  -d '{"name":"YourService","url":"https://example.com","category":"browse","description":"What it does"}'

GET/api/v1/health

Health check and endpoint discovery

// example

curl "https://www.botfriendly.xyz/api/v1/health"

>_

API reference for humans and agents

openapi.json mcp.json llms.txt ai-plugin.json health

$ base url

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

// No auth required. CORS enabled (*). JSON responses.

// Rate limits: 100 req/min by IP. With API key (Bearer bf_...): 1,000 req/min.

$ endpoints

GET/api/v1/services

List and filter all services. Returns paginated results with full protocol details.

// parameters

- category — filter by category slug (think, browse, pay, etc.)
- has_mcp=true — only services with MCP servers
- accepts_mpp=true — only services accepting MPP
- accepts_x402=true — only services accepting x402
- has_skill_file=true — only services with skill files
- has_plugin_manifest=true — only services with plugin manifests
- has_llms_txt=true — only services with llms.txt
- has_agent_protocol=true — only services with agent protocol endpoints
- auth_method — filter by auth (api-key, m2m-oauth, bot-token, wallet, x402-none, none)
- search — full-text search across name, description, tags
- min_score — minimum bot-friendly score (1-5)
- sort — score (default), votes, name, newest
- promoted — true for promoted only, false for organic only
- page, per_page — pagination (default 1, 20; max 100)

// example

curl "https://www.botfriendly.xyz/api/v1/services?category=browse&has_mcp=true"

GET/api/v1/services/{slug}

Get full details for a single service including all protocol support, URLs, and metadata.

// example

curl "https://www.botfriendly.xyz/api/v1/services/browserbase"

GET/api/v1/search

Full-text search across services. Returns results ranked by bot_score.

// parameters

- q (required) — search query (supports websearch syntax)
- category — filter by category slug
- page, per_page — pagination (default 1, 20; max 100)

// example

curl "https://www.botfriendly.xyz/api/v1/search?q=vector+database"

GET/api/v1/categories

List all categories with service counts

// example

curl "https://www.botfriendly.xyz/api/v1/categories"

GET/api/v1/featured

Get site-wide promoted/featured services (max 3). Clearly marked as ads.

// example

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

GET/api/v1/protocols

Protocol adoption stats — MCP, OpenAPI, MPP, x402, ACP, UCP

// example

curl "https://www.botfriendly.xyz/api/v1/protocols"

GET/api/v1/stats

Directory statistics — total services, per-category counts, protocol coverage

// example

curl "https://www.botfriendly.xyz/api/v1/stats"

POST/api/v1/submissions

Submit a new service for review. No auth required.

// parameters

- name (required) — service name
- url (required) — service URL
- category (required) — category slug
- description (required) — max 120 chars
- auth_method — api-key, m2m-oauth, bot-token, wallet, x402-none, none
- has_mcp_server, mcp_server_url — MCP server support
- has_openapi_spec, openapi_spec_url — OpenAPI spec support
- accepts_mpp, accepts_x402 — payment protocol support
- has_skill_file, has_plugin_manifest, has_llms_txt — integration files
- has_agent_protocol, agent_protocol_type — agent protocol support
- billing_model — pay-per-request, subscription, free, etc.
- has_free_tier — boolean
- tags — array of strings
- contact_email — for verification

// example

curl -X POST "https://www.botfriendly.xyz/api/v1/submissions" \
  -H "Content-Type: application/json" \
  -d '{"name":"YourService","url":"https://example.com","category":"browse","description":"What it does"}'

GET/api/v1/health

Health check and endpoint discovery

// example

curl "https://www.botfriendly.xyz/api/v1/health"

$ response format

All endpoints return JSON with a consistent envelope:

{
  "ok": true,
  "data": [...],
  "meta": {
    "total": 80,
    "page": 1,
    "per_page": 20,
    "total_pages": 4
  }
}

$ response headers

X-BotFriendly: true

X-API-Version: v1

X-OpenAPI-Spec: /api/v1/openapi.json

X-MCP-Server: /mcp.json

Access-Control-Allow-Origin: *

X-RateLimit-Limit: 100

X-RateLimit-Remaining: 99

X-RateLimit-Reset: 1714000000

$ mcp server

BotFriendly has a remote MCP server that agents can connect to directly. Add it to Claude Desktop, Claude Code, or any MCP-compatible client.

// add to Claude Desktop

Settings → Connectors → Add custom connector:

Name: BotFriendly

URL: https://www.botfriendly.xyz/mcp

// add to Claude Code

claude mcp add botfriendly --transport http https://www.botfriendly.xyz/mcp

// tools

search_services — search and filter the directory

get_service — get full details for a service

get_featured — get site-wide featured services

list_categories — list all categories

submit_service — submit a new service

get_protocol_stats — protocol adoption stats

// Config: /mcp.json · Endpoint: /mcp