Skip to content

Rank #2 of 5 in Developer Docs Platforms

npm 179.6k/wk

Showcase

Mintlify homepage screenshot
homepage · captured Sep 2026 · view live ↗
Mintlify docs screenshot
docs · captured Sep 2026 · view live ↗

Try itExperimental

See what an agent can do with Mintlify before you ever sign up. Pick a story: recorded sessions replay real probe-harness transcripts; commands tagged live-capable can re-run against the real endpoint from our edge, right now (▶ run live — the exact same request, live and recorded lines always labeled); the live MCP handshake runs real requests from our edge, right now — including, where the server allows it, one real read-only tool call (bring your own key for auth-gated servers); sandboxed self-drive sessions are designed and gated (docs/TRY-IT.md).

$curl -si -X POST https://mcp.mintlify.com -H 'Content-Type: application/json' -d '<jsonrpc initialize>'recorded session — replayed, not live
recorded 2026-09-08 · exit 0 · captured verbatim by our probe harness, secrets redacted

Verified integrations

Connections to other tracked products — hover a chip for the verbatim evidence quote behind it.

By theme — the product's score on each story themeBy theme

Agenticness — how well agents can access and operate the productAgenticnessevidence →

How well agents can access and operate the product

45.7/100

Ai docs — stories about ai docs in this arenaAi docsevidence →

Stories about ai docs in this arena

85.4/100

Analytics insights — stories about analytics insights in this arenaAnalytics insightsevidence →

Stories about analytics insights in this arena

40.0/100

Api reference — stories about api reference in this arenaApi referenceevidence →

Stories about api reference in this arena

80.0/100

Authoring editing — stories about authoring editing in this arenaAuthoring editingevidence →

Stories about authoring editing in this arena

20.0/100

Automation depth — how much of the product can run unattendedAutomation depthevidence →

How much of the product can run unattended

33.0/100

Collaboration review — stories about collaboration review in this arenaCollaboration reviewevidence →

Stories about collaboration review in this arena

80.0/100

Customization — bending the product to your needs — settings, theming, extension pointsCustomizationevidence →

Bending the product to your needs — settings, theming, extension points

30.0/100

Docs as code — stories about docs as code in this arenaDocs as codeevidence →

Stories about docs as code in this arena

64.0/100

Openness — open source, data portability, and self-hosting storiesOpennessevidence →

Open source, data portability, and self-hosting stories

20.7/100

Privacy posture — data-handling and privacy storiesPrivacy postureevidence →

Data-handling and privacy stories

0.0/100

Publishing hosting — stories about publishing hosting in this arenaPublishing hostingevidence →

Stories about publishing hosting in this arena

51.6/100

Search discovery — stories about search discovery in this arenaSearch discoveryevidence →

Stories about search discovery in this arena

36.0/100

Versioning localization — stories about versioning localization in this arenaVersioning localizationevidence →

Stories about versioning localization in this arena

13.5/100

Story verdicts — every judged story with its evidenceStory verdicts

What’s free: 0 free · 0 paid · 1 enterprise · 38 not stated in evidence

?

Sorted by importance (agentic first) (high → low) · 53/53 stories · click a row’s chevron for the rationale and evidence

Connect an agent via an official MCP server G

Agent access

ai-native userAgenticness — how well agents can access and operate the productAgenticness3full8/10T

Delegate tasks to a built-in AI assistant inside the product G

Agentic features

ai-native userAgenticness — how well agents can access and operate the productAgenticness3full8/10C

Drive the product through a documented public API G

Agent access

ai-native userAgenticness — how well agents can access and operate the productAgenticness3partial7/10T

Plug MCP servers into this product so it can use their tools G

Agent access

ai-native userAgenticness — how well agents can access and operate the productAgenticness3none0/10

Point an agent at llms.txt or agent-oriented docs G

Agent access

ai-native userAgenticness — how well agents can access and operate the productAgenticness2full9/10T

Explore an interactive API reference with runnable examples G

Api quality

ai-native userAgenticness — how well agents can access and operate the productAgenticness2full8/10C

Operate the product with natural-language commands G

Agentic features

ai-native userAgenticness — how well agents can access and operate the productAgenticness2full8/10T

Set up automations that run autonomously in the background G

Agentic features

ai-native userAgenticness — how well agents can access and operate the productAgenticness2full8/10C

Use an official CLI G

Agent access

ai-native userAgenticness — how well agents can access and operate the productAgenticness2full8/10T

Get AI-generated insights and suggestions from my data inside the product G

