Where should I start: API, MCP, or Playground?

Start with Playground for quick testing, then use API docs for production integration. Use MCP if your agent framework supports tool-calling workflows.

How do I authenticate API requests?

Pass your MemBrain API key in the request headers as documented in the API reference. Keep keys server-side in production.

Which endpoint stores a memory and is it synchronous?

Use the Store a memory endpoint. Ingestion is asynchronous and returns a job id that you can poll for completion status.

How do I search and traverse graph relationships?

Use search endpoints for semantic recall and graph endpoints for neighborhood expansion, path finding, and traversal across linked memories.

Where can I test requests before coding integration?

Use the Interactive Playground under Docs to run request flows and inspect responses before wiring your app.

Semantic traversal — MemBrain API Reference

MEMBRAIN

REST API

Semantic traversal

Expand from a starting memory along edges matching a natural language query.

GET/api/v1/graph/traverse

Query Parameters

start_memory_idstringrequired

ID of the starting memory node

querystringrequired

Natural language query for edge similarity matching

max_hopsnumber

Maximum traversal depth

Max length: 2

edge_similarity_thresholdnumber

Minimum similarity score

Max length: 0.7

API Key

Stored locally, never sent to servers

Semantic traversal

const options = {  method: 'GET',  headers: {'X-API-Key': 'mb_live_xxx'},};fetch('https://api.mem-brain.io/api/v1/graph/traverse', options)  .then(res => res.json())  .then(res => console.log(res))  .catch(err => console.error(err));

{
  "nodes": [
    {
      "id": "mem_001",
      "content": "Auth uses JWT"
    },
    {
      "id": "mem_002",
      "content": "Refresh tokens rotate"
    }
  ],
  "edges": [
    {
      "source": "mem_001",
      "target": "mem_002",
      "description": "authentication flow"
    }
  ]
}