Mintlify

Overview

Mintlify is an AI-native documentation platform that powers the docs read by 2M+ monthly developers — including Anthropic (Claude API, MCP, Claude Code), Perplexity, Vercel, Replit, and Coinbase. It bills itself as "The Intelligent Knowledge Platform" because every layer is built for both human readers and LLM consumers, with native support for llms.txt, the Model Context Protocol, and inline AI editing.

The product has two faces. For readers, it ships a fast, on-brand docs site with an AI assistant that turns visits into guided conversations. For writers, Mintlify's web editor is a WYSIWYG, Git-synced collaborative workspace, introduced before 2026 and continuing to gain editor and Git-workflow improvements through 2026 where engineers can keep pushing from the CLI while marketers and PMs edit the same pages in the browser. Pricing starts free for individuals (Hobby), $250/month for startup teams (Pro), and custom for Enterprise — backed by a recent $45M Series B.

Key Features

• AI-Native WYSIWYG Editor — Combines real-time visual editing, slash commands, and inline AI for grammar, rewriting, and restructuring, so non-technical teammates can contribute without learning Markdown syntax.
• Bi-Directional Git Sync — Edits in the browser commit back to your repo and vice versa, letting engineers keep using their CLI workflow while non-engineers edit in the UI without merge conflicts.
• Mintlify Agent — Watches your codebase and drafts documentation updates whenever you ship code changes, matching your existing tone and structure to cut documentation debt instead of just flagging it.
• OpenAPI Playground & Mermaid Diagrams — Auto-generates interactive API playgrounds from your OpenAPI/Swagger spec and supports Mermaid diagrams for flowcharts, sequence diagrams, and other visualizations with automatic rendering from Mermaid syntax — keeping diagrams co-located with the docs source instead of in separate design files.
• MCP Server & llms.txt — Ships native MCP and llms.txt support so AI assistants like Claude or ChatGPT can read your docs directly, making it useful for teams already shipping AI-facing products.
• Live Preview Without Deploy — Renders the page exactly as it will appear on production — theme, components, and layout — so writers iterate without triggering CI builds.

How to Get Started

Mintlify is hosted, but the setup mirrors the way developer teams already work — repo first, then deploy:

1. Sign up and pick a starter — Create a workspace at mintlify.com and clone the official starter kit (or import an existing repo).
2. Connect your Git provider — Connect a supported Git provider such as GitHub or GitLab; every push deploys automatically and browser edits sync back through the connected Git workflow.
3. Configure mint.json / docs.json — Set navigation, theme colors, logo, and OpenAPI spec path; the file is the single source of truth for site structure.
4. Add your content — Write in Markdown/MDX with Mintlify's component library (Cards, Tabs, Accordions, CodeGroup), or open the visual editor for non-technical contributors.
5. Wire up custom domain and analytics (optional) — Custom domain ships on the free Hobby tier; analytics, Google Tag Manager, and Posthog integrations are configured in the dashboard.
6. Turn on AI features — Enable the assistant agent and writing agent on Pro to give readers conversational search and your team an AI co-author.

Pricing & Plans

Mintlify uses a three-tier model with a 14-day Pro trial (no credit card required) and AI metered separately:

Hobby — Free

• Single dashboard member
• Custom domain, web editor, MCP server, custom components
• Full platform access for indie developers and side projects

Pro — $250/month (saves up to ~15% billed annually)

• 5 dashboard members included; $20/month per additional seat
• Adds the assistant agent, writing agent, preview deployments, and password protection
• Marketed as the default for startups and small product teams

Enterprise — Custom

• Unlimited members, self-updating workflows, boosted performance
• SOC 2 compliance, SAML SSO, enterprise security/legal review
• White-glove migration and ongoing professional services

AI credits: Every workspace gets 250 AI credits per month included; overages bill at $0.25/credit, with packages available for higher-volume teams.

How It Compares

• vs GitBook — Both ship a polished docs site, but Mintlify is more developer-native: Git is the source of truth, OpenAPI playgrounds are first-class, and MCP/llms.txt are built in. GitBook leans further toward general knowledge bases and internal wikis. Pick Mintlify if your docs sit in a repo; pick GitBook if your team mostly edits in a browser-only workspace.
• vs Notion / Confluence — Notion and Confluence are great internal wikis but never meant to be public, fast, branded API documentation. Mintlify wins for external developer docs (custom domain, theme, OpenAPI rendering); Notion/Confluence wins for project notes and runbooks.
• vs ReadMe / Documentation.AI — ReadMe is the closest competitor for API-first docs and has been around longer; Mintlify pulled ahead on AI-native editing, the agent that drafts updates from code, and a notably faster default theme. Documentation.AI is cheaper and good for solo devs, but it doesn't match Mintlify on the editor experience or enterprise features.
• vs hosting your own (Docusaurus, Nextra) — Self-hosting is free in dollars but expensive in upkeep: theming, search, analytics, AI assistant, and OpenAPI rendering all become your problem. Mintlify trades $250/month for that maintenance budget plus a hosted AI layer.

Best For

• API-first product teams who need a public, branded developer portal with OpenAPI playground out of the box
• Cross-functional doc teams (engineering + PM + marketing) that need WYSIWYG editing without abandoning Git
• AI tool builders shipping MCP servers or LLM-readable docs who want llms.txt and MCP support handled
• Startups in YC or Series A/B stage spending $250–$1,000/month on docs infrastructure and willing to consolidate
• Engineering organizations whose docs go stale faster than humans can maintain them

FAQ