Use the Maybloc docs with AI agents and coding assistants

​

How can an AI agent read these docs?

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