Connect AI agents to the Mintlify MCP server

Vendor MCP

The Mintlify MCP connector routes your AI agent's tool calls to Mintlify's own MCP server through Scalekit. Each user signs in to Mintlify once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 19 tools.

Tools: 19
What they doRead · write · destructive: 8 · 7 · 48 read7 write4 destructive
Users sign in with: OAuth
OAuth app: Scalekit's or your own

Setup

Install the SDK
- Node.js
- Python
Terminal window
npm install @scalekit-sdk/node dotenv
Terminal window
pip install scalekit-sdk-python python-dotenv
Set your credentials
Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.
.env
```
SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
SCALEKIT_CLIENT_ID=<your-client-id>
SCALEKIT_CLIENT_SECRET=<your-client-secret>
```
Create the Mintlify MCP connection
In AgentKit > Connections, create a Mintlify MCP connection. The name you give it is the connection_name your code passes. See Configure connections.
Scalekit credentials are available for Mintlify MCP server, so you don't need to register an OAuth app.

Authorize a user and make your first call

Node.js
Python

1
import { ScalekitClient } from '@scalekit-sdk/node'
2
import 'dotenv/config'
3
import { createInterface } from 'node:readline/promises'
4

5
const scalekit = new ScalekitClient(
6
  process.env.SCALEKIT_ENVIRONMENT_URL,
7
  process.env.SCALEKIT_CLIENT_ID,
8
  process.env.SCALEKIT_CLIENT_SECRET,
9
)
10
const actions = scalekit.actions
11

12
const connector = 'mintlifymcp'
13
const identifier = 'user_123'
14

15
// Generate an authorization link for the user
16
const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
17
console.log('Authorize Mintlify MCP:', link)
18
const rl = createInterface({ input: process.stdin, output: process.stdout })
19
await rl.question('Press Enter after authorizing...')
20
rl.close()
21

22
// Make your first call
23
const result = await actions.executeTool({
24
  connector,
25
  identifier,
26
  toolName: 'mintlifymcp_diff',
27
  toolInput: {},
28
})
29
console.log(result)

npx tsx quickstart.mts

1
import os
2
from scalekit import ScalekitClient
3
from dotenv import load_dotenv
4
load_dotenv()
5

6
scalekit_client = ScalekitClient(
7
    env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
8
    client_id=os.getenv("SCALEKIT_CLIENT_ID"),
9
    client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
10
)
11
actions = scalekit_client.actions
12

13
connection_name = "mintlifymcp"
14
identifier = "user_123"
15

16
# Generate an authorization link for the user
17
link_response = actions.get_authorization_link(
18
    connection_name=connection_name,
19
    identifier=identifier,
20
)
21
print("Authorize Mintlify MCP:", link_response.link)
22
input("Press Enter after authorizing...")
23

24
# Make your first call
25
result = actions.execute_tool(
26
    tool_input={},
27
    tool_name="mintlifymcp_diff",
28
    connection_name=connection_name,
29
    identifier=identifier,
30
)
31
print(result)

python quickstart.py

Each user signs in once. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool

Try in Playground Request a tool

