Skip to content

How Mintlify’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 Score38/100

Agent-ready 38.2 × 0.30 = 11.46

API quality 36.6 × 0.20 = 7.32

Openness 20.7 × 0.20 = 4.14

Built-in AI 70.2 × 0.15 = 10.53

Automation 33.0 × 0.15 = 4.95

(11.46 + 7.32 + 4.14 + 10.53 + 4.95) ÷ (0.30 + 0.20 + 0.20 + 0.15 + 0.15) = 38.40 ÷ 1.00 = 38.4

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-ready38.2/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) × 9 (quality) × 1.0 (full) = 18.0 of 20 max

  • [claimed-docs] https://www.mintlify.com/docs/ai/llmstxtAutomatically generate llms.txt and llms-full.txt files so AI tools like ChatGPT and Claude can index and understand your documentation.
  • [claimed-docs] https://www.mintlify.com/docs/ai/markdown-exportAdd `.md` to any page's URL to view a Markdown version.
  • [claimed-docs] https://www.mintlify.com/docs/ai/skillmdMintlify hosts a `skill.md` file at the root of your project that describes what AI agents can do with your product.
  • [claimed-docs] https://www.mintlify.com/docs/ai/skillmdMake your documentation agent-ready with automatically generated skill.md files that describe your product's capabilities for AI agents.
  • [probe] https://www.mintlify.com/llms.txtPROBE llms.txt: HTTP 200 at https://www.mintlify.com/llms.txt # Mintlify > Mintlify is the knowledge platform built for agents: self-updating documentation for startups, enterprises

Run the product headlessly / in CI for automationweight 2

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

  • [claimed-docs] https://www.mintlify.com/docs/cli/installInstall the Mintlify CLI to preview documentation locally, test changes in real time, and catch build errors before deploying to production.
  • [claimed-docs] https://www.mintlify.com/docs/api/introductionUse the Mintlify REST API to trigger deployments, embed an AI assistant, export analytics data, and manage documentation programmatically.
  • [claimed-docs] https://www.mintlify.com/docs/automations/indexAutomate content maintenance with Mintlify automations by running the agent on a schedule, on repository pushes, or on connected integration events.
  • [probe] https://www.mintlify.com/docs/cli/installofficial CLI documented at https://www.mintlify.com/docs/cli/install
  • [claimed-docs] https://www.mintlify.com/docs/llms.txtQueue a deployment update for your documentation project. Returns a status ID that can be used to track the update progress.
  • [claimed-docs] https://www.mintlify.com/docs/llms.txtCreate or update a preview deployment for a specific branch. If a preview already exists for the branch, it triggers a redeployment.

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://www.mintlify.com/docs/ai/model-context-protocolConnect AI tools like Claude, Cursor, and ChatGPT to your hosted search MCP server so they can search and retrieve content from your site.
  • [claimed-docs] https://www.mintlify.com/docs/ai/mintlify-mcpGive AI tools like Claude, ChatGPT, and Cursor write access to your Mintlify content and dashboard so they can edit pages, update settings, and open PRs.
  • [claimed-docs] https://www.mintlify.com/docs/search-index/mcpThe Mintlify Index MCP server gives AI tools read-only access to technical documentation and web context.
  • [claimed-docs] https://www.mintlify.com/docs/ai/model-context-protocolSearch Model Context Protocol (MCP) server - Mintlify
  • [claimed-docs] https://www.mintlify.com/docs/ai/mintlify-mcpAdmin Model Context Protocol (MCP) server - Mintlify
  • [claimed-docs] https://www.mintlify.com/docs/search-index/mcpMintlify Index MCP server
  • [claimed-docs] https://www.mintlify.com/docs/editor/agentThe editor includes a built-in agent that can edit pages, reorganize navigation, update `docs.json`, search across your entire repository, and manage dashboard settings.
  • [claimed-docs] https://www.mintlify.com/docs/agent/indexLearn how the Mintlify agent researches, plans, and writes documentation, then opens pull requests with proposed changes for your team to review.

