MCP Tools Reference
MuninnDB ships with 11 MCP (Model Context Protocol) tools. Once configured, these appear in Claude, Cursor, and any MCP-compatible agent as native tools.
muninn_store Store a new engram. The agent provides concept (what it's about), content (the information), optional tags, and confidence.
| Parameter | Type | Required | Description |
|---|---|---|---|
| concept | string | ✓ | What this memory is about |
| content | string | ✓ | The information to remember |
| tags | []string | — | Labels for filtering |
| confidence | float | — | 0.0–1.0, default 0.8 |
muninn_activate Primary retrieval. Find the N most relevant memories for a context string. This runs the full 6-phase cognitive pipeline.
| Parameter | Type | Required | Description |
|---|---|---|---|
| context | string | ✓ | The question or situation |
| limit | int | — | Max results, default 10 |
| tags | []string | — | Filter by tags |
muninn_search Full-text search across engrams using BM25. Faster than activate but no cognitive scoring.
| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | ✓ | Search query |
| limit | int | — | Max results, default 20 |
muninn_get Get a specific engram by ID. Returns full record including associations and decay score.
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | ✓ | Engram ULID |
muninn_update Update an existing engram's content, confidence, or state.
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | ✓ | Engram ULID |
| content | string | — | Updated content |
| confidence | float | — | Updated confidence |
| state | string | — | New lifecycle state |
muninn_archive Archive an engram. It becomes excluded from normal activation but preserved for historical queries.
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | ✓ | Engram ULID |
muninn_list List engrams with optional filtering by tags or state.
| Parameter | Type | Required | Description |
|---|---|---|---|
| tags | []string | — | Filter by tags |
| state | string | — | Filter by state (ACTIVE, COMPLETED, etc.) |
| limit | int | — | Max results |
muninn_link Create an explicit weighted association between two engrams.
| Parameter | Type | Required | Description |
|---|---|---|---|
| from_id | string | ✓ | Source engram ULID |
| to_id | string | ✓ | Target engram ULID |
| weight | float | — | Association weight 0.0–1.0, default 0.5 |
muninn_subscribe Create a semantic trigger. Returns a subscription ID. Notifications delivered when matching engrams become highly relevant.
| Parameter | Type | Required | Description |
|---|---|---|---|
| context | string | ✓ | What to watch for |
| threshold | float | — | Relevance threshold, default 0.8 |
muninn_stats Get vault statistics: total engrams, decay distribution, confidence histogram, association counts.
muninn_health Check server health: all workers running, disk space, cache utilization.