@open-mcp/mintlify

Installing

First set the environment variables as shell variables:

API_KEY='...'

Then use the OpenMCP config CLI to add the server to your MCP client:

Claude desktop

npx @open-mcp/config add mintlify \
  ~/Library/Application\ Support/Claude/claude_desktop_config.json \
  --API_KEY=$API_KEY

Cursor

Run this from the root of your project directory or, to add to all cursor projects, run it from your home directory ~.

npx @open-mcp/config add mintlify \
  .cursor/mcp.json \
  --API_KEY=$API_KEY

Other

npx @open-mcp/config add mintlify \
  /path/to/client/config.json \
  --API_KEY=$API_KEY

Manually

If you don't want to use the helper above, add the following to your MCP client config manually:

{
  "mcpServers": {
    "mintlify": {
      "command": "npx",
      "args": ["-y", "@open-mcp/mintlify"],
      "env": {"API_KEY":"..."}
    }
  }
}

Customizing the base URL

Set the environment variable OPEN_MCP_BASE_URL to override each tool's base URL. This is useful if your OpenAPI spec defines a relative server URL.

Other environment variables

• API_KEY

Inspector

Needs access to port 3000 for running a proxy server, will fail if http://localhost:3000 is already busy.

npx -y @modelcontextprotocol/inspector npx -y @open-mcp/mintlify

• Open http://localhost:5173
• Transport type: STDIO
• Command: npx
• Arguments: -y @open-mcp/mintlify
• Click Environment Variables to add
• Click Connect

It should say MCP Server running on stdio in red.

• Click List Tools

Tools

expandSchema

Expand the input schema for a tool before calling the tool

Input schema

{
  toolName: z.string(),
  jsonPointers: z.array(z.string().startsWith("/").describe("The pointer to the JSON schema object which needs expanding")).describe("A list of JSON pointers"),
}

get_plants

Environment variables

• API_KEY

Input schema

{
  "limit": z.number().int().describe("The maximum number of results to return").optional()
}

post_plants

Environment variables

• API_KEY

Input schema

{}

delete_plants_id_

Environment variables

• API_KEY

Input schema

{
  "id": z.number().int().describe("ID of plant to delete")
}