Skip to content
ProductArena

How GitBook’s scores are calculated

The full audit trail, recomputed from the verdict data at build time through the same code that produced the leaderboard: verdict × quality × story weight per cell, cells sum to dimension scores, dimensions blend into the PA Score. Every number on the product page is reproducible from this page alone; for why the formula looks like this, see the methodology.

verdict factors: full ×1.0 · partial ×0.6 · disputed ×0.3 · none ×0.0 · n/a excluded from both sides · cell points = weight × quality × factor · cell max = weight × 10

PA Score32/100

Agent-ready 40.0 × 0.30 = 12.00

API quality 23.3 × 0.20 = 4.66

Openness 16.2 × 0.20 = 3.24

Built-in AI 63.3 × 0.15 = 9.49

Automation 15.0 × 0.15 = 2.25

(12.00 + 4.66 + 3.24 + 9.49 + 2.25) ÷ (0.30 + 0.20 + 0.20 + 0.15 + 0.15) = 31.64 ÷ 1.00 = 31.6

Scores are stored to 1 decimal; the product page’s pills round to whole numbers for display. Each dimension below shows the stories, verdicts, and cited evidence behind its number.

Agent-ready40.0/100×0.30 of the PA blend

Outside-in: can YOUR agent reach and drive this product — API, MCP, CLI, headless runs, agent docs.

Point an agent at llms.txt or agent-oriented docsweight 2

2 (weight) × 8 (quality) × 1.0 (full) = 16.0 of 20 max

  • [probe] https://gitbook.com/llms.txt“PROBE llms.txt: HTTP 200 at https://gitbook.com/llms.txt # GitBook > GitBook is a collaborative platform for creating, publishing and managing > **Product Documentation** and *”
  • [claimed-docs] https://gitbook.com/docs/getting-started/llm-ready-docs“LLM-ready docs”
  • [claimed-docs] https://gitbook.com/docs/llms-full.txt“Write in the editor, drive it from your agent, or sync from Git.”
  • [claimed-docs] https://gitbook.com/agent-score“See how easily AI agents can reach, parse, and use your documentation.”
  • [claimed-docs] https://gitbook.com/docs/ai-for-your-readers/mcp-servers-for-published-docs“MCP servers for published docs”
  • [probe] https://gitbook.com/docs.md“PROBE docs-md: HTTP 404 at https://gitbook.com/docs.md”

Run the product headlessly / in CI for automationweight 2

2 (weight) × 5 (quality) × 0.6 (partial) = 6.0 of 20 max

  • [claimed-docs] https://gitbook.com/docs/docs-as-code/gitbook-cli“GitBook CLI”
  • [claimed-docs] https://gitbook.com/docs/docs-as-code/gitbook-cli.md“list organizations, inspect spaces and pages, ask questions against your docs, and build and publish integrations — all without leaving the shell”
  • [claimed-docs] https://gitbook.com/docs/docs-as-code/git-sync“GitHub & GitLab Sync”
  • [claimed-docs] https://gitbook.com/docs/developers/gitbook-api/api-reference.md“This API is RESTful and supports standard HTTP methods like GET, POST, PATCH, and DELETE.”
  • [community] https://hn.algolia.com/api/v1/items/23659451“GitBook README cited as reason for community fork: 'As the efforts of the GitBook team are focused on the GitBook.com platform, the CLI is no longer under active development.'”

Plug MCP servers into this product so it can use their toolsweight 3

3 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 30 max

  • [claimed-docs] https://gitbook.com/docs“New: The GitBook MCP server is here. Connect your AI agent”
  • [claimed-docs] https://gitbook.com/docs/ai-for-your-readers/mcp-servers-for-published-docs“MCP servers for published docs”
  • [claimed-docs] https://gitbook.com/docs/docs-as-code/gitbook-mcp.md“Tools like Claude Code, Codex, Cursor, and other MCP clients can use it to create and configure sites, open change requests, draft content, edit pages, and restructure docs.”
  • [probe] https://gitbook.com/docs/docs-as-code/gitbook-mcp“official MCP server documented at https://gitbook.com/docs/docs-as-code/gitbook-mcp”

Connect an agent via an official MCP serverweight 3