Agentic features

ai-native userAgenticness — how well agents can access and operate the productAgenticness2partial6/10C

Run the product headlessly / in CI for automation G

Agent access

ai-native userAgenticness — how well agents can access and operate the productAgenticness2partial6/10T

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

Api quality

ai-native userAgenticness — how well agents can access and operate the productAgenticness2partial5/10T

Issue scoped/least-privilege API credentials for an agent G

Agent access

ai-native userAgenticness — how well agents can access and operate the productAgenticness2disputed4/10D

Build against official SDKs G

Agent access

ai-native userAgenticness — how well agents can access and operate the productAgenticness2none0/10

Rely on versioned APIs with a documented deprecation policy G

Api quality

ai-native userAgenticness — how well agents can access and operate the productAgenticness2none0/10

Subscribe to events via webhooks G

Agent access

ai-native userAgenticness — how well agents can access and operate the productAgenticness2noneuntestednone yet

Test against a sandbox environment without touching production data G

Api quality

ai-native userAgenticness — how well agents can access and operate the productAgenticness1partial6/10C

My published docs site automatically serves llms.txt (and a full-content variant) so agents can index it C

Agent output

ai-native userAi docs — stories about ai docs in this arenaAi docs3full9/10T

Every published page serves clean markdown at its URL (e.g. appending .md) so agents skip the HTML C

Agent output

ai-native userAi docs — stories about ai docs in this arenaAi docs3full8/10T

My API reference pages are generated from an OpenAPI spec and stay in sync when the spec changes C

Spec driven

developerApi reference — stories about api reference in this arenaApi reference3full8/10C

My docs live in my own git repository — branches, pull requests, and merges drive what gets published C

Git workflow

developerDocs as code — stories about docs as code in this arenaDocs as code3full8/10C

My published docs site exposes its own MCP server that my users' agents can query for search and page content C

Agent access

ai-native userAi docs — stories about ai docs in this arenaAi docs3full8/10C

Define rules that trigger actions automatically on events G

ai-native userAutomation depth — how much of the product can run unattendedAutomation depth3partial6/10C

Readers get fast, typo-tolerant, relevance-ranked search over the whole docs site out of the box C

Search

developerSearch discovery — stories about search discovery in this arenaSearch discovery3partial6/10C

Export all of my data in open formats and leave G

ai-native userOpenness — open source, data portability, and self-hosting storiesOpenness3partial5/10X

Self-host the core product G

ai-native userOpenness — open source, data portability, and self-hosting storiesOpenness3disputedenterprise5/10D

I publish versioned documentation per product or API version, and readers switch versions from the site C

Versioning

developerVersioning localization — stories about versioning localization in this arenaVersioning localization3partial3/10C

I author pages in Markdown/MDX with rich components — tabs, callouts, code groups, steps — without writing custom HTML C

Authoring

technical writerAuthoring editing — stories about authoring editing in this arenaAuthoring editing3noneuntestednone yet

Prevent my data from being used to train AI models G

ai-native userPrivacy posture — data-handling and privacy storiesPrivacy posture3noneuntestednone yet

A platform AI agent drafts, updates, and reviews my docs — from a prompt, a PR, or a schedule — and ships its work as change requests C

Writer agent

ai-native userAi docs — stories about ai docs in this arenaAi docs2full9/10C

An embedded AI assistant on my docs site answers reader questions with citations into my content C

Assistant

ai-native userAi docs — stories about ai docs in this arenaAi docs2full9/10C

I serve docs on my own custom domain or as a /docs subpath of my main site C

Domains

devrel leadPublishing hosting — stories about publishing hosting in this arenaPublishing hosting2full9/10C

Every docs pull request gets a shareable preview deployment before it merges C

Git workflow

developerDocs as code — stories about docs as code in this arenaDocs as code2full8/10C

I see page views, search terms, and reader feedback so I know which docs work and which fail C

Analytics

devrel leadAnalytics insights — stories about analytics insights in this arenaAnalytics insights2full8/10C

Non-technical teammates can edit docs in a visual web editor without touching git, and their changes flow into the same source of truth C

Authoring

technical writerAuthoring editing — stories about authoring editing in this arenaAuthoring editing2full8/10C

Readers can try real API calls from an interactive playground embedded in the reference docs C

Playground

developerApi reference — stories about api reference in this arenaApi reference2full8/10C

Teammates propose changes that go through review — comments, approvals, and a merge step — before they publish C

Review

