CerebeCerebe Docs

Connect AI Tools

Use Cerebe with Claude Code, Cursor, and other MCP-compatible tools.

Connect AI Tools

Cerebe exposes an MCP (Model Context Protocol) server, making it instantly accessible to AI coding tools like Claude Code, Cursor, Windsurf, and any MCP-compatible client.

Why MCP?

MCP lets your AI coding assistant directly access Cerebe's memory, knowledge, and cognitive services. Instead of copy-pasting API responses, your AI tool can:

  • Search user memories to understand context before generating code
  • Ingest knowledge from your codebase into the graph
  • Track cognitive profiles to personalize agent behavior
  • Query learning patterns to adapt content delivery

Connect Claude Code

Add to your ~/.claude/settings.json:

{
  "mcpServers": {
    "cerebe": {
      "command": "npx",
      "args": ["-y", "@cerebe/mcp-server"],
      "env": {
        "CEREBE_API_KEY": "ck_live_..."
      }
    }
  }
}

Then use natural language in Claude Code:

> Search cerebe memories for user_123's learning preferences
> Ingest this conversation transcript into cerebe memory
> What's the current PLRE state for user_456?

Connect Cursor

Add to your .cursor/mcp.json:

{
  "mcpServers": {
    "cerebe": {
      "command": "npx",
      "args": ["-y", "@cerebe/mcp-server"],
      "env": {
        "CEREBE_API_KEY": "ck_live_..."
      }
    }
  }
}

Available MCP Tools

ToolDescription
memory_storeStore a memory with type, importance, and metadata
memory_searchSemantic search across all memories for an entity
memory_harvestExtract memories from a conversation transcript
knowledge_queryQuery the knowledge graph for entities and relationships
knowledge_ingestAdd content to the knowledge graph
profile_getGet a user's cognitive profile
plre_stateGet current PLRE learning phase
plre_transitionTrigger a phase transition
trace_ingestIngest an agent execution trace

Direct API Usage

If your tool doesn't support MCP, you can use the REST API directly:

curl -X POST https://api.cerebe.ai/api/v1/memory/search \
  -H "X-API-Key: ck_live_..." \
  -H "Content-Type: application/json" \
  -d '{"query": "user preferences", "entity_id": "user_123", "limit": 5}'

Next Steps

On this page