3 (weight) × 8 (quality) × 1.0 (full) = 24.0 of 30 max

  • [claimed-docs] https://gitbook.com/docs“New: The GitBook MCP server is here. Connect your AI agent”
  • [claimed-docs] https://gitbook.com/docs/ai-for-your-readers/mcp-servers-for-published-docs“MCP servers for published docs”
  • [claimed-docs] https://gitbook.com/docs/docs-as-code/gitbook-mcp.md“Tools like Claude Code, Codex, Cursor, and other MCP clients can use it to create and configure sites, open change requests, draft content, edit pages, and restructure docs.”
  • [probe] https://gitbook.com/docs/docs-as-code/gitbook-mcp“official MCP server documented at https://gitbook.com/docs/docs-as-code/gitbook-mcp”

Use an official CLIweight 2

2 (weight) × 7 (quality) × 1.0 (full) = 14.0 of 20 max

  • [claimed-docs] https://gitbook.com/docs/docs-as-code/gitbook-cli“GitBook CLI”
  • [claimed-docs] https://gitbook.com/docs/docs-as-code/gitbook-cli.md“list organizations, inspect spaces and pages, ask questions against your docs, and build and publish integrations — all without leaving the shell”
  • [claimed-docs] https://gitbook.com/docs/docs-as-code/gitbook-mcp.md“Tools like Claude Code, Codex, Cursor, and other MCP clients can use it to create and configure sites, open change requests, draft content, edit pages, and restructure docs.”

Drive the product through a documented public APIweight 3

3 (weight) × 8 (quality) × 1.0 (full) = 24.0 of 30 max

  • [claimed-docs] https://gitbook.com/docs/developers/gitbook-api/api-reference.md“This API is RESTful and supports standard HTTP methods like GET, POST, PATCH, and DELETE.”
  • [claimed-docs] https://gitbook.com/docs/docs-as-code/gitbook-cli“GitBook CLI”
  • [claimed-docs] https://gitbook.com/docs/docs-as-code/gitbook-cli.md“list organizations, inspect spaces and pages, ask questions against your docs, and build and publish integrations — all without leaving the shell”
  • [claimed-docs] https://gitbook.com/docs“New: The GitBook MCP server is here. Connect your AI agent”
  • [claimed-docs] https://gitbook.com/docs/docs-as-code/gitbook-mcp.md“Tools like Claude Code, Codex, Cursor, and other MCP clients can use it to create and configure sites, open change requests, draft content, edit pages, and restructure docs.”
  • [probe] https://gitbook.com/docs/docs-as-code/gitbook-mcp“official MCP server documented at https://gitbook.com/docs/docs-as-code/gitbook-mcp”
  • [probe] https://gitbook.com/openapi.json“PROBE openapi: all candidate paths 404 (https://gitbook.com/openapi.json, https://gitbook.com/swagger.json, https://gitbook.com/api/openapi.json, https://gitbook.com/.well-known/openapi.json)”

Issue scoped/least-privilege API credentials for an agentweight 2

2 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 20 max

  • [claimed-docs] https://gitbook.com/docs/developers/gitbook-api/api-reference.md“This API is RESTful and supports standard HTTP methods like GET, POST, PATCH, and DELETE.”
  • [claimed-docs] https://gitbook.com/docs/docs-as-code/gitbook-mcp.md“Tools like Claude Code, Codex, Cursor, and other MCP clients can use it to create and configure sites, open change requests, draft content, edit pages, and restructure docs.”
  • [claimed-docs] https://gitbook.com/docs/publish/site-audience/authenticated-access“Authenticated access”

Build against official SDKsweight 2

2 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 20 max

  • [claimed-docs] https://gitbook.com/docs/developers/gitbook-api/api-reference.md“This API is RESTful and supports standard HTTP methods like GET, POST, PATCH, and DELETE.”
  • [claimed-docs] https://gitbook.com/docs/docs-as-code/gitbook-cli“GitBook CLI”
  • [claimed-docs] https://gitbook.com/docs/docs-as-code/gitbook-cli.md“list organizations, inspect spaces and pages, ask questions against your docs, and build and publish integrations — all without leaving the shell”

Subscribe to events via webhooksweight 2

