> ## Documentation Index
> Fetch the complete documentation index at: https://docs.maybloc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Use the Maybloc docs with AI agents and coding assistants

> How coding agents and AI assistants can read the Maybloc documentation: llms.txt, Markdown pages, the OpenAPI specification and the docs MCP server.

## How can an AI agent read these docs?

Every page is available as Markdown, and the whole site is indexed for agents:

* **llms.txt:** an index of every page, at `/llms.txt`. The full text of every page is at `/llms-full.txt`.
* **Markdown pages:** add `.md` to any page address, or use the copy and view options in the page menu.
* **OpenAPI:** the machine-readable contract is at [https://app.maybloc.com/openapi.json](https://app.maybloc.com/openapi.json).
* **MCP:** the documentation has a search MCP server, so an agent can search and read pages while it works. Connect it from the page menu.

## What should an agent know before it calls the API?

* The base URL is `https://app.maybloc.com/api/v1` and every request needs `Authorization: Bearer mbk_live_...`.
* Uploads are a three-step flow: create an upload, PUT the file, complete it. Then create the transcript with an `Idempotency-Key`.
* Send `duration_ms`, the recording's length in milliseconds, between 20,000 and 10,800,000.
* Poll the transcript or use a webhook. Read the result only when `status` is `completed`.
* Keys must stay on the server. Never put an API key in client-side code.


## Related topics

- [Maybloc API documentation](https://docs.maybloc.com/index.md)
- [Languages supported by the Maybloc API](https://docs.maybloc.com/guides/languages.md)
- [How to authenticate Maybloc API requests](https://docs.maybloc.com/authentication.md)
- [What does a Maybloc transcript result contain?](https://docs.maybloc.com/guides/results.md)
- [Maybloc API errors, rate limits and idempotency](https://docs.maybloc.com/guides/errors-and-limits.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.