is-agentic.com
View report- Blume
- 100/100
- Mintlify
- 78/100
Blume vs Mintlify.The open-source Mintlify alternative.
The polished docs, API references, and AI features you'd reach for Mintlify for, as a free, open-source framework you host anywhere. Your MDX comes with you, and an agent does the move.
npx blume migrate mintlify --claude| Blume | Mintlify | |
|---|---|---|
| Price | BlumeFree and open source, with no seat limits | MintlifyFree Starter for 5 editors without AI features; Pro from $450 a month |
| Hosting | BlumeAny host: Vercel, Netlify, Cloudflare, Node, or static files | MintlifyMintlify's cloud; self-hosting on AWS or Kubernetes on Enterprise |
| Editing | BlumeMarkdown and MDX in your repo, in any editor | MintlifyA web editor, plus MDX synced from Git |
| AI assistant | BlumeAsk AI on the model you choose, billed by your provider | MintlifyAn assistant on Pro, metered in credits at 25 per answer |
| API references | BlumeOpenAPI, AsyncAPI, and GraphQL, with a Try it playground | MintlifyOpenAPI and AsyncAPI with an API playground, plus GraphQL reference pages |
| Languages | Blumeblume translate fills in every locale with your coding agent | MintlifyMulti-language docs with a language switcher |
| Leaving | Blumeblume eject hands you a standalone Astro app | MintlifyYour MDX lives in Git; the site renders on Mintlify's platform |
Mintlify details are from its own pages as of September 23, 2026: Pricing, Self-hosting, Editor, AI credits, API playground, Internationalization. Something out of date? Let us know
Agent readiness, measured.Scores from two independent scanners.
isitagentready.com
View report- Blume
- 80/100
- Mintlify
- 40/100
Scores are as reported by is-agentic.com and isitagentready.com on September 20, 2026, and may have changed since.
Your docs come with you.Your MDX stays MDX, and an agent does the move.
- Pages stay MDX.
- Callouts become
:::directives, Cards, Steps, Columns, Frame, and Tooltip carry over as they are, and Tabs gain aninlineprop. - Navigation moves into folders.
docs.jsongroups become folders and tabs stay tabs, with a redirect for every URL that moves.- Your OpenAPI spec keeps working.
- Blume generates the reference from the same spec, with a Try it playground on every operation.
- Icons and frontmatter, handled.
- A bundled codemod remaps Font Awesome icons to Lucide and renames frontmatter keys like
sidebarTitle.
Mintlify
Blume
- docs.jsonblume.config.ts
- <Note>:::note
- <AccordionGroup><Accordion>
- <Tabs><Tabs inline>
- <ParamField><TypeTable>
- <RequestExample><CodeGroup>
- sidebarTitlesidebar.label
When Mintlify might suit you better.Blume isn't the right fit for every team.
- You want a web editor.
- Mintlify's browser editor lets teammates publish without touching Git. Blume is Markdown and MDX in your repo.
- You'd rather not run anything.
- Mintlify hosts the site, the assistant, and the analytics dashboard. With Blume you deploy to your own host and bring your own model provider and analytics.
- You need private docs or enterprise controls.
- Mintlify supports reader authentication for private docs, and SSO, SCIM, and RBAC on Enterprise.
Migrate from
- 1
Run one command in your docs project.
Using Codex? Swap
--claudefor--codex. - 2
Review the agent's edits.
It follows Blume's migration playbook for MintlifyFumadocsDocusaurusStarlightNextra, rewriting your config and pages in place, so you review the whole move as one diff.
- 3
Preview the result.
Run
npx blume dev, then read the agent's summary of anything it dropped or approximated.
Questions, answered.About moving from Mintlify to Blume.
Is Blume free?
Yes. Blume is open source under the MIT license, with no seats, plans, or usage credits, and you host it wherever you like.
Can I keep my Mintlify MDX?
Yes. Pages stay MDX. npx blume migrate mintlify --claude converts callouts to directives, maps Mintlify's components to Blume's, and turns docs.json navigation into folders and tabs.
Does Blume have an AI assistant and an MCP server?
Yes. Ask AI answers readers in the page using the model and provider you choose, and an opt-in MCP server lets coding agents search and read your docs. Both run on a server deployment.
Where can I host Blume?
Anywhere: Vercel, Netlify, Cloudflare, a Node server, or any static host. blume build outputs static files by default.
What doesn't the migration carry over?
The agent reports anything without a Blume equivalent, such as footer social links, per-language banners, and dynamic redirects, so you can decide what to do with each.
Upgrade your docs with Blume.
Install today and ship a production-grade docs site in minutes. Free and open source, forever.
npx blume init