LLM and MCP Readiness
Voicetta documentation is designed to be readable by humans and by LLMs.
Why it matters for your business
- Save money: accurate crawler-readable docs reduce repeated support and sales explanations.
- Work faster: humans and robots can retrieve the same setup guidance.
- Standardize service: public docs become the shared source for app behavior and Guest language.
- Delight every Guest: teams and AI tools learn the same Guest-first operating standard.
The goal is simple:
- Humans should get a clean documentation experience.
- LLMs should get stable Markdown.
- Crawlers should discover docs through sitemap and
llms.txt. - External agents can provision Voicetta through the Setup API and MCP.
Markdown Access
Every public documentation page should have a Markdown version:
- HTML:
/docs/:slug - Markdown:
/docs/:slug.md
The full documentation bundle is available as Markdown:
/docs.md
The LLM discovery file is:
/llms.txt
Sitemap
Sitemap is the primary discovery mechanism.
The sitemap should include:
/docs/docs/:slug/docs.mdwhen full Markdown should be discoverable
Individual .md pages may also be included if we want search engines and AI crawlers to discover them directly.
llms.txt
llms.txt should list the most useful Markdown resources:
- Full documentation Markdown
- Documentation index
- Changelog
- Release notes
- Agent tools
- Setup API playbook and OpenAPI
- MCP setup package
Terminology bridge
| Human UI | Agent API | After enable |
|---|---|---|
| Connection | Setup Tool (tool_id) | Capability |
See Glossary and Agent Setup Playbook.
MCP and Setup API (live)
Voicetta Setup provisioning is available today:
| Surface | Location |
|---|---|
| Setup API | https://api.voicetta.com/v1/setup/* |
| OpenAPI | https://voicetta.com/setup-openapi.json |
| MCP package | @voicetta/setup-mcp |
| Playbook | Agent Setup Playbook |
| Host guides | Setup Host Guides |
MCP is a transport adapter — one MCP tool maps to one Setup API endpoint. ChatGPT and other hosts can use the same OpenAPI spec without MCP.
Rule
Do not document a tool as available unless Voicetta can actually perform the action.