MCP server generation is available on Pro and Enterprise plans.

​
About MCP servers

The Model Context Protocol (MCP) is an open protocol that creates standardized connections between AI applications and external services, like documentation. Mintlify generates an MCP server from your documentation and OpenAPI specifications, preparing your content for the broader AI ecosystem where any MCP client (like Claude, Cursor, Goose, and others) can connect to your documentation and APIs. Your MCP server exposes tools for AI applications to search your documentation and interact with your APIs.

​
Accessing your MCP server

MCP servers can only be generated for public documentation. Documentation behind end-user authentication cannot be accessed for server generation.
Your MCP server is automatically generated and hosted at your documentation URL with the /mcp path. For example, Mintlify’s MCP server is available at https://mintlify.com/docs/mcp.

​
Configuring your MCP server

All MCP servers include the search tool by default, allowing users to query information from your docs in other tools. If you have an OpenAPI specification, you can expose specific endpoints as MCP tools by using the x-mcp extension at either the file or endpoint level. For example, the Mintlify MCP server includes tools to get status updates, trigger updates, and create assistant chats.

​
File-level configuration

Enable MCP for all endpoints in an OpenAPI specification file: 
{
  "openapi": "3.1.0",
  "x-mcp": {
    "enabled": true
  },
  // Other OpenAPI content
}

​
Endpoint-level configuration

Enable MCP for specific endpoints only: 
{
  "paths": {
    "/api/v1/users": {
      "x-mcp": {
        "enabled": true
      },
      // Endpoint configuration
    }
  }
}

​
Using your MCP server

Your users must connect your MCP server to their preferred AI tools.
  1. Make your MCP server URL publicly available.
  2. Users copy your MCP server URL and add it to their tools.
  3. The tools will have standardized access to your documentation and API endpoints.

​
Claude

To use your MCP server with Claude:
1

Add your MCP server to Claude

  1. Navigate to the Connectors page in the Claude settings.
  2. Select Add custom connector.
  3. Add your MCP server name and URL.
  4. Select Add.
2

Access your MCP server in your chat

  1. When using Claude, select the attachments button (the plus icon).
  2. Select your MCP server.
  3. Query Claude with your MCP server as context.
See the Model Context Protocol documentation for more details.

​
Cursor

To connect your MCP server to Cursor:
1

Open MCP settings

  1. Use Command + Shift + P (Ctrl + Shift + P on Windows) to open the command palette.
  2. Search for “Open MCP settings”.
  3. Select Add custom MCP. This will open the mcp.json file.
2

Configure your server

In mcp.json, configure your server:
mcp.json example
{
  "mcpServers": {
    "server-name": {
      "url": "https://your-docs-site.com/mcp"
    }
  }
}
3

Test the connection

In Cursor’s chat, you can ask “What tools do you have available?” Cursor should have your documentation search and any configured API endpoints.
See Installing MCP servers in the Cursor documentation for more details.

​
Authentication

When using API endpoints through your MCP server, AI tools will prompt users for their API keys as needed. These keys are handled directly by the tool and not stored or processed by Mintlify. If a user asks their AI tool to demonstrate an API call, it will request the necessary authentication credentials from the user at that moment.

​
Monitoring your MCP server

You can view all available MCP tools in the Available tools section of the MCP Server page in your dashboard.
MCP dashboard with Available tools section emphasized