---
title: "GitBook: agent-ready recipes | Agent Ready Checklist"
description: "Every agent-ready recipe for GitBook: 31 rows of the checklist, the version read, the date and the vendor documentation each step came from."
canonical: https://agentreadychecklist.com/platforms/gitbook
site: "Agent Ready Checklist"
last_updated: 2026-11-05
section: "Platforms"
---

# GitBook: agent-ready recipes | Agent Ready Checklist

> Every agent-ready recipe for GitBook: 31 rows of the checklist, the version read, the date and the vendor documentation each step came from.

Source: https://agentreadychecklist.com/platforms/gitbook
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).

# GitBook: agent-ready recipes

GitBook: 31 recipes against the 31 checklist rows, read on 2026-11-04. GitBook: 20 are direct, 11 are workarounds. GitBook recipes cite the page they were derived from, or the specification when the step is generic. Version read for GitBook: 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

20 direct, 11 workaround, 0 not possible on the platform

robots.txt

No first-party doc: GitBook documents no robots.txt editor. The live gitbook.com/docs/robots.txt (2026-11-04) is User-agent: \*, Allow: /, a Content-Signal line and a Sitemap line. Workaround: serve docs under a subdirectory of your own domain (Cloudflare or Vercel guide) and own the root robots.txt.

Sitemap

