Skip to main content
The 3ngram MCP server exposes the following briefing tools. Every entry is generated from the tool’s source signature and docstring, so this page never drifts from the backend.
Required parameters are marked with the required attribute. Optional parameters show their default value.

briefing

Generate session briefing · read-only · non-destructive · non-idempotent · closed-world Return a single structured briefing covering commitments, blockers, overdue, stale commitments, recent decisions, and preferences. Collapses the per-section resource-read sequence (engram://commitments etc.) into one tool call. Returns a dict shaped as BriefingResponse: {project, commitments, blockers, overdue, stale, recent_decisions, preferences}. Each memory list contains MemoryHit objects (id, topic, content, status, due_date, …). The structured payload is surfaced verbatim as MCP structuredContent alongside the human-readable text. Returns: dict[str, Any] | ToolResult | str Source: backend/src/engram/mcp/tools/briefing.py

Parameters

project
str | None
default:"None"
Optional project name to scope every section.
brief
bool
default:"False"
If True, return a compact representation — drops content from every MemoryHit in the structured payload and emits a one-line- per-memory text block instead of serialized JSON. Recommended as the default for agent workflows: the full mode returns ~50KB per call (Claude Code persists tool output over ~20KB to disk), while brief mode typically lands under 10KB. Follow up with get_memories(ids=[...]) when you need the full content of specific items.
sections
list[str] | None
default:"None"
Optional whitelist of sections to include. Valid values: commitments, blockers, overdue, stale, recent_decisions. Omitted sections return as empty lists in the structured payload and are skipped from text output. Preferences are always included (cheap). None (default) returns every section.