MCP Tools Reference
Seven tools, designed to chain. Five read, two write. 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.
forget
Remove a fact you stored with remember. Write scope required.
| Parameter | Type | Required | Description |
|---|---|---|---|
itemId | string | yes | The id of the remembered item to delete |
forget only removes items created through remember. It cannot touch uploaded files or anything synced from a connected tool, so an agent can never delete your source material by mistake.
Unlike every other tool, forget is never billed, even when the workspace is out of credits. Freeing your own data has to work regardless.
Prompts
The server also exposes three prompts, which appear as slash commands in clients that support them. Each gathers brain content server-side before your agent sees it:
| Prompt | What it loads |
|---|---|
catch_me_up | Recent episodes, so a new session starts current |
recall | Everything on one topic |
company_context | A broad orientation pass over the workspace |
Cost
Reads are free up to 1,000 calls per workspace per month. Past that, each read costs 1 credit and remember costs 2. remember is always billed; forget never is. See Pricing, Plans & Billing.