[gitbook.com/docs/publish/seo](https://gitbook.com/docs/publish/seo). Sitemap generated for any site not set to unlisted, at /sitemap-pages.xml; /sitemap.xml also returned 200 on 2026-11-04.

Structured data

No first-party doc: No JSON-LD found in a live GitBook page on 2026-11-04 and no doc for adding it. Workaround: inject JSON-LD with a Cloudflare Worker HTMLRewriter in front of a subdirectory deployment.

Status codes

[gitbook.com/docs/publish/seo](https://gitbook.com/docs/publish/seo). Pre-rendered HTML; a missing path on gitbook.com/docs returned 404 on 2026-11-04. Moved pages get automatic HTTP 307 redirects.

Headers and redirects

[gitbook.com/docs/publish/site-redirects](https://gitbook.com/docs/publish/site-redirects). Site redirects from any path; automatic 307 redirects when pages move. No custom response header setting documented.

Content negotiation

[gitbook.com/docs/getting-started/llm-ready-docs](https://gitbook.com/docs/getting-started/llm-ready-docs). Append .md to any page. Live test 2026-11-04: Accept: text/markdown returned content-type text/markdown; charset=utf-8 with Vary including Accept.

llms.txt

[gitbook.com/docs/getting-started/llm-ready-docs](https://gitbook.com/docs/getting-started/llm-ready-docs). llms.txt and llms-full.txt published automatically; hidden pages are included in llms-full.txt.

OpenAPI

[gitbook.com/docs/create-content/openapi](https://gitbook.com/docs/create-content/openapi). Upload an OpenAPI spec or point to a URL to render interactive API blocks; the spec is not documented as republished at /openapi.json.

[The checklist table for GitBook](https://agentreadychecklist.com/platform/gitbook/checklist/) shows every row with its first step.

## Verify with Ora

GitBook has a direct recipe for 20 rows, and Ora's catalogue (read 2026-11-05) names a matching check for 16 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
```

10 rows that Ora checks are a workaround or not possible on GitBook: [AR-FIND-04](https://agentreadychecklist.com/checklist/ar-find-04/) (ai-catalog-published, workaround); [AR-READ-03](https://agentreadychecklist.com/checklist/ar-read-03/) (public-api-docs, workaround); [AR-READ-08](https://agentreadychecklist.com/checklist/ar-read-08/) (json-ld, workaround); [AR-ACT-02](https://agentreadychecklist.com/checklist/ar-act-02/) (openapi-spec, workaround); [AR-ACT-04](https://agentreadychecklist.com/checklist/ar-act-04/) (mcp-server-card, workaround); [AR-ACT-05](https://agentreadychecklist.com/checklist/ar-act-05/) (mcp-app-registry, workaround); [AR-ACT-07](https://agentreadychecklist.com/checklist/ar-act-07/) (webmcp, 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); [CF-AGENT-SKILLS](https://agentreadychecklist.com/checklist/cf-agent-skills/) (agent-skills-index-v2, 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

Default robots.txt allows all agents. Check your own CDN or WAF if the docs sit behind a custom domain proxy.

Read 2026-11-04. [gitbook.com/docs/publish/seo](https://gitbook.com/docs/publish/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 for public sites: sitemap generated. Do not set the site to unlisted, which disables the sitemap.

Read 2026-11-04. [gitbook.com/docs/publish/seo](https://gitbook.com/docs/publish/seo)

### [AR-FIND-04](https://agentreadychecklist.com/checklist/ar-find-04/): AI Catalog at .well-knownworkaround

No ai-catalog.json support documented. Serve docs under a subdirectory through Cloudflare and publish /.well-known/ai-catalog.json from your root domain.

Read 2026-11-04. [gitbook.com/docs/publish/custom-domain/setting-a-custom-subdirectory/configuring-a-subdirectory-with-cloudflare](https://gitbook.com/docs/publish/custom-domain/setting-a-custom-subdirectory/configuring-a-subdirectory-with-cloudflare)

### [AR-READ-01](https://agentreadychecklist.com/checklist/ar-read-01/): Answer in the initial HTMLrecipe

Automatic: GitBook pre-renders HTML server-side, so crawlers do not need JavaScript.

Read 2026-11-04. [gitbook.com/docs/publish/seo](https://gitbook.com/docs/publish/seo)

### [AR-READ-02](https://agentreadychecklist.com/checklist/ar-read-02/): Real HTTP status codesrecipe

Missing paths return 404. Add site redirects for old URLs after a migration; note automatic moves use 307, not 301.

Read 2026-11-04. [gitbook.com/docs/publish/site-redirects](https://gitbook.com/docs/publish/site-redirects)

### [AR-READ-03](https://agentreadychecklist.com/checklist/ar-read-03/): Home page with real linksworkaround

GitBook controls the docs homepage layout. Link product and pricing from the site header links in customization; the main product homepage lives on your own domain.

Read 2026-11-04. [gitbook.com/docs/publish/seo](https://gitbook.com/docs/publish/seo)

### [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

Add a code block and set its syntax to the language (Prism languages); add a caption for the file name.

Read 2026-11-04. [gitbook.com/docs/create-content/blocks/code-block](https://gitbook.com/docs/create-content/blocks/code-block)

### [AR-READ-06](https://agentreadychecklist.com/checklist/ar-read-06/): Link the discovery filesrecipe

Automatic: pages carry <link rel="alternate" type="text/markdown" href="<page>.md"> and the Markdown pages start with a pointer to llms.txt (seen live 2026-11-04). Add a footer link to /llms.txt for HTML readers.

Read 2026-11-04. [gitbook.com/docs/getting-started/llm-ready-docs](https://gitbook.com/docs/getting-started/llm-ready-docs)

### [AR-READ-07](https://agentreadychecklist.com/checklist/ar-read-07/): Ship llms.txtrecipe

Automatic llms.txt at <site>/llms.txt listing every published page with a Markdown version.

Read 2026-11-04. [gitbook.com/docs/getting-started/llm-ready-docs](https://gitbook.com/docs/getting-started/llm-ready-docs)

### [AR-READ-08](https://agentreadychecklist.com/checklist/ar-read-08/): JSON-LD on key pagesworkaround

No JSON-LD output and no head injection documented. Put a Cloudflare Worker with HTMLRewriter in front of a subdirectory deployment and append a <script type="application/ld+json">.

Read 2026-11-04. [gitbook.com/docs/publish/custom-domain/setting-a-custom-subdirectory/configuring-a-subdirectory-with-cloudflare](https://gitbook.com/docs/publish/custom-domain/setting-a-custom-subdirectory/configuring-a-subdirectory-with-cloudflare)

### [AR-READ-09](https://agentreadychecklist.com/checklist/ar-read-09/): Advertise a markdown mirrorrecipe

Automatic <link rel="alternate" type="text/markdown"> on each page and a .md URL for every page.

Read 2026-11-04. [gitbook.com/docs/getting-started/llm-ready-docs](https://gitbook.com/docs/getting-started/llm-ready-docs)

### [AR-READ-11](https://agentreadychecklist.com/checklist/ar-read-11/): Pricing as first-party HTMLrecipe

Write pricing as a normal page with plans in text or a table block; GitBook renders it into the pre-rendered HTML.

Read 2026-11-04. [gitbook.com/docs/publish/seo](https://gitbook.com/docs/publish/seo)

### [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: Fully authenticated sites let MCP clients sign in through MCP discovery and OAuth.

Derived from GitBook's documentation read on 2026-11-04. [gitbook.com/docs/ai-for-your-readers/mcp-servers-for-published-docs](https://gitbook.com/docs/ai-for-your-readers/mcp-servers-for-published-docs) 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 contractworkaround

GitBook renders API blocks from your spec but does not document serving the raw file. Host openapi.json on your API or main domain and link it from a docs page and from llms.txt.

Read 2026-11-04. [gitbook.com/docs/create-content/openapi](https://gitbook.com/docs/create-content/openapi)

### [AR-ACT-03](https://agentreadychecklist.com/checklist/ar-act-03/): MCP over Streamable HTTPrecipe

Automatic MCP server at <site>/~gitbook/mcp (partially authenticated sites: /~gitbook/mcp/auth). Keep Page actions enabled, or the endpoint returns 404.

Read 2026-11-04. [gitbook.com/docs/ai-for-your-readers/mcp-servers-for-published-docs](https://gitbook.com/docs/ai-for-your-readers/mcp-servers-for-published-docs)

### [AR-ACT-04](https://agentreadychecklist.com/checklist/ar-act-04/): MCP server cardworkaround

The documentation read lists no server card for GitBook's MCP endpoint at ~gitbook/mcp. Workaround: serve /.well-known/mcp/server-card.json from your root domain or a proxy, as the AR-FIND-04 recipe does for the catalog (/platforms/gitbook/#ar-find-04).

Derived from GitBook's documentation read on 2026-11-04. [gitbook.com/docs/ai-for-your-readers/mcp-servers-for-published-docs](https://gitbook.com/docs/ai-for-your-readers/mcp-servers-for-published-docs) 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

GitBook generates its docs MCP server itself, at ~gitbook/mcp. 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/gitbook/#ar-act-03).

Derived from GitBook's documentation read on 2026-11-04. [gitbook.com/docs/ai-for-your-readers/mcp-servers-for-published-docs](https://gitbook.com/docs/ai-for-your-readers/mcp-servers-for-published-docs) 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/<cli-name>/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 toolsworkaround

No WebMCP support documented for published sites. Workaround: none inside GitBook; point agents at the ~gitbook/mcp endpoint instead.

Read 2026-11-04. [gitbook.com/docs/ai-for-your-readers/mcp-servers-for-published-docs](https://gitbook.com/docs/ai-for-your-readers/mcp-servers-for-published-docs)

### [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. Not possible on this platform without outside help. 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/gitbook/#ar-act-06). An MCP server also meets it; how GitBook hosts one is in the AR-ACT-03 recipe (/platforms/gitbook/#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

Default robots.txt already contains Content-Signal: ai-train=yes, search=yes, ai-input=yes (live 2026-11-04). To change it, own robots.txt on your root domain via a subdirectory setup.

Read 2026-11-04. [gitbook.com/docs/publish/custom-domain/setting-a-custom-subdirectory/configuring-a-subdirectory-with-cloudflare](https://gitbook.com/docs/publish/custom-domain/setting-a-custom-subdirectory/configuring-a-subdirectory-with-cloudflare)

### [CF-MARKDOWN-NEGOTIATION](https://agentreadychecklist.com/checklist/cf-markdown-negotiation/): Markdown by Acceptrecipe

Automatic: Accept: text/markdown returns the page as text/markdown (tested 2026-11-04 on gitbook.com/docs).

Read 2026-11-04. [gitbook.com/docs/getting-started/llm-ready-docs](https://gitbook.com/docs/getting-started/llm-ready-docs)

### [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 GitBook 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 GitBook 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

Fully authenticated sites let MCP clients sign in through MCP discovery and OAuth.

Read 2026-11-04. [gitbook.com/docs/ai-for-your-readers/mcp-servers-for-published-docs](https://gitbook.com/docs/ai-for-your-readers/mcp-servers-for-published-docs)

### [CF-AGENT-SKILLS](https://agentreadychecklist.com/checklist/cf-agent-skills/): Agent Skills indexworkaround

No agent-skills support is documented for GitBook. Not possible on this platform without outside help. Workaround: publish /.well-known/agent-skills/index.json and the SKILL.md files from your root domain, the same route the AR-FIND-04 recipe takes, and serve the docs under a subdirectory of it.

Generic step from the AgentReady specification; not platform-specific. [isitagentready.com/.well-known/agent-skills/agent-skills/SKILL.md](https://isitagentready.com/.well-known/agent-skills/agent-skills/SKILL.md)

### [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 includes Accept (live 2026-11-04).

Read 2026-11-04. [gitbook.com/docs/getting-started/llm-ready-docs](https://gitbook.com/docs/getting-started/llm-ready-docs)

### [VERCEL-ROBOTS-EXCLUSIONS](https://agentreadychecklist.com/checklist/vercel-robots-exclusions/): Robots exclusionsrecipe

Open the robots.txt that GitBook serves for your site and read every Disallow; each one must have a reason you can state. The live gitbook.com/docs/robots.txt read on 2026-11-04 holds one wildcard group that allows everything, a Content-Signal line and a Sitemap line. GitBook documents no robots.txt editor; to own the file, serve the docs under a subdirectory of your own domain and write the root robots.txt there.

Derived from GitBook's documentation read on 2026-11-04. [gitbook.com/docs/robots.txt](https://gitbook.com/docs/robots.txt) 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

-   [GitBook](https://agentreadychecklist.com/vendors/gitbook/)Docs tool, 6 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
-   [gitbook.com/docs/publish/seo](https://gitbook.com/docs/publish/seo)read 2026-11-04
-   [gitbook.com/docs/publish/site-redirects](https://gitbook.com/docs/publish/site-redirects)read 2026-11-04
-   [gitbook.com/docs/getting-started/llm-ready-docs](https://gitbook.com/docs/getting-started/llm-ready-docs)read 2026-11-04
-   [gitbook.com/docs/create-content/openapi](https://gitbook.com/docs/create-content/openapi)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
-   [gitbook.com/docs/publish/custom-domain/setting-a-custom-subdirectory/configuring-a-subdirectory-with-cloudflare](https://gitbook.com/docs/publish/custom-domain/setting-a-custom-subdirectory/configuring-a-subdirectory-with-cloudflare)read 2026-11-04
-   [gitbook.com/docs/create-content/blocks/code-block](https://gitbook.com/docs/create-content/blocks/code-block)read 2026-11-04
-   [gitbook.com/docs/ai-for-your-readers/mcp-servers-for-published-docs](https://gitbook.com/docs/ai-for-your-readers/mcp-servers-for-published-docs)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
-   [isitagentready.com/.well-known/agent-skills/agent-skills/SKILL.md](https://isitagentready.com/.well-known/agent-skills/agent-skills/SKILL.md)read 2026-11-04
-   [gitbook.com/docs/robots.txt](https://gitbook.com/docs/robots.txt)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 <url> --min-score <n>`

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