Skip to main content

​
Overview

Realm works as an MCP (Model Context Protocol) server, so any MCP-compatible AI tool can search your knowledge base and talk to your Realm agents directly, without copy-pasting context back and forth.
This page is for connecting your AI tools to Realm. If you are an admin looking to give Realm agents access to external MCP servers (like Linear or Notion), see Connect MCP servers to Realm instead.

​
What you can do

Search your knowledge

Let your AI tool search your Realm knowledge base and pull in relevant documents as context for any prompt.

Talk to your agents

Chat with your Realm agents from inside the tools you already use, so you can trigger them without leaving your editor or assistant.

​
Connect your tool

Any MCP-compatible client can connect to Realm at https://app.withrealm.com/api/mcp. Pick your tool below for the exact steps.
Replace app.withrealm.com with your own Realm URL if your organization uses a custom subdomain.
Run this from any project:
claude mcp add --transport http realm https://app.withrealm.com/api/mcp
Or add this snippet to your project’s .mcp.json or your user-level Claude Code config:
{
  "mcpServers": {
    "realm": {
      "type": "http",
      "url": "https://app.withrealm.com/api/mcp"
    }
  }
}
See Claude Code’s MCP docs for details.

​
Authentication

You do not need an API key. The first time your AI tool connects, Realm opens a browser window so you can sign in with OAuth, the same way you sign into Realm in any other app. After that, your tool stays connected.

Connect MCP servers to Realm

Add external MCP servers so your Realm agents can use them

Browser extension

Search and chat with Realm from any webpage