# Mintlify MCP

Vendor: Mintlify  
Category: developer-tools  
Auth: API_KEY  
Composio slug: `mintlify`

Mintlify is a documentation platform. This toolkit exposes the Admin API for managing docs programmatically — trigger deployments and previews, run automations, drive the docs-editing agent, and export analytics (feedback, searches, views, visitors and assistant conversations).

## Verdict

Mintlify's MCP lets your team query documentation analytics, export user feedback, and trigger AI documentation agents — all from a Switchy Project. @Mention it to pull search trends, conversation logs, or page-view breakdowns without leaving chat. The standout tool is Create Agent Job: it edits your docs repo and opens a pull request based on a natural-language prompt, but it's destructive and burns credits, so use it deliberately. Best for engineering teams who maintain public docs and want analytics or automated edits in their workflow. Requires an API key with appropriate scopes; some endpoints return only the first page of results when pagination cursors are missing.

## Tools

- **Create Agent Job** — Start a background documentation agent job from a natural-language prompt. The agent edits the connected docs repo and OPENS A PULL REQUEST if it changes files (DESTRUCTIVE; consumes credits). Returns an AgentJob; poll its id with MINTLIFY_
- **Get Agent Job** — Retrieve the status and details (status, PR link, model, source repo/ref) of a docs agent job. Poll this until status is completed, archived or failed. No pagination.
- **Get Assistant Caller Stats** — Get assistant query counts broken down by caller type (web, api, other, total) for a date range. Returns a single aggregate object; no pagination.
- **Get Assistant Conversations** — Export the AI assistant conversation history (question, answer, cited sources, resolution status) for a Mintlify project, optionally filtered by date. Returns one page of conversations plus a cursor to fetch the next page.
- **Get Feedback** — Export a project's user feedback (thumbs / contextual comments / agent feedback), optionally filtered by date, source and status. Returns one page plus a cursor to fetch the next.
- **Get Feedback By Page** — Get feedback counts (thumbs up/down, code, total) aggregated per documentation page path for a date range. Single page of results — this endpoint exposes no pagination cursor, so only the first page is available.
- **Get Page Views** — Export per-path and site-wide content view counts split by human vs AI traffic. Offset-paginated: returns one page of rows plus site-wide totals, the hasMore flag as has_more, and a next_offset to fetch the following page.
- **Get Search Queries** — Export documentation search terms ordered by hit count (with CTR and top clicked page). Returns one page plus a cursor to fetch the next; there is no more-flag, so stop paging once next_cursor is null.
- **Get Unique Visitors** — Export per-path and site-wide approximate distinct visitor counts split by human vs AI traffic. Offset-paginated: returns one page plus a `has_more` flag and the effective `next_offset` to fetch the following page.
- **Get Update Status** — Get the status and details (queued / in_progress / success / failure, logs, commit, screenshot) of a triggered deployment update by its statusId. Poll this with the statusId returned by MINTLIFY_TRIGGER_UPDATE.
- **Send Agent Message** — Send a follow-up instruction to an existing, in-progress docs agent job (asynchronous). Use to refine or continue work on a job created by create_agent_job. Returns the updated AgentJob; poll get_agent_job for progress. No pagination.
- **Trigger Automation** — Trigger a custom-schedule automation (workflow) to run immediately. Returns the schemaId, instanceId and jobId of the launched run. Only custom-schedule automations are triggerable (others return 400). Requires a Mintlify plan that includes
- **Trigger Preview** — Create or update a preview deployment of the docs project for a Git branch (redeploys if a preview already exists for that branch). Returns a statusId to poll with MINTLIFY_GET_UPDATE_STATUS and a previewUrl. Requires a Mintlify plan that i
- **Trigger Update** — Queue a production deployment of the docs project from its configured branch. Returns a statusId to poll with MINTLIFY_GET_UPDATE_STATUS. Requires a Mintlify plan that includes deployments (otherwise the API returns 401 'Please upgrade to a

## Setup

1. Create or open a Switchy Project.
2. Open Integrations and connect Mintlify.
3. Authorise through api_key.
4. Teammates can now @-mention Mintlify tools in chat.

---
Last verified: 2026-09-03T02:00:04.194Z  
Canonical URL: https://switchy.build/directory/mcps/mintlify