# For AI agents

URL: https://docs.bithuman.ai/resources/agents

> Everything an AI agent needs to read these docs and build with bitHuman: llms.txt, markdown for every page, the docs MCP server, an installable skill, OpenAPI and the data files.

Everything on this site is available in a form an agent can read without parsing HTML.

## Markdown for every page

- Add `.md` to any page's URL: [/platforms/python.md](https://docs.bithuman.ai/platforms/python.md). Each HTML page links its twin with `rel="alternate"`.
- Or ask for markdown: a request with `Accept: text/markdown` gets the same text at the page's own URL.

```bash
curl -H "Accept: text/markdown" https://docs.bithuman.ai/platforms/python
```

## Files

| File | What it holds |
|---|---|
| [/llms.txt](https://docs.bithuman.ai/llms.txt) | The index: rules for agents, where each model runs, key facts, one command per platform, speed, and links |
| [/llms-full.txt](https://docs.bithuman.ai/llms-full.txt) | Getting started, every platform page and the REST API in one file |
| [/llms/start.txt](https://docs.bithuman.ai/llms/start.txt), [/llms/platforms.txt](https://docs.bithuman.ai/llms/platforms.txt), [/llms/deploy.txt](https://docs.bithuman.ai/llms/deploy.txt), [/llms/models.txt](https://docs.bithuman.ai/llms/models.txt), [/llms/build.txt](https://docs.bithuman.ai/llms/build.txt), [/llms/api.txt](https://docs.bithuman.ai/llms/api.txt) | The same text one section at a time |
| [/api/openapi.yaml](https://docs.bithuman.ai/api/openapi.yaml) | The REST API as OpenAPI 3 |
| [/versions.json](https://docs.bithuman.ai/versions.json) | The current version and install line of every artifact |
| [/platforms.json](https://docs.bithuman.ai/platforms.json) | Every way to run bitHuman, with its first command and docs |
| [/performance.json](https://docs.bithuman.ai/performance.json) | The speed of every published configuration (× real time), with hardware, release and date |
| [/changelog.xml](https://docs.bithuman.ai/changelog.xml) | Every release as an RSS feed, tagged by platform |
| [Showcase](https://api.bithuman.ai/v1/models/showcase) | Sample avatars anyone can use: slug, agent code, model |

## Docs MCP

The docs are also an MCP server with two read-only tools: `search` finds pages, and `fetch` returns one as markdown. It needs no account and no key.

| Client | Add it |
|---|---|
| Claude Code | `claude mcp add --transport http bithuman-docs https://docs.bithuman.ai/docs-mcp` |
| Cursor, VS Code and other clients | a remote (Streamable HTTP) server at `https://docs.bithuman.ai/docs-mcp` |

```json
{ "mcpServers": { "bithuman-docs": { "url": "https://docs.bithuman.ai/docs-mcp" } } }
```

To drive bitHuman itself (create agents, render videos) from an MCP client, use the CLI's own server instead: [MCP server](https://docs.bithuman.ai/build/mcp).

## Agent skill

[`bithuman-integrate`](https://docs.bithuman.ai/skills/bithuman-integrate/SKILL.md) is a skill an agent loads before it adds an avatar to a project: it picks the path, installs, wires 16 kHz speech to frames and handles the API secret. Save it as `.claude/skills/bithuman-integrate/SKILL.md` in a project, or `~/.claude/skills/bithuman-integrate/SKILL.md` for every project:

```bash
mkdir -p .claude/skills/bithuman-integrate
curl -fsSL https://docs.bithuman.ai/skills/bithuman-integrate/SKILL.md -o .claude/skills/bithuman-integrate/SKILL.md
```

## Rules for agents

1. Send `model` (`"essence-2"` or `"expression-2"`) on every agent you create, and poll until `status` is `ready` or `failed`.
2. API and SDK use requires the Creator plan or higher.
3. Read the API secret from the environment (`BITHUMAN_API_SECRET`); never write it into code or a command line. In a LiveKit worker, name it `BITHUMAN_MASTER_SECRET` and pass a minted token.
4. Say where things happen: the avatar renders (device, browser, server, cloud); the conversation runs (your stack, the CLI's local conversation brain, or bitHuman's servers).
5. Take versions from [/versions.json](https://docs.bithuman.ai/versions.json), speed from [/performance.json](https://docs.bithuman.ai/performance.json) and prices from `GET https://api.bithuman.ai/v1/pricing`, not from memory or an older sample.

## Next

- [MCP server (the CLI)](https://docs.bithuman.ai/build/mcp) · [Quickstart](https://docs.bithuman.ai/start) · [API reference](https://docs.bithuman.ai/api/reference)