MCP Tools Reference
Six tools, designed to chain. The intended loop: search first, then expand interesting entities with get_neighbors instead of re-searching with rephrased queries; get_schema for orientation. All results are compact plain text sized for agent context windows.
Facts are temporal: each carries an optional validity window. A fact marked SUPERSEDED was true once and later contradicted — agents should prefer current facts unless the question is about history.
search
Hybrid semantic + keyword search over the workspace Brain. Start here for any question about the company, its customers, projects, or ingested content.
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | yes | Natural-language search query (≤500 chars) |
limit | integer | no | Max facts to return, 1–20 (default 5) |
Returns ranked facts. Each carries its validity window, relevance score, and both endpoint entities as Name (UUID) — ready to feed into get_neighbors:
[1] Acme Corp signed the enterprise plan at $40k ARR.
Entities: Acme Corp (c09fdb22-…) → enterprise plan (648c3dc3-…)
Valid from: 2026-05-12
Score: 0.891
find_entity
Resolve a name to matching entities. Case-insensitive partial match, exact matches first. Use when you know what you're looking for but need its UUID; use search when you have a question.
| Parameter | Type | Required | Description |
|---|---|---|---|
entity | string | yes | Entity name, full or partial (≤200 chars) |
limit | integer | no | Max matches, 1–20 (default 10) |
Returns matches with UUID, connection count, and summary.
get_neighbors
Walk the graph one hop from an entity: every fact touching it plus the entities on the other end, each addressable for further expansion.
| Parameter | Type | Required | Description |
|---|---|---|---|
entity | string | yes | Entity UUID (from search/find_entity) or a plain name — best match resolved automatically |
limit | integer | no | Max facts, 1–50 (default 15) |
includeInvalidated | boolean | no | Include superseded facts — the entity's history (default false) |
Returns the entity header (name, UUID, summary, connection count) followed by directional facts (→ outgoing, ← incoming). Truncated results say so and how to get more.
get_schema
Workspace Brain overview — no parameters. Returns entity/fact/episode counts, data recency range, content by source kind, the most-connected entities (with UUIDs), and relation types. Use it for orientation, when search returns nothing, or to answer "what does this Brain know?".
recent_episodes
Newest source content ingested into the Brain (uploads, synced records, remembered facts), newest first, with 200-char previews.
| Parameter | Type | Required | Description |
|---|---|---|---|
limit | integer | no | Max episodes, 1–50 (default 15) |
remember
Write scope only — absent from tools/list on read-only credentials.
Store a durable fact, decision, or preference in the Brain.
| Parameter | Type | Required | Description |
|---|---|---|---|
content | string | yes | The fact, as self-contained text (≤20,000 chars) |
title | string | no | Short title (derived from content if omitted) |
description | string | no | Context on where this came from |
Ingestion is asynchronous: the fact is extracted into graph entities and relations in the background and becomes searchable after processing completes — not within the same session turn. Use it for information worth keeping long-term, never for transient conversation state.