2 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 20 max

  • [claimed-docs] https://gitbook.com/docs/developers/gitbook-api/api-reference.md“This API is RESTful and supports standard HTTP methods like GET, POST, PATCH, and DELETE.”
  • [probe] https://gitbook.com/openapi.json“PROBE openapi: all candidate paths 404 (https://gitbook.com/openapi.json, https://gitbook.com/swagger.json, https://gitbook.com/api/openapi.json, https://gitbook.com/.well-known/openapi.json)”

Agent-ready = 84.0 ÷ 210 × 100 = 40.0

API quality23.3/100×0.20 of the PA blend

The programmable surface once an agent is there — machine-readable spec, interactive docs, sandbox, versioning discipline.

Explore an interactive API reference with runnable examplesweight 2

2 (weight) × 7 (quality) × 1.0 (full) = 14.0 of 20 max

  • [claimed-docs] https://www.gitbook.com/pricing“Interactive API playgrounds”
  • [claimed-docs] https://gitbook.com/docs/create-content/openapi/add-an-openapi-specification“Add an OpenAPI specification”
  • [claimed-docs] https://gitbook.com/docs/create-content/openapi.md“let your users test endpoints right on the page with interactive blocks”
  • [claimed-docs] https://gitbook.com/docs/developers/gitbook-api/api-reference.md“This API is RESTful and supports standard HTTP methods like GET, POST, PATCH, and DELETE.”

Download a machine-readable API spec (OpenAPI or equivalent)weight 2

2 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 20 max

  • [probe] https://gitbook.com/openapi.json“PROBE openapi: all candidate paths 404 (https://gitbook.com/openapi.json, https://gitbook.com/swagger.json, https://gitbook.com/api/openapi.json, https://gitbook.com/.well-known/openapi.json)”
  • [claimed-docs] https://gitbook.com/docs/developers/gitbook-api/api-reference.md“This API is RESTful and supports standard HTTP methods like GET, POST, PATCH, and DELETE.”
  • [claimed-docs] https://gitbook.com/docs/create-content/openapi/add-an-openapi-specification“Add an OpenAPI specification”

Test against a sandbox environment without touching production dataweight 1

n/a — not applicable to this product: excluded from numerator and denominator

no evidence cited — the verdict rests on absence of evidence, re-checked on refresh

Rely on versioned APIs with a documented deprecation policyweight 2

2 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 20 max

  • [claimed-docs] https://gitbook.com/docs/developers/gitbook-api/api-reference.md“This API is RESTful and supports standard HTTP methods like GET, POST, PATCH, and DELETE.”
  • [claimed-docs] https://gitbook.com/docs/create-content/version-control“Version control”
  • [probe] https://gitbook.com/openapi.json“PROBE openapi: all candidate paths 404 (https://gitbook.com/openapi.json, https://gitbook.com/swagger.json, https://gitbook.com/api/openapi.json, https://gitbook.com/.well-known/openapi.json)”

API quality = 14.0 ÷ 60 × 100 = 23.3

Openness16.2/100×0.20 of the PA blend

Can you leave, inspect, or self-host — data export, open source, portability.

Do everything through the API that I can do in the UIweight 2

2 (weight) × 6 (quality) × 0.6 (partial) = 7.2 of 20 max

  • [claimed-docs] https://gitbook.com/docs/docs-as-code/gitbook-cli“GitBook CLI”
  • [claimed-docs] https://gitbook.com/docs/docs-as-code/gitbook-mcp.md“Tools like Claude Code, Codex, Cursor, and other MCP clients can use it to create and configure sites, open change requests, draft content, edit pages, and restructure docs.”
  • [claimed-docs] https://gitbook.com/docs/docs-as-code/gitbook-cli.md“list organizations, inspect spaces and pages, ask questions against your docs, and build and publish integrations — all without leaving the shell”
  • [claimed-docs] https://gitbook.com/docs/developers/gitbook-api/api-reference.md“This API is RESTful and supports standard HTTP methods like GET, POST, PATCH, and DELETE.”
  • [probe] https://gitbook.com/openapi.json“PROBE openapi: all candidate paths 404 (https://gitbook.com/openapi.json, https://gitbook.com/swagger.json, https://gitbook.com/api/openapi.json, https://gitbook.com/.well-known/openapi.json)”

Export all of my data in open formats and leaveweight 3

