> ## Documentation Index
> Fetch the complete documentation index at: https://docs.marcodewey.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AI features

> How Mintlify makes your docs useful to AI assistants and AI agents, as well as people.

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

> [card] Assistant
>
> Readers ask questions in plain English and get cited answers.

> [card] llms.txt
>
> An index of your pages that AI tools can read.

> [card] MCP server
>
> Lets Claude, Cursor and others search your docs directly.

> [card] 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 <kbd>⌘</kbd> + <kbd>I</kbd> (or <kbd>Ctrl</kbd> + <kbd>I</kbd>), 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.

> [!NOTE]
>
> 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:

| File | What's in it |
| - | - |
| `/llms.txt` | A short index: every page with its title and description |
| `/llms-full.txt` | The full text of the docs in one file |

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.

> [!TIP]
>
> 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.

> [tab] Claude Code
>
> ```bash theme={null}
> claude mcp add --transport http mintlify-demo https://YOUR-DOCS-DOMAIN/mcp
> ```

> [tab] Cursor
>
> Use **Connect to Cursor** in the contextual menu on any page.

> [tab] Any MCP client
>
> Add the URL `https://YOUR-DOCS-DOMAIN/mcp` as an HTTP MCP server.

> [!NOTE]
>
> 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](https://agentskills.io/specification) 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:

```bash theme={null}
npx skills add https://YOUR-DOCS-DOMAIN
```

> [!NOTE]
>
> 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:

> [card] Copy page
>
> Copies the page as Markdown.

> [card] View as Markdown
>
> Opens the `.md` version.

> [card] Open in ChatGPT, Claude, Perplexity, Grok
>
> Starts a chat with the page as context.

> [card] Connect MCP to Cursor or VS Code
>
> One-click install of the MCP server.

```json docs.json theme={null}
{
  "contextual": {
    "options": [
      "copy", "view", "assistant", "chatgpt", "claude", "perplexity", "grok", "aistudio", "devin",
      "windsurf", "mcp", "cursor", "vscode", "devin-mcp", "add-mcp", "download-spec", "download-pdf"
    ]
  }
}
```

## Different content for people and agents

The `Visibility` component shows different content depending on who's reading.

You're reading the version written for **agents**. To call the Todo API, send `X-API-Key: demo-key` and `POST /todos` with a JSON body containing `title`.

Open this page's `.md` URL to see the agent version.

## Also worth showing

> [accordion] The agent and automations
>
> 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.

> [accordion] Analytics for AI traffic
>
> 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.

> [accordion] Bring your own model
>
> Use your own LLM provider key to power the assistant, agent and automations.
