Duvlify
GitHubGet started
GuidesWhy Duvlify

Why Duvlify

Reasons to pick Duvlify for your documentation, and the use cases it fits — a static site you own, an API reference, and an MCP server for AI agents.

Duvlify gives you full control of your documentation. This page lists the main reasons to use it, and the situations it fits best.

Reasons to use Duvlify

You own the output

Duvlify builds plain HTML files. You can move them to any host at any time. No vendor holds your content.

No per-seat cost

Duvlify is free and open source. You do not pay per writer, per reader, or per month.

Fast pages

Duvlify sends plain HTML and one small script file. Most hosted platforms send a full app framework to the browser. Your pages load faster.

Checks your work

Duvlify checks your pages and your navigation when it builds the site. A broken link or a missing field stops the build and names the file.

Ready for AI agents

Duvlify adds an MCP server to your site. AI agents can search your docs and read them, instead of guessing from old training data.

One file changes the brand

You set your colour, your font, and your page structure in one file. You do not edit templates or write custom code.

Use cases

Developer documentation. Duvlify renders an API reference from your OpenAPI document. It shows a request sample, the response fields, and the parameters, all from one source. See API reference pages.

Product documentation. Guides, concepts, and step-by-step pages, with a search box, a sidebar, and cards for a home page. See Authoring pages.

Internal knowledge bases. Deploy Duvlify inside your own network, or behind your own login. The site is a set of static files, so it works with most access controls.

Documentation an AI agent can use. Duvlify serves each page as HTML and as plain Markdown. It also runs an MCP server, so a coding agent or a support bot can search your docs and quote them. See Serving agents.

What you trade for this control

Duvlify is a framework, not a hosted product. Read this before you choose it.

  • You run the build. There is no dashboard that edits pages for you. You write Markdown files and run a command.
  • You host the output. Duvlify does not host your site. It deploys well to Cloudflare, and it works on any static host. See Deploying.
  • Non-technical writers need a workflow. A writer can edit Markdown files in a text editor, but Duvlify does not include a visual editor.

Compare it to what you use today

If you useWhat changes with Duvlify
A hosted docs platformYou keep the Markdown files. You lose the per-seat bill and the vendor lock-in. You gain full control of the code.
A wikiYou gain a faster site, version control for every page, and checks that catch broken links before readers do.
No documentation yetYou get a working site in one command, with search and an MCP server included.

Use these docs with your AI tools

An AI agent can read this documentation directly. You do not need an account or an API key. Everything here is public and read-only.

Query these docs via MCP

Recommended

Add this server to Claude, Claude Code, Cursor, Mistral, or any tool that supports MCP. Your agent can then search Duvlify documentation and read it in full, instead of answering from memory.

https://duvlify.dev/mcp
  • searchFind the passages that answer a question.
  • fetchRead one page in full, as Markdown.
  • list_pagesSee every page in this documentation.

Query these docs over HTTP

The same tools also work as plain web requests. Use this for scripts, or for any tool that does not support MCP. There is one endpoint per tool. Arguments go in the query string, and the answer comes back as JSON.

https://duvlify.dev/api/docs/search?query=custom+domain

Read the OpenAPI description. It is built from the same definitions as the tools, so it always matches what the endpoints do.

Read these docs as Markdown

Add .md to any page URL to get its Markdown source. You can also send the headerAccept: text/markdown to the page URL itself.

To read the whole documentation in one file, open llms-full.txt. For a short index of every page, open llms.txt.