Built-in Mintlify LLM Surfaces
Mintlify already exposes LLM-friendly formats:| Surface | What it provides |
|---|---|
/llms.txt | Compact index of available docs pages for model crawlers |
/llms-full.txt | Expanded combined content export |
<page>.md | Markdown rendering for any docs page URL |
/prompt.txt / /skill.md | Optional prompt/skill context files when configured |
Grounding Docs in Code
The reliability requirement is drift control: docs should be generated from source, not hand-maintained. For OrgX cloud MCP tools:Code/orgx-openclaw-plugin/src/tools/core-tools.tsCode/orgx-openclaw-plugin/src/mcp-http-handler.ts
docs/mintlify/generated/openclaw-plugin-tool-catalog.jsondocs/mintlify/api/openclaw-plugin-mcp-tools.mdx
Recommended LLM-Ready Workflow
- Regenerate catalogs before each docs release.
- Commit generated outputs with timestamps.
- Run broken-link checks:
- Spot-check
.mdvariants for key pages (for example/api/mcp-tools.md). - Verify
llms.txtandllms-full.txtinclude newly added pages after deploy.
Copy-to-LLM for Every Page
For end users, the simplest “copy to LLM” path is:- open the page in docs
- append
.mdto the URL - copy the markdown output
- Docs page:
/api/openclaw-plugin-mcp-tools - LLM-ready variant:
/api/openclaw-plugin-mcp-tools.md