Connect an agent via an official MCP serverweight 3

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

  • [claimed-docs] https://www.mintlify.com/docs/ai/model-context-protocolConnect AI tools like Claude, Cursor, and ChatGPT to your hosted search MCP server so they can search and retrieve content from your site.
  • [claimed-docs] https://www.mintlify.com/docs/ai/mintlify-mcpGive AI tools like Claude, ChatGPT, and Cursor write access to your Mintlify content and dashboard so they can edit pages, update settings, and open PRs.
  • [claimed-docs] https://www.mintlify.com/docs/search-index/mcpThe Mintlify Index MCP server gives AI tools read-only access to technical documentation and web context.
  • [claimed-docs] https://www.mintlify.com/docs/ai/model-context-protocolSearch Model Context Protocol (MCP) server - Mintlify
  • [claimed-docs] https://www.mintlify.com/docs/ai/mintlify-mcpAdmin Model Context Protocol (MCP) server - Mintlify
  • [claimed-docs] https://www.mintlify.com/docs/search-index/mcpMintlify Index MCP server
  • [probe] https://www.mintlify.com/docs/ai/mintlify-mcpofficial MCP server documented at https://www.mintlify.com/docs/ai/mintlify-mcp

Use an official CLIweight 2

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

  • [claimed-docs] https://www.mintlify.com/docs/cli/installInstall the Mintlify CLI to preview documentation locally, test changes in real time, and catch build errors before deploying to production.
  • [claimed-docs] https://www.mintlify.com/docs/cli/installInstall the Mintlify CLI to preview documentation l
  • [probe] https://www.mintlify.com/docs/cli/installofficial CLI documented at https://www.mintlify.com/docs/cli/install

Drive the product through a documented public APIweight 3

3 (weight) × 7 (quality) × 0.6 (partial) = 12.6 of 30 max

  • [claimed-docs] https://www.mintlify.com/docs/api/introductionUse the Mintlify REST API to trigger deployments, embed an AI assistant, export analytics data, and manage documentation programmatically.
  • [claimed-docs] https://www.mintlify.com/docs/llms.txtQueue a deployment update for your documentation project. Returns a status ID that can be used to track the update progress.
  • [claimed-docs] https://www.mintlify.com/docs/llms.txtCreate or update a preview deployment for a specific branch. If a preview already exists for the branch, it triggers a redeployment.
  • [probe] https://www.mintlify.com/openapi.jsonPROBE openapi: all candidate paths 404 (https://www.mintlify.com/openapi.json, https://www.mintlify.com/swagger.json, https://www.mintlify.com/api/openapi.json, https://www.mintlify.com/.well-known/openapi.json)

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

2 (weight) × 4 (quality) × 0.3 (disputed) = 2.4 of 20 max

  • [claimed-docs] https://www.mintlify.com/docs/ai/model-context-protocolConnect AI tools like Claude, Cursor, and ChatGPT to your hosted search MCP server so they can search and retrieve content from your site.
  • [claimed-docs] https://www.mintlify.com/docs/ai/mintlify-mcpGive AI tools like Claude, ChatGPT, and Cursor write access to your Mintlify content and dashboard so they can edit pages, update settings, and open PRs.
  • [claimed-docs] https://www.mintlify.com/docs/search-index/mcpThe Mintlify Index MCP server gives AI tools read-only access to technical documentation and web context.
  • [community] https://hn.algolia.com/api/v1/items/39730255I was a Mintlify customer 6 months ago and found their onboarding strange. Their Github app asked for permissions to access all my repos and there was no way to get around that.

Build against official SDKsweight 2

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

  • [claimed-docs] https://www.mintlify.com/docs/api/introductionUse the Mintlify REST API to trigger deployments, embed an AI assistant, export analytics data, and manage documentation programmatically.
  • [probe] https://www.mintlify.com/openapi.jsonPROBE openapi: all candidate paths 404 (https://www.mintlify.com/openapi.json, https://www.mintlify.com/swagger.json, https://www.mintlify.com/api/openapi.json, https://www.mintlify.com/.well-known/openapi.json)

Subscribe to events via webhooksweight 2

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

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

Agent-ready = 80.2 ÷ 210 × 100 = 38.2