3 (weight) × 5 (quality) × 0.6 (partial) = 9.0 of 30 max

  • [claimed-docs] https://gitbook.com/docs/docs-as-code/git-sync“GitHub & GitLab Sync”
  • [claimed-docs] https://gitbook.com/docs/create-content/version-control“Version control”
  • [claimed-docs] https://www.gitbook.com/features/editor“GitBook’s AI-native visual editor makes it easy to write, review, and publish technical content — with Markdown, real-time collaboration, version control, and Git workflows built in”
  • [community] https://hn.algolia.com/api/v1/items/23659451“'Gitbook was a great project, but they really moved everything to their SaaS with artificial barriers to just using the software... such a non open source behavior to only support their monthly service.'”
  • [community] https://hn.algolia.com/api/v1/items/23659451“'This is much needed as GitBook moved away from Book publishing and abandoned open source spirit.'”

Read the product's source under an open licenseweight 2

2 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 20 max

  • [community] https://hn.algolia.com/api/v1/items/23659451“'Gitbook was a great project, but they really moved everything to their SaaS with artificial barriers to just using the software... such a non open source behavior to only support their monthly service.'”
  • [community] https://hn.algolia.com/api/v1/items/23659451“'This is much needed as GitBook moved away from Book publishing and abandoned open source spirit.'”
  • [community] https://hn.algolia.com/api/v1/items/23659451“GitBook README cited as reason for community fork: 'As the efforts of the GitBook team are focused on the GitBook.com platform, the CLI is no longer under active development.'”

Self-host the core productweight 3

3 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 30 max

  • [community] https://hn.algolia.com/api/v1/items/23659451“'Gitbook was a great project, but they really moved everything to their SaaS with artificial barriers to just using the software... such a non open source behavior to only support their monthly service.'”
  • [community] https://hn.algolia.com/api/v1/items/23659451“'This is much needed as GitBook moved away from Book publishing and abandoned open source spirit.'”
  • [community] https://hn.algolia.com/api/v1/items/23659451“GitBook README cited as reason for community fork: 'As the efforts of the GitBook team are focused on the GitBook.com platform, the CLI is no longer under active development.'”

Openness = 16.2 ÷ 100 × 100 = 16.2

Built-in AI63.3/100×0.15 of the PA blend

Inside-out: how agentic the product itself is for its users — built-in assistants, autonomous features.

Get AI-generated insights and suggestions from my data inside the productweight 2

2 (weight) × 7 (quality) × 1.0 (full) = 14.0 of 20 max

  • [claimed-docs] https://gitbook.com/docs/analytics/ai-insights“AI insights”
  • [claimed-docs] https://gitbook.com/docs/analytics/ai-insights.md“AI insights shows what your visitors are asking and how effectively GitBook Assistant responds using your content.”
  • [claimed-docs] https://www.gitbook.com/features/ai/gitbook-agent“GitBook’s AI documentation agent identifies missing or outdated content, drafts improvements, and helps your team keep product knowledge aligned with real user needs”
  • [claimed-docs] https://www.gitbook.com“The docs platform that flags outdated content. Then fixes it.”

Set up automations that run autonomously in the backgroundweight 2

2 (weight) × 5 (quality) × 0.6 (partial) = 6.0 of 20 max

  • [claimed-docs] https://www.gitbook.com“The docs platform that flags outdated content. Then fixes it.”
  • [claimed-docs] https://www.gitbook.com/features/ai/gitbook-agent“GitBook’s AI documentation agent identifies missing or outdated content, drafts improvements, and helps your team keep product knowledge aligned with real user needs”
  • [claimed-docs] https://gitbook.com/docs/gitbook-agent/translations.md“Auto translations make it easy to keep your documentation up-to-date in multiple languages, with minimal manual effort.”
  • [claimed-docs] https://gitbook.com/docs/gitbook-agent/review-change-requests-with-gitbook-agent“Review change requests with GitBook Agent”

Delegate tasks to a built-in AI assistant inside the productweight 3

