Mintlify MCP

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:

• Search code operations, 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
• List deployments, nodes, branches — List the deployments this connection is authorized for, returning each subdomain and name
• Execute code — Run TypeScript/JavaScript against the Admin MCP dashboard SDK inside a sandboxed Cloudflare isolate to call workflows, deployment, billing, or analytics APIs
• 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
• Save records — Flush branch changes to git by opening a pull request or committing directly, depending on the selected mode

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.

NameTypeRequiredDescription

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

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

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

NameTypeRequiredDescription

datastringrequiredNo description.

parentIdstringrequiredNo description.

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

NameTypeRequiredDescription

nodeIdstringrequiredNo description.

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

NameTypeRequiredDescription

newStringstringrequiredNo description.

oldStringstringrequiredNo description.

pathstringrequiredNo description.

replaceAllbooleanoptionalNo description.

mintlifymcp_execute#[STALE: upstream tool "execute" no longer present as of 2026-08-19; upstream MCP now exposes "execute_code" instead] Run TypeScript or JavaScript against the Admin MCP dashboard SDK in a sandboxed isolate to call workflows, deployment, billing, or analytics APIs.1 param▾

[STALE: upstream tool "execute" no longer present as of 2026-08-19; upstream MCP now exposes "execute_code" instead] Run TypeScript or JavaScript against the Admin MCP dashboard SDK in a sandboxed isolate to call workflows, deployment, billing, or analytics APIs.

NameTypeRequiredDescription

codestringrequiredNo description.

mintlifymcp_execute_code#Run TypeScript/JavaScript against the Admin MCP dashboard SDK inside a sandboxed Cloudflare isolate to call workflows, deployment, billing, or analytics APIs.2 params▾

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

NameTypeRequiredDescription

codestringrequiredNo description.

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

NameTypeRequiredDescription

querystringoptionalNo description.

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

List the deployments this connection is authorized for, returning each subdomain and name. Use this to discover which subdomain to checkout before editing.

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.

NameTypeRequiredDescription

anchorstringoptionalNo description.

cursorstringoptionalNo description.

dropdownstringoptionalNo description.

itemstringoptionalNo description.

languagestringoptionalNo description.

limitintegeroptionalNo description.

parentIdstringoptionalNo description.

productstringoptionalNo description.

recursivebooleanoptionalNo description.

tabstringoptionalNo description.

typestringoptionalNo description.

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

NameTypeRequiredDescription

nodeIdstringrequiredNo description.

orderintegeroptionalNo description.

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

NameTypeRequiredDescription

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

NameTypeRequiredDescription

titlestringrequiredNo description.

bodystringoptionalNo description.

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

NameTypeRequiredDescription

querystringrequiredNo description.

caseSensitivebooleanoptionalNo description.

limitintegeroptionalNo description.

regexbooleanoptionalNo description.

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

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.

NameTypeRequiredDescription

querystringrequiredNo description.

limitintegeroptionalNo description.

namespacestringoptionalNo description.

mintlifymcp_search_operations#[STALE: upstream tool "search_operations" no longer present as of 2026-08-19; upstream MCP now exposes "search_code_operations" instead] Search the Admin MCP SDK for available methods by keyword to find the right operation before writing an execute script.2 params▾

[STALE: upstream tool "search_operations" no longer present as of 2026-08-19; upstream MCP now exposes "search_code_operations" instead] Search the Admin MCP SDK for available methods by keyword to find the right operation before writing an execute script.

NameTypeRequiredDescription

querystringrequiredNo description.

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

NameTypeRequiredDescription

opstringrequiredNo description.

docsConfigobjectoptionalNo description.

redirectobjectoptionalNo description.

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

NameTypeRequiredDescription

datastringrequiredNo description.

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

NameTypeRequiredDescription

contentstringrequiredNo description.

pathstringrequiredNo description.