Skip to main content
Mintlify docs are built for two audiences: people and AI agents. Most of this is automatic. There’s nothing to maintain.

Assistant

Readers ask questions in plain English and get cited answers.

llms.txt

An index of your pages that AI tools can read.

MCP server

Lets Claude, Cursor and others search your docs directly.

skill.md

A capability summary so agents know what your product can do.

The assistant

The assistant answers questions about your docs and API, cites the pages it used, and writes copyable code.
1

Open it

Press ⌘ + I (or Ctrl + I), or click Ask AI in the search bar.
2

Ask something real

Try these on this site:
  • How do I authenticate with the Todo API?
  • Write a Python script that pages through every todo.
  • What’s the difference between the Calculator API v1 and v2?
3

Check the sources

Every answer links to the pages it came from. It also reads the OpenAPI specs, so it knows each endpoint’s parameters and responses.
The assistant is included on Pro and Enterprise plans. Turn it on and tune it in the Mintlify dashboard.

llms.txt and llms-full.txt

Mintlify generates two files for every site, automatically: Add .md to any page URL, or use View as Markdown in the contextual menu, to get a clean Markdown version of just that page. Agents get the same content people see, without the page chrome.
On this site, try /llms.txt and /quickstart.md in your browser.

MCP server

Your site gets a hosted MCP server at /mcp, with no setup. An AI tool that connects to it can search your docs and read full pages while it works.
Replace YOUR-DOCS-DOMAIN with this site’s domain.

skill.md

Mintlify also hosts a skill.md at the root of your site. It follows the agentskills.io format and describes what an agent can do with your product, what inputs it needs, and what to watch for. Install it into an agent with:
Mintlify generates skill.md for you, and it can take up to 24 hours after the first publish. To write your own, add a skill.md file at the root of the repo.

Contextual menu

The menu next to each page title is set in docs.json with contextual.options. This site turns on 17 options, including:

Copy page

Copies the page as Markdown.

View as Markdown

Opens the .md version.

Open in ChatGPT, Claude, Perplexity, Grok

Starts a chat with the page as context.

Connect MCP to Cursor or VS Code

One-click install of the MCP server.
docs.json

Different content for people and agents

The Visibility component shows different content depending on who’s reading.
You’re reading the version written for people.
Open this page’s .md URL to see the agent version.

Also worth showing

Mintlify’s agent can draft docs changes from a prompt, and automations can keep docs up to date when your code changes. Both open pull requests for review.
The analytics dashboard separates human and AI traffic, and shows what people ask the assistant, so you can see which questions your docs don’t answer yet.
Use your own LLM provider key to power the assistant, agent and automations.
Last modified on October 28, 2026