technical writerCollaboration review — stories about collaboration review in this arenaCollaboration review2full8/10C

Do everything through the API that I can do in the UI G

ai-native userOpenness — open source, data portability, and self-hosting storiesOpenness2partial6/10T

I customize themes, fonts, and layout — down to custom CSS/JS or my own components — so the docs match my brand C

Theming

devrel leadCustomization — bending the product to your needs — settings, theming, extension pointsCustomization2partial5/10C

Perform bulk operations across many items at once G

ai-native userAutomation depth — how much of the product can run unattendedAutomation depth2partial5/10C

Schedule recurring jobs or workflows G

ai-native userAutomation depth — how much of the product can run unattendedAutomation depth2partial5/10C

CI validation catches broken links and invalid configuration before the site publishes C

Quality gates

developerDocs as code — stories about docs as code in this arenaDocs as code2partial4/10C

Export my entire docs site as a static bundle and host it anywhere, so my content is never locked in C

Portability

developerPublishing hosting — stories about publishing hosting in this arenaPublishing hosting2partial4/10X

Choose where my data is stored (region/residency) G

ai-native userPrivacy posture — data-handling and privacy storiesPrivacy posture2none0/10

My docs analytics distinguish AI-agent traffic from human traffic so I can see who — or what — is actually reading C

Analytics

ai-native userAnalytics insights — stories about analytics insights in this arenaAnalytics insights2none0/10

Read the product's source under an open license G

ai-native userOpenness — open source, data portability, and self-hosting storiesOpenness2none0/10

Automated checks lint my content against a style guide and flag issues before they publish C

Quality

technical writerAuthoring editing — stories about authoring editing in this arenaAuthoring editing2noneuntestednone yet

Control data retention and deletion G

ai-native userPrivacy posture — data-handling and privacy storiesPrivacy posture2noneuntestednone yet

Opt out of telemetry and usage tracking G

ai-native userPrivacy posture — data-handling and privacy storiesPrivacy posture2noneuntestednone yet

Version, review, and roll back my automations G

ai-native userAutomation depth — how much of the product can run unattendedAutomation depth1partial6/10C

I gate some or all docs behind authentication — password, JWT, or SSO — for customers-only content G

Access control

devrel leadPublishing hosting — stories about publishing hosting in this arenaPublishing hosting1partial5/10C

I publish my docs in multiple languages with translated navigation and content C

Localization

technical writerVersioning localization — stories about versioning localization in this arenaVersioning localization1noneuntestednone yet

Reusable snippets and variables keep repeated content in sync across pages C

Content reuse

technical writerAuthoring editing — stories about authoring editing in this arenaAuthoring editing1noneuntestednone yet

Opportunities — the stories that would move this product's scores, from its own judged verdictsOpportunitiestop 8 of 31 stories with headroom

What would move Mintlify’s scores — derived from its own judged verdicts, biggest headroom first. Each line quotes what the judge found missing; shipping it (or evidencing it publicly) is the fix.

  1. Agenticness — how well agents can access and operate the productPlug MCP servers into this product so it can use their tools

    nonemoves agent-readyimpact 45

    All MCP-related evidence describes Mintlify exposing its own MCP servers (search, admin, index) for external AI tools like Claude/Cursor/ChatGPT to consume — the opposite direction of this story.

  2. Authoring editing — stories about authoring editing in this arenaI author pages in Markdown/MDX with rich components — tabs, callouts, code groups, steps — without writing custom HTML

    nonemoves PA Scoreimpact 30

    Missing: any documentation of MDX component library, callout/tab/code-group syntax examples, or component authoring guides.

  3. Privacy posture — data-handling and privacy storiesPrevent my data from being used to train AI models

    nonemoves PA Scoreimpact 30

    Missing: any documented privacy policy, opt-out mechanism, or contractual terms about AI training data use.

  4. Agenticness — how well agents can access and operate the productBuild against official SDKs

    nonemoves agent-readyimpact 30

    Mintlify documents a REST API (mintlify-docs-21) and CLI, but there is no evidence of official client SDKs (e.g., Python/JS/Go libraries) for developers to build against, and probes for an OpenAPI spec for Mintlify's own API returned 404s (mintlify-probe-3), suggesting no such SDK tooling exists.

  5. Agenticness — how well agents can access and operate the productSubscribe to events via webhooks

    nonemoves agent-readyimpact 30

    No evidence of webhook subscription capability; Mintlify offers automations triggered by repo pushes/integration events and a REST API to trigger deployments, but nothing about outbound webhooks for subscribing to events.

  6. Agenticness — how well agents can access and operate the productRely on versioned APIs with a documented deprecation policy

    nonemoves API qualityimpact 30

    The evidence pack contains extensive documentation on Mintlify's own API (REST API for deployments, MCP servers, CLI, etc.) but no mention of API versioning schemes or a documented deprecation policy for Mintlify's own APIs/products.

  7. Versioning localization — stories about versioning localization in this arenaI publish versioned documentation per product or API version, and readers switch versions from the site

    partialq3/10moves PA Scoreimpact 21

    Missing: explicit docs on defining/publishing multiple versions, a reader-facing version switcher, and any hands-on confirmation that this works as described.

  8. Analytics insights — stories about analytics insights in this arenaMy docs analytics distinguish AI-agent traffic from human traffic so I can see who — or what — is actually reading

    nonemoves PA Scoreimpact 20

    Mintlify's analytics docs describe traffic, assistant conversations, search queries, engagement, and reader feedback metrics, but none of the evidence mentions segmenting or distinguishing AI-agent/bot traffic from human readers.

