> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://platform.bctrl.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://platform.bctrl.ai/_mcp/server.

# MCP

> Give AI clients a generated, authenticated BCTRL Tool catalog.

The hosted BCTRL MCP server gives Claude, Codex, Cursor, and other MCP clients
access to the same public operations, schemas, and permissions as the HTTP API.

```text
https://api.bctrl.ai/mcp
```

The server provides:

* **Discovery tools** to search and inspect the API before acting.
* **Generated operation tools** such as `bctrl_runtimes_list`,
  `bctrl_conversations_create`, and `bctrl_tools_call`.
* **Resources** containing canonical documentation, operation metadata, and
  OpenAPI schemas.
* **OAuth and API-key authentication** enforced as the authenticated API actor.

MCP tools and BCTRL Tools are related but different concepts. `bctrl_tools_call`
is an MCP tool that invokes a BCTRL Tool such as `stagehand.act`,
`captcha.solve`, or `vault.secrets.get`.

## Recommended workflow

1. Search with `bctrl_search_api`.
2. Inspect the operation with `bctrl_get_operation` or
   `operations://{operationId}`.
3. Read referenced schemas before a structured write.
4. Call the generated `bctrl_*` operation tool.
5. Use Runs and ToolCalls to observe or continue asynchronous work.

Start with [Connect a Client](/mcp/clients), then see [Tools](/mcp/tools) and
[Examples](/mcp/examples).