Model Context Protocol (MCP) is a standard that enables applications to provide context to large language models (LLMs). With MCP servers, AI assistants can retrieve additional information relevant to a user's query.
Realm provides built-in MCP server capabilities that expose your API Docs to AI assistants.
- Real-time API guidance — users receive accurate, contextual help about API endpoints and operations.
- Secure API access — AI assistants can make authenticated requests to act on behalf of a user.
- Dynamic documentation — AI assistants can extract and explain API reference content based on user needs.
Use the Docs MCP server to explore and discover APIs in your project. For the current MCP endpoint details, authentication semantics, server metadata, and tool schemas, see the Docs MCP reference.
After you enable the Docs MCP server in configuration, it is available at /mcp on your project root URL. For example: https://example.com/mcp.
Users can connect their preferred AI tools that support MCP (for example, Cursor, Claude Code and VS Code) to your MCP server.
- Enable the MCP server in your configuration.
- Copy your MCP server URL and add it to your tool.
After connecting, the tool can access your OpenAPI documentation.
- In Cursor, open the command palette.
- macOS:
Command + Shift + P - Windows/Linux:
Ctrl + Shift + P
- macOS:
- Type "Open MCP settings" in the command palette.
- Select "Add custom MCP".
Cursor opens the mcp.json file.
- In
mcp.json, add your server configuration:
{
"mcpServers": {
"example-mcp": {
"url": "https://example.com/mcp"
}
}
}Optionally, you can also pass additional headers that will be sent with each request:
{
"mcpServers": {
"example-mcp": {
"url": "https://example.com/mcp",
"headers": {
"Authorization": "Basic MTIzOjEyMw=="
}
}
}
}Save the
mcp.jsonfile.Return to MCP settings and confirm the connection. If authentication is required, select Needs login and complete the sign‑in flow. After connecting, Cursor displays the list of available tools.
In Cursor chat (Agent mode), ask a question that triggers an MCP tool.
- MCP configuration reference - Configure MCP for your project