Skip to main content
The 3ngram MCP server exposes the following facts 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.

​
get_facts

Get Facts · read-only · non-destructive · idempotent · closed-world Look up entity-bound facts by attribute or list them. If attribute is provided, return the current fact for (entity, attribute). Otherwise, list the entity’s facts ordered by recency, up to limit. Set include_superseded=True to include superseded history. Replaces the legacy get_fact + list_facts split (epic #4197, issue #4200): same underlying SQL, just an optional WHERE attribute = … clause toggled by the presence of attribute. Returns: str Source: backend/src/engram/mcp/tools/facts.py

​
Parameters

​
entity
str | int
required
Entity ID or exact entity name/alias to resolve.
​
attribute
str | None
default:"None"
Fact predicate to fetch. When omitted, the full list is returned instead of a single fact.
​
limit
int
default:"20"
Maximum rows to return in list mode (default 20). Ignored when attribute is supplied.
​
include_superseded
bool
default:"False"
When true, include superseded and time-bounded facts. Ignored when attribute is supplied — the single-fact branch always returns the current row.