MCP Server

BaseLayer exposes your knowledge graph via MCP (Model Context Protocol). Any MCP-compatible client can connect to search, store, and recall your knowledge.

Connect via OAuth (recommended)

The easiest way to connect any MCP client to BaseLayer is via OAuth. No API keys needed.

Remote MCP (Claude.ai, ChatGPT, etc.)

For cloud-based AI tools that support remote MCP:

In your AI tool’s settings, add a new MCP integration
Enter the server URL:
https://api.baselayer.id/mcp
You’ll be redirected to BaseLayer to sign in and authorize the connection
Click Allow — done

CLI tools (Claude Code, Gemini CLI, etc.)

CLI-based tools connect to the remote MCP endpoint via SSE:

# Claude Code
claude mcp add --transport sse baselayer https://api.baselayer.id/mcp

# Gemini CLI
gemini mcp add baselayer https://api.baselayer.id/mcp

IDE tools (Cursor, Windsurf, Copilot)

Add BaseLayer to your IDE’s MCP configuration file:

{
  "mcpServers": {
    "baselayer": {
      "url": "https://api.baselayer.id/mcp"
    }
  }
}

See specific setup guides:

Available tools

Once connected, your AI can use these tools:

Querying

Tool	What it does
ask_question	Ask a natural language question and get a synthesized answer from your memory

Searching

Tool	What it does
memory_search	Semantic search across entities and fact edges
get_entity	Fetch a full entity dossier (overview, facts, timeline, relations)
get_entity_relations	Explore connections between entities
get_entity_provenance	Trace where a piece of knowledge came from
list_entities	Browse all entities of a given type
recent_conversations	Load recent conversation context
retrieve_evidence	Search raw conversation history for exact quotes

Writing

Tool	What it does
record_memory	Store a new observation or memory
vault_fact	Assert a specific fact connecting two entities
update_plan	Create or update a persistent plan scratchpad

OAuth scopes

MCP clients are granted the mcp:tools scope by default, which provides access to all available tools.

Verify the connection

Ask your AI:

“What do you know about me?”

It should call ask_question and return knowledge from your memory.

Advanced: Manual API Key Setup

OAuth is recommended for most users. Only use API keys for custom integrations or self-built MCP clients.

Go to baselayer.id/credentials
Click Create API Key
Copy the key and configure your MCP client:

{
  "mcpServers": {
    "baselayer": {
      "url": "https://api.baselayer.id/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

API keys are for advanced integrations. OAuth is simpler and more secure for standard MCP clients.

​MCP Server

​Connect via OAuth (recommended)

​Remote MCP (Claude.ai, ChatGPT, etc.)

​CLI tools (Claude Code, Gemini CLI, etc.)

​IDE tools (Cursor, Windsurf, Copilot)

​Available tools

​Querying

​Searching

​Writing

​OAuth scopes

​Verify the connection

MCP Server

Connect via OAuth (recommended)

Remote MCP (Claude.ai, ChatGPT, etc.)

CLI tools (Claude Code, Gemini CLI, etc.)

IDE tools (Cursor, Windsurf, Copilot)

Available tools

Querying

Searching

Writing

OAuth scopes

Verify the connection