border.bot
Docs menu

API reference

Agents

Agent discovery

Machine-readable files that let AI agents find and use border.bot - llms.txt, Markdown pages, OpenAPI, MCP server card, AI catalog, agent skills and auth.md.

Everything here is public, needs no key and allows cross-origin requests.

Read the docs#

File What it is
/llms.txt Index of the site and docs, with when to use border.bot
/llms-full.txt Every page in one Markdown file
Any page + .md That page as Markdown, e.g. /docs/quickstart.md. Accept: text/markdown works too
https://api.border.bot/llms.txt Index for the API host

Call the API#

File What it is
OpenAPI 3.1 The REST API, machine-readable
API catalog RFC 9727 links to the OpenAPI documents and docs
Agent skill How an agent should use border.bot for landed cost (index)

Connect over MCP#

File What it is
MCP server card Server name, version, transport endpoint and capabilities
MCP tools Every tool with its input schema
AI catalog The MCP server, API and skill as catalog entries

Authenticate#

File What it is
auth.md How an agent gets credentials
Protected resource metadata RFC 9728, for the MCP server
Authorization server metadata RFC 8414

Behaviour agents can rely on#

  • Errors are JSON with a stable code (errors); a missing page returns 404 with a Markdown body when you ask for Markdown.
  • RateLimit-Policy and, on 429, RateLimit and Retry-After (rate limits).
  • Idempotency-Key makes retries free (credits and retries).

Last updated