3 (weight) × 7 (quality) × 1.0 (full) = 21.0 of 30 max

  • [claimed-docs] https://gitbook.com/docs/ai-for-your-readers/gitbook-ai-assistant“AI Assistant”
  • [claimed-docs] https://gitbook.com/docs/ai-for-your-readers/gitbook-ai-assistant“I'm here to help you with the docs.”
  • [claimed-docs] https://www.gitbook.com/features/ai/gitbook-assistant“Add it to your product, website, or docs to give every user accurate, contextual answers.”
  • [claimed-docs] https://www.gitbook.com/features/ai/gitbook-agent“GitBook’s AI documentation agent identifies missing or outdated content, drafts improvements, and helps your team keep product knowledge aligned with real user needs”
  • [claimed-docs] https://gitbook.com/docs/gitbook-agent/review-change-requests-with-gitbook-agent“Review change requests with GitBook Agent”
  • [claimed-docs] https://gitbook.com/docs/analytics/ai-insights.md“AI insights shows what your visitors are asking and how effectively GitBook Assistant responds using your content.”

Operate the product with natural-language commandsweight 2

2 (weight) × 8 (quality) × 1.0 (full) = 16.0 of 20 max

  • [claimed-docs] https://gitbook.com/docs“New: The GitBook MCP server is here. Connect your AI agent”
  • [claimed-docs] https://gitbook.com/docs/ai-for-your-readers/mcp-servers-for-published-docs“MCP servers for published docs”
  • [claimed-docs] https://gitbook.com/docs/docs-as-code/gitbook-mcp.md“Tools like Claude Code, Codex, Cursor, and other MCP clients can use it to create and configure sites, open change requests, draft content, edit pages, and restructure docs.”
  • [claimed-docs] https://gitbook.com/docs/docs-as-code/gitbook-cli.md“list organizations, inspect spaces and pages, ask questions against your docs, and build and publish integrations — all without leaving the shell”
  • [claimed-docs] https://gitbook.com/docs/docs-as-code/ai-coding-assistants-and-skillmd“Agent skills”
  • [probe] https://gitbook.com/docs/docs-as-code/gitbook-mcp“official MCP server documented at https://gitbook.com/docs/docs-as-code/gitbook-mcp”

Built-in AI = 57.0 ÷ 90 × 100 = 63.3

Automation15.0/100×0.15 of the PA blend

Depth of automation primitives — rules, scheduling, bulk operations, webhooks.

Perform bulk operations across many items at onceweight 2

2 (weight) × 5 (quality) × 0.6 (partial) = 6.0 of 20 max

  • [claimed-docs] https://gitbook.com/docs/docs-as-code/gitbook-mcp.md“Tools like Claude Code, Codex, Cursor, and other MCP clients can use it to create and configure sites, open change requests, draft content, edit pages, and restructure docs.”
  • [claimed-docs] https://gitbook.com/docs/docs-as-code/gitbook-cli.md“list organizations, inspect spaces and pages, ask questions against your docs, and build and publish integrations — all without leaving the shell”
  • [claimed-docs] https://gitbook.com/docs/developers/gitbook-api/api-reference.md“This API is RESTful and supports standard HTTP methods like GET, POST, PATCH, and DELETE.”
  • [claimed-docs] https://gitbook.com/docs/docs-as-code/gitbook-cli“GitBook CLI”
  • [probe] https://gitbook.com/docs/docs-as-code/gitbook-mcp“official MCP server documented at https://gitbook.com/docs/docs-as-code/gitbook-mcp”

Define rules that trigger actions automatically on eventsweight 3

3 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 30 max

no evidence cited — the verdict rests on absence of evidence, re-checked on refresh

Schedule recurring jobs or workflowsweight 2

n/a — not applicable to this product: excluded from numerator and denominator

no evidence cited — the verdict rests on absence of evidence, re-checked on refresh

Version, review, and roll back my automationsweight 1

1 (weight) × 5 (quality) × 0.6 (partial) = 3.0 of 10 max

  • [claimed-docs] https://gitbook.com/docs/create-content/version-control“Version control”
  • [claimed-docs] https://gitbook.com/docs/docs-as-code/git-sync“GitHub & GitLab Sync”
  • [claimed-docs] https://gitbook.com/docs/collaborate/change-requests“Change requests”
  • [claimed-docs] https://gitbook.com/docs/gitbook-agent/review-change-requests-with-gitbook-agent“Review change requests with GitBook Agent”
  • [claimed-docs] https://www.gitbook.com/features/editor“GitBook’s AI-native visual editor makes it easy to write, review, and publish technical content — with Markdown, real-time collaboration, version control, and Git workflows built in”

Automation = 9.0 ÷ 60 × 100 = 15.0