API quality36.6/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) × 8 (quality) × 1.0 (full) = 16.0 of 20 max

  • [claimed-docs] https://www.mintlify.com/docs/api-playground/openapi-setupGenerate interactive API documentation from OpenAPI specification files with automatic endpoint pages, request builders, and navigation.
  • [claimed-docs] https://www.mintlify.com/use-cases/api-reference.mdDocs generated directly from your OpenAPI spec. Interactive for developers. Structured for agents. Generated from the spec you already maintain, and updated every time it changes.
  • [claimed-docs] https://www.mintlify.com/use-cases/api-reference.mdAPI playground where user
  • [claimed-docs] https://www.mintlify.com/docs/api-playground/openapi-setupGenerate i

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

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

  • [claimed-docs] https://www.mintlify.com/docs/api-playground/openapi-setupGenerate interactive API documentation from OpenAPI specification files with automatic endpoint pages, request builders, and navigation.
  • [claimed-docs] https://www.mintlify.com/docs/api/introductionUse the Mintlify REST API to trigger deployments, embed an AI assistant, export analytics data, and manage documentation programmatically.
  • [probe] https://www.mintlify.com/openapi.jsonPROBE openapi: all candidate paths 404 (https://www.mintlify.com/openapi.json, https://www.mintlify.com/swagger.json, https://www.mintlify.com/api/openapi.json, https://www.mintlify.com/.well-known/openapi.json)

Test against a sandbox environment without touching production dataweight 1

1 (weight) × 6 (quality) × 0.6 (partial) = 3.6 of 10 max

  • [claimed-docs] https://www.mintlify.com/docs/cli/installInstall the Mintlify CLI to preview documentation locally, test changes in real time, and catch build errors before deploying to production.
  • [claimed-docs] https://www.mintlify.com/docs/deploy/preview-deploymentsGet unique preview URLs for each pull request so reviewers can see documentation changes in a live environment before merging to production.
  • [claimed-docs] https://www.mintlify.com/docs/editor/reviewPreview your changes before they reach your live site, then review and merge the pull request without leaving the editor.
  • [claimed-docs] https://www.mintlify.com/docs/editor/reviewPreview changes before they go live, share them with your team, and approve and merge pull requests from the editor.

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://www.mintlify.com/docs/api/introductionUse the Mintlify REST API to trigger deployments, embed an AI assistant, export analytics data, and manage documentation programmatically.
  • [probe] https://www.mintlify.com/openapi.jsonPROBE openapi: all candidate paths 404 (https://www.mintlify.com/openapi.json, https://www.mintlify.com/swagger.json, https://www.mintlify.com/api/openapi.json, https://www.mintlify.com/.well-known/openapi.json)

API quality = 25.6 ÷ 70 × 100 = 36.6

Openness20.7/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://www.mintlify.com/docs/ai/mintlify-mcpGive AI tools like Claude, ChatGPT, and Cursor write access to your Mintlify content and dashboard so they can edit pages, update settings, and open PRs.
  • [claimed-docs] https://www.mintlify.com/docs/api/introductionUse the Mintlify REST API to trigger deployments, embed an AI assistant, export analytics data, and manage documentation programmatically.
  • [claimed-docs] https://www.mintlify.com/docs/editor/agentThe editor includes a built-in agent that can edit pages, reorganize navigation, update `docs.json`, search across your entire repository, and manage dashboard settings.
  • [claimed-docs] https://www.mintlify.com/docs/editor/agentUse the editor's built-in AI agent to write content, edit pages, leave comments and suggestions, search your site, upload files, and configure settings.
  • [probe] https://www.mintlify.com/openapi.jsonPROBE openapi: all candidate paths 404 (https://www.mintlify.com/openapi.json, https://www.mintlify.com/swagger.json, https://www.mintlify.com/api/openapi.json, https://www.mintlify.com/.well-known/openapi.json)
  • [probe] https://www.mintlify.com/docs/ai/mintlify-mcpofficial MCP server documented at https://www.mintlify.com/docs/ai/mintlify-mcp

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://www.mintlify.com/docs/ai/markdown-exportAdd `.md` to any page's URL to view a Markdown version.
  • [claimed-docs] https://www.mintlify.com/docs/ai/markdown-exportExport clean Markdown versions of your documentation pages for AI tools, LLM integrations, and automated content processing workflows.
  • [claimed-docs] https://www.mintlify.com/docs/deploy/self-hostRun Mintlify inside your own cloud or on-premises environment, on AWS or any Kubernetes platform including Azure, Google Cloud, Oracle Cloud, and OpenShift.
  • [claimed-docs] https://www.mintlify.com/switch.mdMigrate your documentation to Mintlify from ReadMe, GitBook, Docusaurus, Fern, or any platform. Get migration support and up to 12 months free.
  • [community] https://hn.algolia.com/api/v1/items/31740724If anyone is wondering, Mintlify is not open source: the license restricts the backend enterprise features to source-available only.

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/31740724If anyone is wondering, Mintlify is not open source: the license restricts the backend enterprise features to source-available only.
  • [community] https://hn.algolia.com/api/v1/items/31740724We have a highly regulated environment... It is very nifty but it is pure SaaS, and I don't care how secure they are, having our source flow through another SaaS is not something I'm going to take on.