Showing the top 8 of 31 — every none/partial verdict in the story verdicts table is headroom.

Think a verdict is wrong? Every verdicts-table row has a Flag link — see the methodology.

Coverage map — which docs area, API section, or community source covers which judged storiesCoverage map8 surfaces · 39 covered stories

Where the cited evidence behind each covered verdict came from — the same citations the verdicts table shows, no extra judging.

docs38 stories

Probe proofs — replayable recordings from the probe harnessProbe proofs

Replayable recordings from our probe harness — see the Prove-It protocol to submit one.

$curl -si -X POST https://mcp.mintlify.com -H 'Content-Type: application/json' -d '<jsonrpc initialize>'reproduced
$ curl -si -X POST https://mcp.mintlify.com -H 'Content-Type: application/json' -d '<jsonrpc initialize>'
HTTP/2 401

access-control-allow-origin: *

cache-control: public, max-age=0, must-revalidate

cf-cache-status: DYNAMIC

cf-ray: a38073806b14c07b-IAD

content-type: application/json; charset=utf-8

date: Tue, 08 Sep 2026 19:45:01 GMT

etag: W/"55-ne2eiByQyrEieB2qeY4xI2hKdhQ"

link: <https://www.mintlify.com/index.md>; rel="alternate"; type="text/markdown"

server: Vercel

set-cookie: AWSALB=enaxelPP9AGMWm7C3OMs315JW5NZv5SAXqLE1cwG9XyorBwBNkdvmZmXSo3Z8JislcSnrZdNXQKaFABhlwjFVyQRZ7U86BwKMLFMhBTBw9pwXwZkHpLtm5kUbxs1; Expires=Tue, 15 Sep 2026 19:45:01 GMT; Path=/

set-cookie: AWSALBCORS=enaxelPP9AGMWm7C3OMs315JW5NZv5SAXqLE1cwG9XyorBwBNkdvmZmXSo3Z8JislcSnrZdNXQKaFABhlwjFVyQRZ7U86BwKMLFMhBTBw9pwXwZkHpLtm5kUbxs1; Expires=Tue, 15 Sep 2026 19:45:01 GMT; Path=/; SameSite=None; Secure

set-cookie: __cf_bm=4ggUO6xOvyoO3mzYa0iMi33_.VhIdZ9gcb8iTdpTPRc-1788896701.5076385-1.0.1.1-2M.eWsHf9cg67aDGEN7WaxU6X0xAiiUhWOipLCcXj0wORyIXucNNXU9nNsM9lmO.QSUnL735s9zKwK.URXbevXNsqhMffs3.fg4CjhGTPTt4cCoFeoT8zhqnJloXwKg_; HttpOnly; SameSite=None; Secure; Path=/; Domain=mintlify.com; Expires=Tue, 08 Sep 2026 20:15:01 GMT

strict-transport-security: max-age=63072000

vary: rsc, next-router-state-tree, next-router-prefetch, next-router-segment-prefetch

www-authenticate: Bearer resource_metadata="https://mcp.mintlify.com/.well-known/oauth-protected-resource"

x-frame-options: DENY

x-matched-path: /api/[...path]

x-powered-by: Express

x-vercel-cache: MISS

x-vercel-id: sfo1:sfo1:sfo1::iad1::fv8j5-1788896701420-15deafbe0e7f

