Documentation

Getting Started

Merkraum is a knowledge memory platform for AI agents and teams. It helps you capture durable knowledge, structure context, and keep shared understanding available across workflows.

Create an account at app.merkraum.de to get started.

Knowledge Graph

The Knowledge Graph organizes your content into entities and relationships. Entities represent the people, systems, concepts, or artifacts you track. Relationships connect entities so you can explore how knowledge is linked and navigate from one context cluster to another in graph view.

Beliefs

Beliefs are named assertions with confidence scores. Confidence reflects how strongly a belief is supported by your current evidence. Contradiction detection highlights beliefs that conflict, helping teams review uncertainty and resolve inconsistencies quickly.

API / MCP

Merkraum supports two integration methods: the Model Context Protocol (MCP) for AI agents, and a REST API for programmatic access. Both use Personal Access Tokens (PATs) for authentication.

MCP Setup

Add Merkraum to your AI agent by configuring your MCP client (e.g. Claude Desktop, Claude Code). Your agent can then search knowledge, ingest new information, traverse the graph, and track beliefs directly.

MCP configuration (add to your client config):

{
  "mcpServers": {
    "merkraum": {
      "url": "https://mcp.merkraum.de/mcp",
      "headers": {
        "Authorization": "Bearer mk_pat_YOUR_TOKEN"
      }
    }
  }
}

REST API

All Merkraum features are available via REST API. Create a Personal Access Token in Settings, then use it as a Bearer token.

Ingest knowledge:

curl -X POST https://api.merkraum.de/api/ingest/text \
  -H "Authorization: Bearer mk_pat_YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"text": "Our Q1 deployment achieved 99.9% uptime."}'

Search knowledge:

curl "https://api.merkraum.de/api/search?q=deployment+uptime" \
  -H "Authorization: Bearer mk_pat_YOUR_TOKEN"

List beliefs:

curl https://api.merkraum.de/api/beliefs \
  -H "Authorization: Bearer mk_pat_YOUR_TOKEN"

Create tokens in Settings → Personal Access Tokens. Tokens are shown once at creation — copy immediately.