Mintlify MCP: edit, publish and measure your docs from chat

Connect Mintlify to Claude, Cursor or ChatGPT

1. 1Click Connect Mintlify free and sign in with your Mintlify account.
2. 2Decide where your AI app stops. Analytics, and edits that arrive as a pull request, leave review to you; a production deployment doesn't. Switch off the tools that publish or deploy and keep the rest.
3. 3Add ContextGate to your AI app as a connector or MCP server. The steps for each app are on the Works with page.
4. 4Ask your AI app for this month's top docs searches with the lowest click-through, then open Activity to see the analytics call.

Docs work for Claude, ChatGPT or Cursor

• Edit pages, navigation and settings, or start the docs agent from a prompt; it opens a pull request when it changes files.
• See which pages get thumbs up or down, and read the feedback comments.
• Export search terms with click-through rates to find gaps in your docs.
• Compare page views and visitors from people and from AI traffic.
• Trigger a preview deployment for a branch and check its status.

Review before your docs go live

• Switch off production deploys and keep previews, so changes are checked before readers see them.
• Policies check every call, so an API key pasted into a docs edit can be blocked.
• Activity records every edit, agent job and deploy your AI apps start.

What you get with Mintlify and ContextGate

• Your AI apps can use MintlifyClaude, Cursor, ChatGPT and other AI apps reach Mintlify through the one ContextGate connection you add to them.
• You choose which tools they can useSwitch off any Mintlify tool you don't want used. It's hidden from your AI apps and refused if called.
• Every call is checked and recordedYour policies check each call (for example, personal data is hidden and secrets are blocked), and Activity keeps a record of it.

ContextGate sees only the tool calls that go through it, not your AI app's built-in tools or your chats.

Mintlify tools

Examples of what your AI apps can do in Mintlify. You'll see the exact list of tools after you connect it.

• Create Agent JobStart 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
• Get Agent JobRetrieve 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 StatsGet 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 ConversationsExport 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 t
• Get FeedbackExport 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 PageGet 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 i
• Get Page ViewsExport 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 fet
• Get Search QueriesExport 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 VisitorsExport 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 f
• Get Update StatusGet 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_TRIGG
• Send Agent MessageSend 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_agen
• Trigger AutomationTrigger 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)
• Trigger PreviewCreate 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 pre
• Trigger UpdateQueue 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