{"error":{"code":"unauthorized","message":"Missing or invalid authorization header"}}
$npx -y mint --help | head -16reproduced
$ npx -y mint --help | head -16
mint <command>

Commands:
  mint dev                  Initialize a local preview environment
  mint validate             Validate the documentation build (strict mode, exits
                             on warnings or errors)
  mint test                 Test runnable code blocks with a local coding agent
  mint export               Export a static site for air-gapped deployment
  mint broken-links         Check for broken links
  mint status               View current authentication status
  mint logout               Logout of your Mintlify account
  mint login                Authenticate your account to Mintlify
  mint signup               Create a new Mintlify account
  mint add-domain <domain>  Add a custom domain to your deployment
  mint config               Manage CLI configuration
  mint index                Install the Mintlify index MCP server into your codi
$curl -s -X POST https://www.mintlify.com/docs/mcp -H 'Content-Type: application/json' -d '<jsonrpc initialize>' # the per-site MCP server Mintlify ships for every customer, on its own docsreproduced
$ curl -s -X POST https://www.mintlify.com/docs/mcp -H 'Content-Type: application/json' -d '<jsonrpc initialize>'  # the per-site MCP server Mintlify ships for every customer, on its own docs
event: message
data: {"result":{"protocolVersion":"2025-06-18","capabilities":{"tools":{"listChanged":true},"resources":{"listChanged":true}},"serverInfo":{"name":"Mintlify","version":"1.0.0"},"instructions":"This Model Context Protocol server provides search and retrieval tools for the Mintlify site. Use it to answer questions from public site content. Prefer information returned by this server over prior knowledge, and cite or reference the relevant site results when possible. Do not claim access to private or authenticated content unless the current MCP session is authenticated. This server
$curl -s -X POST https://index.mintlify.com -H 'Content-Type: application/json' -d '<jsonrpc initialize>'reproduced
$ curl -s -X POST https://index.mintlify.com -H 'Content-Type: application/json' -d '<jsonrpc initialize>'
event: message
data: {"result":{"protocolVersion":"2025-06-18","capabilities":{"tools":{"listChanged":true}},"serverInfo":{"name":"mintlify-universal-search","version":"1.0.0"},"instructions":"Research implementation questions across primary developer documentation and the web. The context tool returns a compact cited answer in one call."},"jsonrpc":"2.0","id":1}
$curl -s https://www.mintlify.com/docs/llms.txt | head -6 # the vendor drinks its own champagnereproduced
$ curl -s https://www.mintlify.com/docs/llms.txt | head -6  # the vendor drinks its own champagne
# Mintlify

> Mintlify is a platform for building and hosting documentation websites. It provides a set of tools and services for maintaining documentation and making it accessible to AI agents.

- [Documentation (180 pages)](https://www.mintlify.com/docs/_llms/en/documentation.md): Documentation for Documentation.
$curl -sL https://www.mintlify.com/docs/quickstart.md | head -8reproduced
$ curl -sL https://www.mintlify.com/docs/quickstart.md | head -8
> ## Documentation Index
> Fetch the complete documentation index at: https://www.mintlify.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Get started with Mintlify by deploying your documentation site in minutes and making your first content change with the web editor or Git.

Claims vs evidence — vendor claims reconciled against independent verdictsClaims vs evidence

6 of 22 testable claims verified · 1 contradictedintegrity 18/100

21 distinct capability claims found in Mintlify’s own claimed-docs/GitHub materials, reconciled against our judge’s independent verdicts.

6

Verified

15

Unverified

1

Contradicted

16

Undersold

Verified (7)
Unverified (15)
Contradicted (1)
Undersold (16)

Business model

free-tiersubscription-flatcreditsenterprise-custom

Starter plan is free; Pro is ~$450/month with 5 editor seats and 10,000 AI credits/month ($0.01 per credit overage); Enterprise is custom.

pricing ↗

Score trend

How this product’s scores have moved as evidence and verdicts are re-derived — a point per change, not per day.

PA Score42 (Sep 8 '26)38 (Sep 16 '26)
Agent-ready49 (Sep 8 '26)38 (Sep 16 '26)

Try Experimental

Run it in the microterminal →

Recorded agent sessions — and a live MCP handshake where the vendor ships one.

Flag

⚑ Flag a verdict

Think a verdict is wrong? Opens a prefilled GitHub issue — or use the ⚑ next to any verdict above.

Badge

Embed this product's score badge →

Hotlinked SVG — always shows the live current score.

For agents

Data

Agent surface uptime MCP up · llms.txt up (tracking since Sep 10 '26)