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.

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

NameTypeRequiredDescription

codestringrequiredNo 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_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_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.

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.