Skip to content

Docs MCP (1.0.0)

Connect AI assistants to your project's Docs MCP server to browse API descriptions, inspect endpoints, and search documentation content.

Base URL: The Docs MCP server is available at /mcp on your project host. If your project is deployed under a path prefix, prepend that prefix to /mcp.

Public endpoint: Projects that enable mcp.docs.publicEndpoint also serve /mcp-public. That endpoint requires no login and serves only the content that RBAC grants to the anonymous team.

For setup and configuration guidance, see Model Context Protocol server and MCP configuration reference.

Authentication

Public projects can expose Docs MCP without authentication.

If your project requires login (rbac or requiresLogin configured), Docs MCP Server requires the user to authenticate using the configured method. This requirement ensures that AI Agents can only access APIs and operations the authenticated user has permission to view.

The whoami tool is only available when authentication handling is enabled for the Docs MCP server.

The /mcp-public endpoint never challenges for authentication. It ignores any credentials the client sends and serves only the content available to the anonymous team.

Token validation

Every request carries its own token, and the server validates that token on each request. The server verifies the token signature and checks that the token hasn't expired. If your identity provider configuration sets audience, the aud claim in the token must match one of those values. If users sign in through Reunite, the token must also name this project.

A token isn't sufficient to determine what content is served. RBAC decides which content and API descriptions the request can reach.

Download OpenAPI description
Languages
MCP server
Protocol version2025-06-18
Capabilities
logging tools
Servers
Mock server
https://adakg5apsdyszfseyqan47zfz40qtfzf.lambda-url.us-east-1.on.aws/_mock/docs/realm/customization/mcp-server/openapi
Project Docs MCP endpoint.
https://{projectHost}/mcp
Public Docs MCP endpoint, served only when `mcp.docs.publicEndpoint` is enabled. It requires no authentication and serves only content available to the `anonymous` team.
https://{projectHost}/mcp-public