reference
Docs
A REST API, a remote MCP server and an OpenAPI spec, for humans reading and agents calling. No key, no account, no paid tier.
The basics
- base url
- https://botfriendly.xyz/api/v1
- auth
- None. There is no key to get.
- cors
- Open to every origin, errors included.
- rate limit
- 100 req/min per IP. /check is 6/min.
note
The API was free and unauthenticated by design and stays that way. There is no paid tier and no key check to work around.
Your first call
Every service with a probed MCP server that also takes x402 payments:
bash
curl "https://botfriendly.xyz/api/v1/services?has_mcp=true&protocol=x402"More of that in the quickstart.
Everything here
API reference
- ConventionsThe response envelope, status codes, headers, CORS and rate limits.
- Services & searchList, filter, search and fetch listings.
- Categories & statsCategories, protocol adoption, directory totals, featured placements and health.
- Check & verifyScore any site, and probe a service's claimed interfaces.
- SubmissionsSubmit a service over the API, and what the gate does with it.