SDKs & tools
MCP tools
Reference for all 36 tools exposed by Illumina's MCP server.
The hosted MCP server exposes 36 tools, grouped below by area. Namespace-scoped
endpoints (/mcp/{namespace_id}) expose all of them except the three
namespace-discovery tools (list_namespaces, create_namespace,
get_namespace_stats), which only appear in
multi-namespace mode. A namespace's
mcp_enabled_tools configuration can narrow the set further — see the
overview.
In multi-namespace mode every tool also accepts an optional namespace_id
argument to target a namespace other than the session default.
Core
| Tool | Description |
|---|---|
retain | Store a fact or memory into long-term memory for later recall; storage is asynchronous and returns an operation id. |
sync_retain | Store information to long-term memory and wait for completion, so the memory is immediately available for recall. |
recall | Search long-term memory and return the most relevant facts for a query, fusing semantic, lexical, graph, and temporal retrieval. |
reflect | Generate a synthesized, reasoned answer by reflecting across stored memories and the namespace's personality. |
Namespaces
| Tool | Description |
|---|---|
list_namespaces | List all available memory namespaces, each an isolated memory store with its own ID, name, disposition, and mission. |
create_namespace | Create a new memory namespace or get an existing one. |
get_namespace | Get the profile of a memory namespace, including its name, disposition, and mission. |
get_namespace_stats | Get statistics for a memory namespace: counts of nodes, links, operations, documents, and consolidation metrics. |
update_namespace | Update a memory namespace's display name or configuration fields; only provided fields are changed. |
delete_namespace | Delete a memory namespace and all its data; this action cannot be undone. |
Memories
| Tool | Description |
|---|---|
list_memories | Browse stored memory units with optional filtering, without recall's relevance ranking. |
get_memory | Get a specific memory unit by id, including content, metadata, and timestamps. |
clear_memories | Clear all memories from a namespace without deleting the namespace itself, optionally filtered by fact type. |
Documents
| Tool | Description |
|---|---|
list_documents | List documents (containers grouping related memories) in a memory namespace. |
get_document | Get a specific document by id, returning its metadata and associated memory information. |
delete_document | Delete a document and all memories linked to it. |
Automations
| Tool | Description |
|---|---|
list_automations | List automations (pinned, refreshable reflections) for a memory namespace. |
get_automation | Get a specific automation by id. |
create_automation | Create an automation, a living document generated by running a source query through reflect. |
update_automation | Update an automation's metadata: name, source query, tags, or max tokens. |
delete_automation | Delete an automation and its generated content. |
refresh_automation | Refresh an automation by re-running its source query through reflect (asynchronous). |
clear_automation | Clear an automation's content so the next refresh performs a full re-synthesis. |
Directives
| Tool | Description |
|---|---|
list_directives | List directives (instructions that guide how the engine processes queries and reflects) for a memory namespace. |
create_directive | Create a new directive that guides how the engine processes queries and generates reflections. |
delete_directive | Delete a directive, permanently removing it from the memory namespace. |
Communities
| Tool | Description |
|---|---|
list_communities | List GraphRAG communities (thematic entity clusters with summaries) for a memory namespace. |
get_community | Get one community by id, including its thematic summary and member entity names. |
build_communities | Rebuild GraphRAG communities for a memory namespace from the entity co-occurrence graph. |
get_community_status | Get community build status for a memory namespace: never, building, ready, or failed, plus last built time and count. |
clear_communities | Delete all GraphRAG communities for a memory namespace, resetting build status so the next build starts from scratch. |
Ontology
| Tool | Description |
|---|---|
get_ontology | Get the memory namespace's ontology: entity classes and typed relations between classes. |
Operations
| Tool | Description |
|---|---|
list_operations | List async operations that track background tasks like retain processing and automation refresh. |
get_operation | Get the status of an async operation. |
cancel_operation | Cancel a pending async operation that has not yet started. |
Tags
| Tool | Description |
|---|---|
list_tags | List tags used in a memory namespace with usage counts. |