Self-host the core productweight 3

3 (weight) × 5 (quality) × 0.3 (disputed) = 4.5 of 30 max

  • [claimed-docs] https://www.mintlify.com/docs/deploy/self-hostRun Mintlify inside your own cloud or on-premises environment, on AWS or any Kubernetes platform including Azure, Google Cloud, Oracle Cloud, and OpenShift.
  • [claimed-docs] https://www.mintlify.com/docs/deploy/self-hostRun Mintlify inside your own cloud or on-premises enviro
  • [community] https://hn.algolia.com/api/v1/items/31740724If anyone is wondering, Mintlify is not open source: the license restricts the backend enterprise features to source-available only.
  • [community] https://hn.algolia.com/api/v1/items/31740724We have a highly regulated environment... It is very nifty but it is pure SaaS, and I don't care how secure they are, having our source flow through another SaaS is not something I'm going to take on.

Openness = 20.7 ÷ 100 × 100 = 20.7

Built-in AI70.2/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) × 6 (quality) × 0.6 (partial) = 7.2 of 20 max

  • [claimed-docs] https://www.mintlify.com/docs/analytics/indexExplore the Mintlify analytics dashboard to measure documentation traffic, assistant conversations, search queries, engagement, and reader feedback.
  • [claimed-docs] https://mintlify.com/pricingEverything in Pro * SSO, SCIM & RBAC * Performance SLA * Advanced insights * Enterprise security & legal * Migration & support
  • [claimed-docs] https://www.mintlify.com/docs/assistant/indexAdd an AI-powered chat assistant to your documentation site that answers user questions, cites sources, and generates code examples on demand.
  • [claimed-docs] https://www.mintlify.com/docs/editor/agentThe editor includes a built-in agent that can edit pages, reorganize navigation, update `docs.json`, search across your entire repository, and manage dashboard settings.

Set up automations that run autonomously in the backgroundweight 2

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

  • [claimed-docs] https://www.mintlify.com/docs/automations/indexAutomate content maintenance with Mintlify automations by running the agent on a schedule, on repository pushes, or on connected integration events.
  • [claimed-docs] https://www.mintlify.com/docs/agent/indexLearn how the Mintlify agent researches, plans, and writes documentation, then opens pull requests with proposed changes for your team to review.
  • [claimed-docs] https://www.mintlify.com/blog/llms.txtWe redesigned automations for quicker setup with pre-built automations optimized for common use cases. Choose the right automations for your project and you're set. No context engineering required.
  • [claimed-docs] https://www.mintlify.com/docs/automations/indexAutomate conte

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

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

  • [claimed-docs] https://www.mintlify.com/docs/ai-nativeusers can chat with the [assistant](/docs/assistant) in your documentation for immediate answers to their questions and links to relevant content
  • [claimed-docs] https://www.mintlify.com/docs/assistant/indexAdd an AI-powered chat assistant to your documentation site that answers user questions, cites sources, and generates code examples on demand.
  • [claimed-docs] https://www.mintlify.com/docs/agent/indexLearn how the Mintlify agent researches, plans, and writes documentation, then opens pull requests with proposed changes for your team to review.
  • [claimed-docs] https://www.mintlify.com/docs/automations/indexAutomate content maintenance with Mintlify automations by running the agent on a schedule, on repository pushes, or on connected integration events.
  • [claimed-docs] https://www.mintlify.com/docs/editor/agentThe editor includes a built-in agent that can edit pages, reorganize navigation, update `docs.json`, search across your entire repository, and manage dashboard settings.
  • [claimed-docs] https://www.mintlify.com/docs/editor/agentUse the editor's built-in AI agent to write content, edit pages, leave comments and suggestions, search your site, upload files, and configure settings.

