--- title: "Mintlify: agent-ready recipes | Agent Ready Checklist" description: "Every agent-ready recipe for Mintlify: 31 rows of the checklist, the version read, the date and the vendor documentation each step came from." canonical: https://agentreadychecklist.com/platforms/mintlify site: "Agent Ready Checklist" last_updated: 2026-11-05 section: "Platforms" --- # Mintlify: agent-ready recipes | Agent Ready Checklist > Every agent-ready recipe for Mintlify: 31 rows of the checklist, the version read, the date and the vendor documentation each step came from. Source: https://agentreadychecklist.com/platforms/mintlify Site: Agent Ready Checklist Last reviewed: 2026-11-05 Agent endpoints: https://agentreadychecklist.com/llms.txt (index), https://agentreadychecklist.com/openapi.json (API), https://agentreadychecklist.com/mcp (MCP server), https://agentreadychecklist.com/ask (search) Access: https://agentreadychecklist.com/auth.md (no key). Pricing: https://agentreadychecklist.com/pricing.md (free). # Mintlify: agent-ready recipes Mintlify: 31 recipes against the 31 checklist rows, read on 2026-11-04. Mintlify: 26 are direct, 5 are workarounds. Mintlify recipes cite the page they were derived from, or the specification when the step is generic. Version read for Mintlify: Hosted SaaS, docs read 2026-11-04. ## Version and documentation read Version Hosted SaaS, docs read 2026-11-04 Read on 2026-11-04 Recipes 26 direct, 5 workaround, 0 not possible on the platform robots.txt [mintlify.com/docs/optimize/seo](https://mintlify.com/docs/optimize/seo). robots.txt is generated and includes Content-Signal directives; a robots.txt at the project root overrides it. Sitemap [mintlify.com/docs/optimize/seo](https://mintlify.com/docs/optimize/seo). sitemap.xml is generated; a sitemap.xml at the project root overrides it. Structured data [mintlify.com/docs/optimize/seo](https://mintlify.com/docs/optimize/seo). JSON-LD added to every indexable page from frontmatter and docs.json; seo.organization controls the publisher entity. 2 JSON-LD blocks seen on a live page 2026-11-04. Status codes [mintlify.com/docs/ai/markdown-export](https://mintlify.com/docs/ai/markdown-export). Missing .md pages return 404 with a Markdown body linking llms.txt; a missing HTML path returned 404 on 2026-11-04. Headers and redirects [mintlify.com/docs/create/redirects](https://mintlify.com/docs/create/redirects). redirects array in docs.json; permanent (308) by default, 307 with permanent: false. Content negotiation [mintlify.com/docs/ai/markdown-export](https://mintlify.com/docs/ai/markdown-export). Accept: text/markdown or text/plain returns Markdown; .md suffix also works; known AI agent UAs get Markdown at the normal URL. Live response 2026-11-04: content-type text/markdown; charset=utf-8, vary: accept-encoding, Accept, User-Agent. llms.txt [mintlify.com/docs/ai/llmstxt](https://mintlify.com/docs/ai/llmstxt). llms.txt and llms-full.txt generated and hosted; also at /.well-known/llms.txt; Link and X-Llms-Txt headers on every response. OpenAPI [mintlify.com/docs/api-playground/openapi-setup](https://mintlify.com/docs/api-playground/openapi-setup). OpenAPI files referenced from docs.json; download-spec option in contextual menu; API catalog at /.well-known/api-catalog. [The checklist table for Mintlify](https://agentreadychecklist.com/platform/mintlify/checklist/) shows every row with its first step. ## Verify with Ora Mintlify has a direct recipe for 26 rows, and Ora's catalogue (read 2026-11-05) names a matching check for 22 of them, among them AR-FIND-01, AR-FIND-03, AR-READ-01. After the steps are live, one audit shows which of those fixes the score picks up. ```bash npx ax@0.10 audit https://example.com --min-score 70 ``` 4 rows that Ora checks are a workaround or not possible on Mintlify: [AR-FIND-04](https://agentreadychecklist.com/checklist/ar-find-04/) (ai-catalog-published, workaround); [AR-ACT-05](https://agentreadychecklist.com/checklist/ar-act-05/) (mcp-app-registry, workaround); [AR-ACT-08](https://agentreadychecklist.com/checklist/ar-act-08/) (x402-support, workaround); [AR-ACT-09](https://agentreadychecklist.com/checklist/ar-act-09/) (nlweb-ask, workaround). Ora scores the site as it stands, so a row the platform cannot satisfy stays open until the workaround is in place. Run it again with `--force` after a deploy, so the audit skips Ora's cache. [Gate deploys on it in CI](https://agentreadychecklist.com/guides/gate-deploys-on-agent-readiness-in-ci/), [why this site recommends Ora](https://agentreadychecklist.com/verify-with-ora/), [the crosswalk of rows and checks](https://agentreadychecklist.com/checklist/ora-checks/). ## Recipes, row by row ### [AR-FIND-01](https://agentreadychecklist.com/checklist/ar-find-01/): Do not block agentsrecipe Keep the generated robots.txt. If you add a custom robots.txt at the project root, do not block GPTBot, ClaudeBot or PerplexityBot. Fully authenticated sites redirect robots.txt to login, so keep public docs public. Read 2026-11-04. [mintlify.com/docs/optimize/seo](https://mintlify.com/docs/optimize/seo) ### [AR-FIND-02](https://agentreadychecklist.com/checklist/ar-find-02/): Answers on one first-party pagerecipe Publish each answer once, as a page on your own domain. Put the fact (price, limit, version) in the page text, give the page one stable address, and link it from the home page and from llms.txt. Keep the page current: a second, older copy elsewhere on the site is the usual way an agent cites the wrong figure. Generic step from the AgentReady specification; not platform-specific. [github.com/agentready-org/standard/blob/main/spec/spec.md](https://github.com/agentready-org/standard/blob/main/spec/spec.md) ### [AR-FIND-03](https://agentreadychecklist.com/checklist/ar-find-03/): Sitemap listed in robots.txtrecipe Nothing to do: sitemap.xml is generated and referenced. To override, commit sitemap.xml at the project root. Read 2026-11-04. [mintlify.com/docs/optimize/seo](https://mintlify.com/docs/optimize/seo) ### [AR-FIND-04](https://agentreadychecklist.com/checklist/ar-find-04/): AI Catalog at .well-knownworkaround No generated ai-catalog.json (/.well-known/ai-catalog.json returned 404 on www.mintlify.com, 2026-11-04). Serve one from your reverse proxy or a Worker on the docs domain. Read 2026-11-04. [mintlify.com/docs/deploy/reverse-proxy](https://mintlify.com/docs/deploy/reverse-proxy) ### [AR-READ-01](https://agentreadychecklist.com/checklist/ar-read-01/): Answer in the initial HTMLrecipe Pages are server-rendered; a plain curl of a docs page returned the body text in the initial HTML on 2026-11-04. Keep answers in MDX text, not inside interactive components only. Read 2026-11-04. [mintlify.com/docs/optimize/seo](https://mintlify.com/docs/optimize/seo) ### [AR-READ-02](https://agentreadychecklist.com/checklist/ar-read-02/): Real HTTP status codesrecipe Missing paths return 404; missing .md paths return 404 with a Markdown recovery body. Set redirects for moved pages in docs.json so old URLs do not 404. Read 2026-11-04. [mintlify.com/docs/ai/markdown-export](https://mintlify.com/docs/ai/markdown-export) ### [AR-READ-03](https://agentreadychecklist.com/checklist/ar-read-03/): Home page with real linksrecipe Put docs, product and pricing links in the docs.json navbar and footer; they render as real links in the HTML. Read 2026-11-04. [mintlify.com/docs/organize/pages](https://mintlify.com/docs/organize/pages) ### [AR-READ-04](https://agentreadychecklist.com/checklist/ar-read-04/): Docs that answer agent tasksrecipe For each of your top five agent tasks, write a page that holds the steps as text, in order, with the exact names of the buttons, fields and settings. Steps that exist only in an image, a video or a script-built widget are not in the response a plain fetch receives. Fetch the page with curl and grep for the step. Generic step from the AgentReady specification; not platform-specific. [github.com/agentready-org/standard/blob/main/spec/spec.md](https://github.com/agentready-org/standard/blob/main/spec/spec.md) ### [AR-READ-05](https://agentreadychecklist.com/checklist/ar-read-05/): Fenced, language-tagged coderecipe Fence code with a language and optional title: \`\`\`java HelloWorld.java. The language enables highlighting and meta options. Read 2026-11-04. [mintlify.com/docs/create/code](https://mintlify.com/docs/create/code) ### [AR-READ-06](https://agentreadychecklist.com/checklist/ar-read-06/): Link the discovery filesrecipe Automatic: every response carries Link: ; rel="llms-txt", ; rel="llms-full-txt", api-catalog, mcp-server-card, agent-card and agent-skills relations, plus X-Llms-Txt: /llms.txt. Read 2026-11-04. [mintlify.com/docs/ai/llmstxt](https://mintlify.com/docs/ai/llmstxt) ### [AR-READ-07](https://agentreadychecklist.com/checklist/ar-read-07/): Ship llms.txtrecipe Automatic llms.txt and llms-full.txt from docs.json navigation; set description in docs.json for the blockquote. Commit llms.txt at the root to replace it. Read 2026-11-04. [mintlify.com/docs/ai/llmstxt](https://mintlify.com/docs/ai/llmstxt) ### [AR-READ-08](https://agentreadychecklist.com/checklist/ar-read-08/): JSON-LD on key pagesrecipe Automatic JSON-LD on every indexable page. Set seo.organization in docs.json for publisher @id, legal name, logo and sameAs. Read 2026-11-04. [mintlify.com/docs/optimize/seo](https://mintlify.com/docs/optimize/seo) ### [AR-READ-09](https://agentreadychecklist.com/checklist/ar-read-09/): Advertise a markdown mirrorrecipe Automatic: pages carry (seen live 2026-11-04) and every page is available with a .md suffix. Read 2026-11-04. [mintlify.com/docs/ai/markdown-export](https://mintlify.com/docs/ai/markdown-export) ### [AR-READ-11](https://agentreadychecklist.com/checklist/ar-read-11/): Pricing as first-party HTMLrecipe Write pricing as an MDX page with plans and limits in text or tables; avoid putting the only numbers in images. Read 2026-11-04. [mintlify.com/docs/organize/pages](https://mintlify.com/docs/organize/pages) ### [AR-ACT-01](https://agentreadychecklist.com/checklist/ar-act-01/): Auth an agent can finishrecipe For docs behind sign-in, the platform's own OAuth route applies: Sites with authentication advertise OAuth protected resource metadata with rel="oauth-protected-resource" in the Link header; the authed MCP uses OAuth 2. Derived from Mintlify's documentation read on 2026-11-04. [mintlify.com/docs/ai/llmstxt](https://mintlify.com/docs/ai/llmstxt) and [github.com/agentready-org/standard/blob/main/spec/spec.md](https://github.com/agentready-org/standard/blob/main/spec/spec.md) ### [AR-ACT-02](https://agentreadychecklist.com/checklist/ar-act-02/): OpenAPI contractrecipe Commit openapi.json and reference it in docs.json ("openapi": "openapi.json"); add "download-spec" to contextual.options so readers and agents can fetch it. Read 2026-11-04. [mintlify.com/docs/api-playground/openapi-setup](https://mintlify.com/docs/api-playground/openapi-setup) ### [AR-ACT-03](https://agentreadychecklist.com/checklist/ar-act-03/): MCP over Streamable HTTPrecipe Automatic search MCP server at /mcp (authed sites: /authed/mcp), with discovery at /.well-known/mcp and /.well-known/mcp.json and a server card at /.well-known/mcp/server-card.json. Read 2026-11-04. [mintlify.com/docs/ai/model-context-protocol](https://mintlify.com/docs/ai/model-context-protocol) ### [AR-ACT-04](https://agentreadychecklist.com/checklist/ar-act-04/): MCP server cardrecipe Mintlify generates the server card for its automatic MCP server at /.well-known/mcp/server-card.json (its AR-ACT-03 recipe); there is nothing to write. A card for a server of your own would sit beside it. Derived from Mintlify's documentation read on 2026-11-04. [mintlify.com/docs/ai/model-context-protocol](https://mintlify.com/docs/ai/model-context-protocol) and [github.com/agentready-org/standard/blob/main/spec/spec.md](https://github.com/agentready-org/standard/blob/main/spec/spec.md) ### [AR-ACT-05](https://agentreadychecklist.com/checklist/ar-act-05/): MCP Apps viewworkaround Mintlify generates the docs MCP server itself. The documentation read lists no built-in feature for this row. Workaround: serve the ui:// resource from an MCP server you run on a subdomain or API domain you control (the AR-ACT-03 recipe, /platforms/mintlify/#ar-act-03). Derived from Mintlify's documentation read on 2026-11-04. [mintlify.com/docs/ai/model-context-protocol](https://mintlify.com/docs/ai/model-context-protocol) and [github.com/agentready-org/standard/blob/main/spec/spec.md](https://github.com/agentready-org/standard/blob/main/spec/spec.md) ### [AR-ACT-06](https://agentreadychecklist.com/checklist/ar-act-06/): SDKs and a CLIrecipe Publish the SDK and the CLI from the product's own repository to npm or PyPI; the website platform is not involved. Then show the install command and a first call on a page of your own site so that agents reading the site find them. Verify with curl -s https://registry.npmjs.org//latest. Generic step from the AgentReady specification; not platform-specific. [github.com/agentready-org/standard/blob/main/spec/spec.md](https://github.com/agentready-org/standard/blob/main/spec/spec.md) ### [AR-ACT-07](https://agentreadychecklist.com/checklist/ar-act-07/): WebMCP toolsrecipe WebMCP on Pro or Enterprise plans registers search\_docs, read\_page, get\_site\_overview, read\_skill and more on navigator.modelContext. Read 2026-11-04. [mintlify.com/docs/ai/model-context-protocol](https://mintlify.com/docs/ai/model-context-protocol) ### [AR-ACT-08](https://agentreadychecklist.com/checklist/ar-act-08/): Agent paymentsworkaround The documentation read lists no built-in feature for this row. Not possible on this platform without outside help. Workaround: run the paid endpoint on a subdomain or API domain you control, returning HTTP 402 with a payment payload on the paid path only (x402 or MPP), or a checkout handler, and link it from the docs. Put no CAPTCHA in front of a verified agent. Generic step from the AgentReady specification; not platform-specific. [github.com/agentready-org/standard/blob/main/spec/spec.md](https://github.com/agentready-org/standard/blob/main/spec/spec.md) ### [AR-ACT-09](https://agentreadychecklist.com/checklist/ar-act-09/): NLWeb /ask endpointworkaround The documentation read lists no built-in feature for this row. The documentation read lists no built-in feature for this row. Workaround: run the /ask endpoint on a subdomain or API domain you control, returning schema.org-shaped JSON for the query parameter, and link it from the docs. Mirror the same ask tool over MCP. Generic step from the AgentReady specification; not platform-specific. [github.com/agentready-org/standard/blob/main/spec/spec.md](https://github.com/agentready-org/standard/blob/main/spec/spec.md) ### [AR-ACT-10](https://agentreadychecklist.com/checklist/ar-act-10/): An MCP server or a CLIrecipe A CLI meets AR-ACT-10 on any platform: publish it as described in the AR-ACT-06 recipe (/platforms/mintlify/#ar-act-06). An MCP server also meets it; how Mintlify hosts one is in the AR-ACT-03 recipe (/platforms/mintlify/#ar-act-03). Do not ship an empty surface to tick the box. Generic step from the AgentReady specification; not platform-specific. [github.com/agentready-org/standard/blob/main/spec/spec.md](https://github.com/agentready-org/standard/blob/main/spec/spec.md) ### [CF-CONTENT-SIGNALS](https://agentreadychecklist.com/checklist/cf-content-signals/): Content-Signal linerecipe Automatic Content-Signal directives in the generated robots.txt; change them by committing a custom robots.txt. Read 2026-11-04. [mintlify.com/docs/optimize/seo](https://mintlify.com/docs/optimize/seo) ### [CF-MARKDOWN-NEGOTIATION](https://agentreadychecklist.com/checklist/cf-markdown-negotiation/): Markdown by Acceptrecipe Automatic: curl -H 'Accept: text/markdown' https:/// returns text/markdown. Read 2026-11-04. [mintlify.com/docs/ai/markdown-export](https://mintlify.com/docs/ai/markdown-export) ### [CF-PAY-PER-CRAWL](https://agentreadychecklist.com/checklist/cf-pay-per-crawl/): Pay per crawl, HTTP 402workaround Pay per crawl is a feature of Cloudflare AI Crawl Control, set per Cloudflare zone and in closed beta on 2026-11-04, so Mintlify does not set it, and a crawler is answered 402 only on a zone that has it. Not possible on this platform without outside help. Workaround: put the domain on a Cloudflare zone, where Mintlify allows a proxy or custom DNS in front, and set the price there. Test with curl -A "GPTBot/1.0". Derived from Cloudflare's pay per crawl documentation read on 2026-11-04. [developers.cloudflare.com/ai-crawl-control/features/pay-per-crawl/what-is-pay-per-crawl/](https://developers.cloudflare.com/ai-crawl-control/features/pay-per-crawl/what-is-pay-per-crawl/) and [developers.cloudflare.com/ai-crawl-control/features/pay-per-crawl/what-is-pay-per-crawl/](https://developers.cloudflare.com/ai-crawl-control/features/pay-per-crawl/what-is-pay-per-crawl/) ### [CF-OAUTH-DISCOVERY](https://agentreadychecklist.com/checklist/cf-oauth-discovery/): OAuth discovery filesrecipe Sites with authentication advertise OAuth protected resource metadata with rel="oauth-protected-resource" in the Link header; the authed MCP uses OAuth 2. Read 2026-11-04. [mintlify.com/docs/ai/llmstxt](https://mintlify.com/docs/ai/llmstxt) ### [CF-AGENT-SKILLS](https://agentreadychecklist.com/checklist/cf-agent-skills/): Agent Skills indexrecipe Automatic skill.md and an agent-skills index (live at /docs/.well-known/agent-skills/index.json, 2026-11-04). Behind a reverse proxy, route /.well-known/skills/\* to the Mintlify origin. Read 2026-11-04. [mintlify.com/docs/ai/skillmd](https://mintlify.com/docs/ai/skillmd) ### [VERCEL-NEGOTIATION-HEADERS](https://agentreadychecklist.com/checklist/vercel-negotiation-headers/): Markdown headersrecipe Automatic: markdown responses carry content-type: text/markdown; charset=utf-8 and Vary including Accept (and User-Agent). Read 2026-11-04. [mintlify.com/docs/ai/markdown-export](https://mintlify.com/docs/ai/markdown-export) ### [VERCEL-ROBOTS-EXCLUSIONS](https://agentreadychecklist.com/checklist/vercel-robots-exclusions/): Robots exclusionsrecipe Open the robots.txt that Mintlify serves for your site and read every Disallow; each one must have a reason you can state. How the file is produced here: robots.txt is generated and includes Content-Signal directives; a robots.txt at the project root overrides it. Derived from Mintlify's documentation read on 2026-11-04. [mintlify.com/docs/optimize/seo](https://mintlify.com/docs/optimize/seo) and [vercel.com/kb/guide/make-your-site-readable-by-ai-agents](https://vercel.com/kb/guide/make-your-site-readable-by-ai-agents) ## Vendors on this platform - [Mintlify](https://agentreadychecklist.com/vendors/mintlify/)Docs tool, 7 of 9 checklist rows read met by default ## Sources - [ora.ai/api/checks, contract 1.38.0](https://ora.ai/api/checks?utm_source=agentreadychecklist.com&utm_medium=referral&utm_campaign=platform)read 2026-11-05 - [registry.npmjs.org/ax, the ax README](https://registry.npmjs.org/ax)read 2026-11-05 - [mintlify.com/docs/optimize/seo](https://mintlify.com/docs/optimize/seo)read 2026-11-04 - [mintlify.com/docs/ai/markdown-export](https://mintlify.com/docs/ai/markdown-export)read 2026-11-04 - [mintlify.com/docs/create/redirects](https://mintlify.com/docs/create/redirects)read 2026-11-04 - [mintlify.com/docs/ai/llmstxt](https://mintlify.com/docs/ai/llmstxt)read 2026-11-04 - [mintlify.com/docs/api-playground/openapi-setup](https://mintlify.com/docs/api-playground/openapi-setup)read 2026-11-04 - [github.com/agentready-org/standard/blob/main/spec/spec.md](https://github.com/agentready-org/standard/blob/main/spec/spec.md)read 2026-11-04 - [mintlify.com/docs/deploy/reverse-proxy](https://mintlify.com/docs/deploy/reverse-proxy)read 2026-11-04 - [mintlify.com/docs/organize/pages](https://mintlify.com/docs/organize/pages)read 2026-11-04 - [mintlify.com/docs/create/code](https://mintlify.com/docs/create/code)read 2026-11-04 - [mintlify.com/docs/ai/model-context-protocol](https://mintlify.com/docs/ai/model-context-protocol)read 2026-11-04 - [developers.cloudflare.com/ai-crawl-control/features/pay-per-crawl/what-is-pay-per-crawl/](https://developers.cloudflare.com/ai-crawl-control/features/pay-per-crawl/what-is-pay-per-crawl/)read 2026-11-04 - [mintlify.com/docs/ai/skillmd](https://mintlify.com/docs/ai/skillmd)read 2026-11-04 - [vercel.com/kb/guide/make-your-site-readable-by-ai-agents](https://vercel.com/kb/guide/make-your-site-readable-by-ai-agents)read 2026-11-04 Edition Data 2026-11-04 Reviewed 2026-11-05 Spec AgentReady v2.0, 273d2d7 Crawl 13,071 rows, 2026-11-04 Ora 132 checks, contract 1.38.0, 2026-11-05 Verify with Ora The scanner this site recommends for the whole checklist. 132 checks, a score out of 100, no account. `npx ax@0.10 audit --min-score ` [Why Ora, and its limits](https://agentreadychecklist.com/verify-with-ora/) Method - [How rows, commands and rates are made](https://agentreadychecklist.com/method/) - [How an Ora check is matched to a row](https://agentreadychecklist.com/checklist/ora-checks/) - [Pass rates by rank band](https://agentreadychecklist.com/data/by-rank/) Sources and read dates sit at the foot of the page. Last reviewed 2026-11-05. AgentReady v2.0, read 2026-11-04.