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, talk to your Realm agents, and manage your Realm content 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.

Manage your content

Create and edit documents, folders, tags, projects, artifacts and comments, and update the rows, status and access of your RFPs.

Run your automations

List and configure agents, workflows and skills, run agents and workflows, and read the results of a run.
The tools carry the same names as Ask Realm, and every action runs as you: your AI tool can only see and change what you can in Realm. When you connect, the consent screen lists what the connection can do.

​
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:
Or add this snippet to your project’s .mcp.json or your user-level Claude Code config:
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