recall

Search stored facts. REST POST /v1/recall and MCP tool recall.

POST/v1/recall

Send at least one of query, predicate, or related_to.

Field	Type	Required	Description
`query`	string	no	Entity (`type:id`) or natural-language topic. Max 2000.
`predicate`	string	no	Filter to one relationship type.
`predicates`	string[]	no	Filter to any of these relationship types. Max 20.
`entity_type`	string	no	Keep results whose entity type matches (e.g. `user`).
`related_to`	string	no	Facts connected to this entity.
`depth`	integer	no	Neighbor expansion. Default 2 when omitted.
`fuzzy_match`	boolean	no	Match similar entity names.
`limit`	integer	no	Max facts. Default 20, max 200.
`offset`	integer	no	Skip this many facts. Use the same `sort_by` and `sort_order` on every page.
`sort_by`	string	no	Order listing results. One of `created_at`, `predicate`, `subject`, `object`, `confidence`, `id`. `object` is the linked entity name, or the literal `value` when the object is not an entity. Omit to keep historical order (semantic relevance when the query is embedded). When set, recall returns that ordered page and does not rank by embedding or depth-fill the page.
`sort_order`	string	no	`asc` or `desc`. Default `asc`. Tie-break is `id` in the same direction.
`collection`	string	no	Collection code. Omit for the connection default. `""` forces the default bucket.

Response

{
  "facts": [
    { "subject": "user:maya", "predicate": "has_skill", "object": "TypeScript" }
  ],
  "count": 1
}

Each fact may include value (literal object), context, source, score (semantic search only), and created_at.

Walk neighbors of one entity. REST POST /v1/recall_connections and MCP tool recall_connections.

POST/v1/recall_connections

Field	Type	Required	Description
`entity`	string	yes	Starting entity (`type:id`).
`depth`	integer	no	Hops to walk. Default 2.
`limit`	integer	no	Max connections. Default 20, max 500.
`offset`	integer	no	Skip this many connections.
`collection`	string	no	Collection code. Omit for the connection default.

{
  "entity": "user:maya",
  "depth": 2
}