# 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.

Source: https://border.bot/docs/agents
Last updated: 2026-10-09

> Documentation index: https://border.bot/llms.txt. Every page is Markdown at its URL + `.md`.


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

## Read the docs

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

## Call the API

| File                                                                 | What it is                                                                                                |
| -------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- |
| [OpenAPI 3.1](https://api.border.bot/openapi.json)                                  | The REST API, machine-readable                                                                            |
| [API catalog](https://border.bot/.well-known/api-catalog)                       | RFC 9727 links to the OpenAPI documents and docs                                                          |
| [Agent skill](https://border.bot/.well-known/agent-skills/landed-cost/SKILL.md) | How an agent should use border.bot for landed cost ([index](https://border.bot/.well-known/agent-skills/index.json)) |

## Connect over MCP

| File                                                        | What it is                                                |
| ----------------------------------------------------------- | --------------------------------------------------------- |
| [MCP server card](https://border.bot/.well-known/mcp/server-card.json) | Server name, version, transport endpoint and capabilities |
| [MCP tools](https://api.border.bot/mcp/tools.json)                         | Every tool with its input schema                          |
| [AI catalog](https://border.bot/.well-known/ai-catalog.json)           | The MCP server, API and skill as catalog entries          |

## Authenticate

| File                                                                            | What it is                    |
| ------------------------------------------------------------------------------- | ----------------------------- |
| [auth.md](https://border.bot/auth.md)                                                      | How an agent gets credentials |
| [Protected resource metadata](https://border.bot/.well-known/oauth-protected-resource)     | RFC 9728, for the MCP server  |
| [Authorization server metadata](https://api.border.bot/.well-known/oauth-authorization-server) | RFC 8414                      |

## Behaviour agents can rely on

- Errors are JSON with a stable `code` ([errors](https://border.bot/docs/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](https://border.bot/docs/rate-limits)).
- `Idempotency-Key` makes retries free ([credits and retries](https://border.bot/docs/credits)).