Operate the product with natural-language commandsweight 2

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

  • [claimed-docs] https://www.mintlify.com/docs/editor/agentThe editor includes a built-in agent that can edit pages, reorganize navigation, update `docs.json`, search across your entire repository, and manage dashboard settings.
  • [claimed-docs] https://www.mintlify.com/docs/editor/agentUse the editor's built-in AI agent to write content, edit pages, leave comments and suggestions, search your site, upload files, and configure settings.
  • [claimed-docs] https://www.mintlify.com/docs/ai/mintlify-mcpGive AI tools like Claude, ChatGPT, and Cursor write access to your Mintlify content and dashboard so they can edit pages, update settings, and open PRs.
  • [claimed-docs] https://www.mintlify.com/use-cases/slack-agent.mdMention @mintlify in any channel or DM - Answers grounded in your docs, with sources - Follow-ups stay in the same thread
  • [claimed-docs] https://www.mintlify.com/use-cases/slack-agent.mdReads the full thread for context - Opens a pull request in your docs repo - Live status updates until the PR is ready
  • [claimed-docs] https://www.mintlify.com/docs/agent/indexLearn how the Mintlify agent researches, plans, and writes documentation, then opens pull requests with proposed changes for your team to review.
  • [probe] https://www.mintlify.com/docs/ai/mintlify-mcpofficial MCP server documented at https://www.mintlify.com/docs/ai/mintlify-mcp

Built-in AI = 63.2 ÷ 90 × 100 = 70.2

Automation33.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://www.mintlify.com/docs/editor/agentThe editor includes a built-in agent that can edit pages, reorganize navigation, update `docs.json`, search across your entire repository, and manage dashboard settings.
  • [claimed-docs] https://www.mintlify.com/docs/editor/agentUse the editor's built-in AI agent to write content, edit pages, leave comments and suggestions, search your site, upload files, and configure settings.
  • [claimed-docs] https://www.mintlify.com/docs/automations/indexAutomate content maintenance with Mintlify automations by running the agent on a schedule, on repository pushes, or on connected integration events.
  • [claimed-docs] https://www.mintlify.com/docs/api/introductionUse the Mintlify REST API to trigger deployments, embed an AI assistant, export analytics data, and manage documentation programmatically.

Define rules that trigger actions automatically on eventsweight 3

3 (weight) × 6 (quality) × 0.6 (partial) = 10.8 of 30 max

  • [claimed-docs] https://www.mintlify.com/docs/automations/indexAutomate content maintenance with Mintlify automations by running the agent on a schedule, on repository pushes, or on connected integration events.
  • [claimed-docs] https://www.mintlify.com/blog/llms.txtWe redesigned automations for quicker setup with pre-built automations optimized for common use cases. Choose the right automations for your project and you're set. No context engineering required.
  • [claimed-docs] https://www.mintlify.com/blog/llms.txtEvery AI action in Mintlify now has a fixed credit price, and you only pay when we deliver a result. Assistant answers and automation updates cost credits. Everything else is free.

Schedule recurring jobs or workflowsweight 2

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

  • [claimed-docs] https://www.mintlify.com/docs/automations/indexAutomate content maintenance with Mintlify automations by running the agent on a schedule, on repository pushes, or on connected integration events.
  • [claimed-docs] https://www.mintlify.com/docs/automations/indexAutomate conte
  • [claimed-docs] https://www.mintlify.com/blog/llms.txtWe redesigned automations for quicker setup with pre-built automations optimized for common use cases. Choose the right automations for your project and you're set. No context engineering required.

Version, review, and roll back my automationsweight 1

1 (weight) × 6 (quality) × 0.6 (partial) = 3.6 of 10 max

  • [claimed-docs] https://www.mintlify.com/docs/agent/indexLearn how the Mintlify agent researches, plans, and writes documentation, then opens pull requests with proposed changes for your team to review.
  • [claimed-docs] https://www.mintlify.com/docs/automations/indexAutomate content maintenance with Mintlify automations by running the agent on a schedule, on repository pushes, or on connected integration events.
  • [claimed-docs] https://www.mintlify.com/docs/editor/reviewPreview your changes before they reach your live site, then review and merge the pull request without leaving the editor.
  • [claimed-docs] https://www.mintlify.com/docs/deploy/preview-deploymentsGet unique preview URLs for each pull request so reviewers can see documentation changes in a live environment before merging to production.
  • [claimed-docs] https://www.mintlify.com/docs/editor/reviewPreview changes before they go live, share them with your team, and approve and merge pull requests from the editor.
  • [claimed-docs] https://www.mintlify.com/blog/llms.txtInstant rollbacks are now live for Mintlify Enterprise customers. You can roll back to a known good deployment in seconds, without waiting on a full rebuild.
  • [claimed-docs] https://mintlify.com/pricingEverything in Pro * SSO, SCIM & RBAC * Performance SLA * Advanced insights * Enterprise security & legal * Migration & support

Automation = 26.4 ÷ 80 × 100 = 33.0