Mintlify MCP connector

1. Install the SDK

   Node.js

   npm install @scalekit-sdk/node

   Python

   pip install scalekit

   Full SDK reference: Node.js | Python

2. 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>

3. Authorize and make your first call

   Node.js

   quickstart.ts

   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   
   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENV_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions
   
   const connector = 'mintlifymcp'
   const identifier = 'user_123'
   
   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Mintlify MCP:', link)
   process.stdout.write('Press Enter after authorizing...')
   await new Promise(r => process.stdin.once('data', r))
   
   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'mintlifymcp_get_session_state',
     toolInput: {},
   })
   console.log(result)

   Python

   quickstart.py

   import os
   from scalekit.client import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()
   
   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENV_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions
   
   connection_name = "mintlifymcp"
   identifier = "user_123"
   
   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Mintlify MCP:", link_response.link)
   input("Press Enter after authorizing...")
   
   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="mintlifymcp_get_session_state",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)

What you can do

Connect this agent connector to let your agent:

• Page write, edit — Fully overwrite a page’s MDX content on the current branch by path
• Update node, config — Update a navigation node’s properties in place by node ID, including page frontmatter fields like title, description, icon, or tag
• Search operations — Search the Admin MCP SDK for available methods by keyword to find the right operation before writing an execute script
• Save records — Flush branch changes to git by opening a pull request or committing directly, depending on the selected mode
• Read records — Read the full MDX content of a single page on the current branch by path, reflecting any in-session edits
• Node move — Reposition a navigation node by moving it to a new parent or changing its order among siblings

Tool list

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

mintlifymcp_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. 3 params ▾

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.

Name Type Required Description

branch string optional 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.

from string optional 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.

slug string optional 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_node # Insert a new node (page, group, tab, anchor, version, language, or product) into the navigation tree under the specified parent. 3 params ▾

Insert a new node (page, group, tab, anchor, version, language, or product) into the navigation tree under the specified parent.

Name Type Required Description

data string required No description.

parentId string required No description.

order integer optional No description.

mintlifymcp_delete_node # Remove a node and all its descendants from the navigation tree by node ID, optionally adding a redirect for deleted pages. 2 params ▾

Remove a node and all its descendants from the navigation tree by node ID, optionally adding a redirect for deleted pages.

Name Type Required Description

nodeId string required No description.

redirect string optional No description.

mintlifymcp_diff # Return the list of changes between the current session branch and the main branch. 0 params ▾

Return the list of changes between the current session branch and the main branch.

mintlifymcp_discard_session # End the current editing session without creating a pull request, discarding all unsaved changes. 0 params ▾

End the current editing session without creating a pull request, discarding all unsaved changes.

mintlifymcp_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. 4 params ▾

Apply a string-replace edit to a page's MDX body content. Use update_node to change frontmatter fields such as title or description.

Name Type Required Description

newString string required No description.

oldString string required No description.

path string required No description.

replaceAll boolean optional No description.

mintlifymcp_execute # Run TypeScript or JavaScript against the Admin MCP dashboard SDK in a sandboxed isolate to call workflows, deployment, billing, or analytics APIs. 1 param ▾

Run TypeScript or JavaScript against the Admin MCP dashboard SDK in a sandboxed isolate to call workflows, deployment, billing, or analytics APIs.

Name Type Required Description

code string required No description.

mintlifymcp_get_session_state # Return the current session state including the active branch name, edited files, and navigation diff. 0 params ▾

Return the current session state including the active branch name, edited files, and navigation diff.

mintlifymcp_list_branches # List all git branches available for the current deployment, optionally filtered by a query string. 1 param ▾

List all git branches available for the current deployment, optionally filtered by a query string.

Name Type Required Description

query string optional No description.

mintlifymcp_list_nodes # List navigation nodes from the current branch tree with optional filters for parent, type, language, version, tab, anchor, or product. 12 params ▾

List navigation nodes from the current branch tree with optional filters for parent, type, language, version, tab, anchor, or product.

Name Type Required Description

anchor string optional No description.

cursor string optional No description.

dropdown string optional No description.

item string optional No description.

language string optional No description.

limit integer optional No description.

parentId string optional No description.

product string optional No description.

recursive boolean optional No description.

tab string optional No description.

type string optional No description.

version string optional No description.

mintlifymcp_move_node # Reposition a navigation node by moving it to a new parent or changing its order among siblings. 3 params ▾

Reposition a navigation node by moving it to a new parent or changing its order among siblings.

Name Type Required Description

nodeId string required No description.

order integer optional No description.

parentId string optional No description.

mintlifymcp_read # Read the full MDX content of a single page on the current branch by path, reflecting any in-session edits. 1 param ▾

Read the full MDX content of a single page on the current branch by path, reflecting any in-session edits.

Name Type Required Description

path string required No description.

mintlifymcp_save # Flush branch changes to git by opening a pull request or committing directly, depending on the selected mode. 3 params ▾

Flush branch changes to git by opening a pull request or committing directly, depending on the selected mode.

Name Type Required Description

title string required No description.

body string optional No description.

mode string optional No description.

mintlifymcp_search # Find lines matching a substring or regex pattern across all pages on the current branch. 4 params ▾

Find lines matching a substring or regex pattern across all pages on the current branch.

Name Type Required Description

query string required No description.

caseSensitive boolean optional No description.

limit integer optional No description.

regex boolean optional No description.

mintlifymcp_search_operations # Search the Admin MCP SDK for available methods by keyword to find the right operation before writing an execute script. 2 params ▾

Search the Admin MCP SDK for available methods by keyword to find the right operation before writing an execute script.

Name Type Required Description

query string required No description.

limit integer optional No description.

mintlifymcp_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. 4 params ▾

Update top-level docs.json configuration fields or manage redirects. Use this to change site-level settings such as name, description, or theme.

Name Type Required Description

op string required No description.

docsConfig object optional No description.

redirect object optional No description.

source string optional No description.

mintlifymcp_update_node # Update a navigation node's properties in place by node ID, including page frontmatter fields like title, description, icon, or tag. 2 params ▾

Update a navigation node's properties in place by node ID, including page frontmatter fields like title, description, icon, or tag.

Name Type Required Description

data string required No description.

nodeId string required No description.

mintlifymcp_write_page # Fully overwrite a page's MDX content on the current branch by path. 2 params ▾

Fully overwrite a page's MDX content on the current branch by path.

Name Type Required Description

content string required No description.

path string required No description.