mintlifymcp_diffReturn the list of changes between the current session branch and the main branch.Read-only
Diff
Return the list of changes between the current session branch and the main branch.
Inputs
This tool takes no inputs.
mintlifymcp_get_session_stateReturn the current session state including the active branch name, edited files, and navigation diff.Read-only
Get Session State
Return the current session state including the active branch name, edited files, and navigation diff.
Inputs
This tool takes no inputs.
mintlifymcp_list_branchesList all git branches available for the current deployment, optionally filtered by a query string.Read-only
List Branches
List all git branches available for the current deployment, optionally filtered by a query string.
Inputs
querystring
No description.
mintlifymcp_list_deploymentsList the deployments this connection is authorized for, returning each subdomain and name.Read-only
List Deployments
List the deployments this connection is authorized for, returning each subdomain and name. Use this to discover which subdomain to checkout before editing.
Inputs
This tool takes no inputs.
mintlifymcp_list_nodesList navigation nodes from the current branch tree with optional filters for parent, type, language, version, tab, anchor, or product.Read-only
List Nodes
List navigation nodes from the current branch tree with optional filters for parent, type, language, version, tab, anchor, or product.
Inputs
anchorstring
No description.
cursorstring
No description.
dropdownstring
No description.
itemstring
No description.
languagestring
No description.
limitinteger
No description.
parentIdstring
No description.
productstring
No description.
recursiveboolean
No description.
tabstring
No description.
typestring
No description.
versionstring
No description.
mintlifymcp_readRead the full MDX content of a single page on the current branch by path, reflecting any in-session edits.Read-only
Read
Read the full MDX content of a single page on the current branch by path, reflecting any in-session edits.
Inputs
pathstringrequired
No description.
mintlifymcp_searchFind lines matching a substring or regex pattern across all pages on the current branch.Read-only
Search
Find lines matching a substring or regex pattern across all pages on the current branch.
Inputs
querystringrequired
No description.
caseSensitiveboolean
No description.
limitinteger
No description.
regexboolean
No description.
mintlifymcp_search_code_operationsLexical (BM25) search over the Admin MCP code-mode SDK to find the right SDK method for a task before writing an execute_code script.Read-only
Search Code Operations
Lexical (BM25) search over the Admin MCP code-mode SDK to find the right SDK method for a task before writing an execute_code script.
Inputs
querystringrequired
No description.
limitinteger
No description.
namespacestring
No description.one of workflowsdeploymentmembersbillingintegrationsanalytics
mintlifymcp_checkoutBind the current session to a git branch, creating it if it does not exist.Write
Checkout
Bind the current session to a git branch, creating it if it does not exist. Returns the branch name, editor URL, and a toolkit list of recommended tools to use next.
Inputs
branchstring
Specific branch to bind to. If it exists in git the session attaches to it without creating a branch; if not, it is created from `from`. Cannot be the deploy branch. Omit to auto-generate a fresh `admin-mcp/<slug>-<7-char-sha>` branch.
fromstring
Base branch to fork from when creating a new branch. Defaults to the deployment's configured deploy branch (typically `main`). The new branch is created at this branch's latest commit.
slugstring
Human-readable slug used to name an auto-generated branch as `admin-mcp/<slug>-<7-char-base-sha>`. Ignored when `branch` is provided. If omitted and `branch` is also omitted, the branch is auto-named `admin-mcp/<sessionTokenPrefix>` and is not human-recognizable. Use a stable, kebab-case slug (e.g. `add-tips-page`).
mintlifymcp_create_nodeInsert a new node (page, group, tab, anchor, version, language, or product) into the navigation tree under the specified parent.Write
Create Node
Insert a new node (page, group, tab, anchor, version, language, or product) into the navigation tree under the specified parent.
Inputs
datastringrequired
No description.
parentIdstringrequired
No description.
orderinteger
No description.
mintlifymcp_edit_pageApply a string-replace edit to a page's MDX body content.Write
Edit Page
Apply a string-replace edit to a page's MDX body content. Use update_node to change frontmatter fields such as title or description.
Inputs
newStringstringrequired
No description.
oldStringstringrequired
No description.
pathstringrequired
No description.
replaceAllboolean
No description.
mintlifymcp_move_nodeReposition a navigation node by moving it to a new parent or changing its order among siblings.Write
Move Node
Reposition a navigation node by moving it to a new parent or changing its order among siblings.
- Idempotent
Inputs
nodeIdstringrequired
No description.
orderinteger
No description.
parentIdstring
No description.
mintlifymcp_update_configUpdate top-level docs.json configuration fields or manage redirects.Write
Update Config
Update top-level docs.json configuration fields or manage redirects. Use this to change site-level settings such as name, description, or theme.
- Idempotent
Inputs
opstringrequired
No description.one of add_redirectremove_redirectset
docsConfigobject
No description.
redirectobject
No description.
sourcestring
No description.
mintlifymcp_update_nodeUpdate a navigation node's properties in place by node ID, including page frontmatter fields like title, description, icon, or tag.Write
Update Node
Update a navigation node's properties in place by node ID, including page frontmatter fields like title, description, icon, or tag.
- Idempotent
Inputs
datastringrequired
No description.
nodeIdstringrequired
No description.
mintlifymcp_write_pageFully overwrite a page's MDX content on the current branch by path.Write
Write Page
Fully overwrite a page's MDX content on the current branch by path.
- Idempotent
Inputs
contentstringrequired
No description.
pathstringrequired
No description.
mintlifymcp_delete_nodeRemove a node and all its descendants from the navigation tree by node ID, optionally adding a redirect for deleted pages.Destructive
Delete Node
Remove a node and all its descendants from the navigation tree by node ID, optionally adding a redirect for deleted pages.
- Idempotent
Inputs
nodeIdstringrequired
No description.
redirectstring
No description.
mintlifymcp_discard_sessionEnd the current editing session without creating a pull request, discarding all unsaved changes.Destructive
Discard Session
End the current editing session without creating a pull request, discarding all unsaved changes.
- Idempotent
Inputs
This tool takes no inputs.
mintlifymcp_execute_codeRun TypeScript/JavaScript against the Admin MCP dashboard SDK inside a sandboxed Cloudflare isolate to call workflows, deployment, billing, or analytics APIs.Destructive
Execute Code
Run TypeScript/JavaScript against the Admin MCP dashboard SDK inside a sandboxed Cloudflare isolate to call workflows, deployment, billing, or analytics APIs.
Inputs
codestringrequired
No description.
summarystringrequired
No description.
mintlifymcp_saveFlush branch changes to git by opening a pull request or committing directly, depending on the selected mode.Destructive
Save
Flush branch changes to git by opening a pull request or committing directly, depending on the selected mode.
Inputs
titlestringrequired
No description.
bodystring
No description.
modestring
No description.one of prcommit

Setup

Install the SDK

Set your credentials

Create the Mintlify MCP connection

Authorize a user and make your first call

Tools

Call it

Returns

Diff

Inputs

Get Session State

Inputs

List Branches

Inputs

List Deployments

Inputs

List Nodes

Inputs

Read

Inputs

Search

Inputs

Search Code Operations

Inputs

Checkout

Inputs

Create Node

Inputs

Edit Page

Inputs

Move Node

Inputs

Update Config

Inputs

Update Node

Inputs

Write Page

Inputs

Delete Node

Inputs

Discard Session

Inputs

Execute Code

Inputs

Save

Inputs

Related: other Developer Tools connectors