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/llmstxt“Automatically 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-export“Add `.md` to any page's URL to view a Markdown version.”
- [claimed-docs] https://www.mintlify.com/docs/ai/skillmd“Mintlify 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/skillmd“Make 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.txt“PROBE 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/install“Install 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/introduction“Use 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/index“Automate 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/install“official CLI documented at https://www.mintlify.com/docs/cli/install”
- [claimed-docs] https://www.mintlify.com/docs/llms.txt“Queue 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.txt“Create 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-protocol“Connect 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-mcp“Give 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/mcp“The 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-protocol“Search Model Context Protocol (MCP) server - Mintlify”
- [claimed-docs] https://www.mintlify.com/docs/ai/mintlify-mcp“Admin Model Context Protocol (MCP) server - Mintlify”
- [claimed-docs] https://www.mintlify.com/docs/search-index/mcp“Mintlify Index MCP server”
- [claimed-docs] https://www.mintlify.com/docs/editor/agent“The 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/index“Learn 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-protocol“Connect 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-mcp“Give 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/mcp“The 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-protocol“Search Model Context Protocol (MCP) server - Mintlify”
- [claimed-docs] https://www.mintlify.com/docs/ai/mintlify-mcp“Admin Model Context Protocol (MCP) server - Mintlify”
- [claimed-docs] https://www.mintlify.com/docs/search-index/mcp“Mintlify Index MCP server”
- [probe] https://www.mintlify.com/docs/ai/mintlify-mcp“official 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/install“Install 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/install“Install the Mintlify CLI to preview documentation l”
- [probe] https://www.mintlify.com/docs/cli/install“official 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/introduction“Use 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.txt“Queue 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.txt“Create 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.json“PROBE 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-protocol“Connect 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-mcp“Give 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/mcp“The Mintlify Index MCP server gives AI tools read-only access to technical documentation and web context.”
- [community] https://hn.algolia.com/api/v1/items/39730255“I 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/introduction“Use the Mintlify REST API to trigger deployments, embed an AI assistant, export analytics data, and manage documentation programmatically.”
- [probe] https://www.mintlify.com/openapi.json“PROBE 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-setup“Generate 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.md“Docs 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.md“API playground where user”
- [claimed-docs] https://www.mintlify.com/docs/api-playground/openapi-setup“Generate 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-setup“Generate interactive API documentation from OpenAPI specification files with automatic endpoint pages, request builders, and navigation.”
- [claimed-docs] https://www.mintlify.com/docs/api/introduction“Use the Mintlify REST API to trigger deployments, embed an AI assistant, export analytics data, and manage documentation programmatically.”
- [probe] https://www.mintlify.com/openapi.json“PROBE 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/install“Install 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-deployments“Get 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/review“Preview 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/review“Preview 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/introduction“Use the Mintlify REST API to trigger deployments, embed an AI assistant, export analytics data, and manage documentation programmatically.”
- [probe] https://www.mintlify.com/openapi.json“PROBE 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-mcp“Give 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/introduction“Use 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/agent“The 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/agent“Use 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.json“PROBE 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-mcp“official 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-export“Add `.md` to any page's URL to view a Markdown version.”
- [claimed-docs] https://www.mintlify.com/docs/ai/markdown-export“Export 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-host“Run 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.md“Migrate 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/31740724“If 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/31740724“If 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/31740724“We 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-host“Run 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-host“Run Mintlify inside your own cloud or on-premises enviro”
- [community] https://hn.algolia.com/api/v1/items/31740724“If 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/31740724“We 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/index“Explore the Mintlify analytics dashboard to measure documentation traffic, assistant conversations, search queries, engagement, and reader feedback.”
- [claimed-docs] https://mintlify.com/pricing“Everything in Pro * SSO, SCIM & RBAC * Performance SLA * Advanced insights * Enterprise security & legal * Migration & support”
- [claimed-docs] https://www.mintlify.com/docs/assistant/index“Add 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/agent“The 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/index“Automate 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/index“Learn 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.txt“We 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/index“Automate 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-native“users 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/index“Add 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/index“Learn 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/index“Automate 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/agent“The 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/agent“Use 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/agent“The 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/agent“Use 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-mcp“Give 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.md“Mention @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.md“Reads 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/index“Learn 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-mcp“official 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/agent“The 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/agent“Use 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/index“Automate 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/introduction“Use 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/index“Automate 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.txt“We 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.txt“Every 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/index“Automate 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/index“Automate conte”
- [claimed-docs] https://www.mintlify.com/blog/llms.txt“We 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/index“Learn 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/index“Automate 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/review“Preview 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-deployments“Get 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/review“Preview 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.txt“Instant 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/pricing“Everything in Pro * SSO, SCIM & RBAC * Performance SLA * Advanced insights * Enterprise security & legal * Migration & support”
Automation = 26.4 ÷ 80 × 100 = 33.0