Let users access your docs and APIs through their favorite AI tools
/mcp
path. For example, Mintlify’s MCP server is available at https://mintlify.com/docs/mcp
.
You can see and copy your MCP server URL in your dashboard.
search
tool by default, allowing users to query information from your docs in other tools.
If you have a Pro or Enterprise plan, you can expose endpoints from your OpenAPI specification as MCP tools.
To expose endpoints as MCP tools, use the mcp
object within the x-mint
extension at either the file or endpoint level. For example, the Mintlify MCP server includes tools to create assistant chats, get status updates, and trigger updates.
MCP servers follow a security-first approach where API endpoints are not exposed by default. You must explicitly enable endpoints to make them available as MCP tools. Only expose endpoints that are safe for public access through AI tools.
securitySchemes
and securityRequirement
. Any keys are handled directly by the tool and not stored or processed by Mintlify.
If a user asks their AI tool to call a protected endpoint, the tool will request the necessary authentication credentials from the user at that moment.
MCP server only shows search tool
x-mint.mcp.enabled: true
.Authentication issues
securitySchemes
definitions.Tool descriptions missing or unclear
summary
and description
fields to your endpoints.