Skip to content
ExoVault

Search Documentation

Search across all documentation pages

Tool Reference

This page provides a compact, machine-parseable listing of all ExoVault MCP tools. It is designed for inclusion in agent system prompts where token efficiency matters.

Compact Tool Listing#

The following listing uses a compressed format: tool_name(required_params; optional_params) -> response_fields.

Session & Context#

session_start(; vaultId, query, summaryOnly=true, mode=default, maxEpisodic, maxFacts, maxTasks, maxConstraints, includeDocuments=["soul"], maxResponseChars=16000) -> sessionContext{recentSessions, importantFacts, activeTasks, constraints}, vaults, recentAgents, documents, pendingMessages, changesSinceLastSession, isFirstConnection

context_checkpoint(memories[], sessionSummary; vaultId, agentId, modelId, agentRunId, dedup=true) -> total, created, skipped, failed, durationMs, results[], pendingMessages?

ingest_turn(content, role; vaultId, agentId, agentRunId, signalThreshold, customSignalKeywords) -> turnId, signalScore, signalKeywords, extractionStatus

Memory Operations#

write_memory(content; summary, memoryType=fact, importance=3, confidence=3, entities[], dedup=false, vaultId, relatedMemoryIds[], sourceNoteIds[], supersededById, externalWriteId, expiresAt, metadata, writeReason) -> memoryId, created, idempotent, memoryType, vaultId, dedupAction?, supersededMemoryId?

search_memories(query; topK=10, threshold=0.4, vaultId, memoryType, includeArchived=false, decayHalfLife=30, diversity=0.7) -> searchMode, memories[], unitsUsed, semanticMatchCount, blindIndexMatchCount, graphExpansionCount

read_memories(memoryIds[]; vaultId) -> memories[]

get_related_memories(memoryId; vaultId) -> memories[]

update_memory(memoryId, updates; vaultId) -> updated

archive_memory(memoryId; vaultId) -> archived

cleanup_memories(; vaultId, maxAge, minImportance) -> cleaned

Task Management#

create_task(title; description, status=todo, priority=3, assignedAgentId, doneWhen, vaultId, dedup=false, externalWriteId) -> taskId, created, status, vaultId

update_task(taskId, updates; vaultId) -> updated

list_tasks(; vaultId, status, assignedAgentId) -> tasks[]

Notes#

create_note(title, content; vaultId, folderId, tags[]) -> noteId

read_note(noteId;) -> id, title, content, tags, vaultId

read_notes(noteIds[];) -> notes[]

update_note(noteId, updates;) -> updated

delete_note(noteId;) -> deleted

move_note(noteId, folderId;) -> moved

search_notes(query; vaultId, limit) -> notes[]

list_notes(; vaultId, folderId, limit, offset) -> notes[]

semantic_search(query; topK=10, threshold=0.5, vaultId) -> notes[], embeddingTokens

search_and_read(query; vaultId, topK) -> notes[]

Knowledge Graph#

add_link(sourceType, sourceId, targetType, targetId, relationType; label) -> linkId, created

remove_link(linkId;) -> removed

get_links(nodeType, nodeId;) -> links[]

explore_graph(; query, nodeId, nodeType, maxHops=2, maxNodes=50, vaultId) -> entryPoints[], nodes[], edges[], stats

Folders & Vaults#

create_folder(name; vaultId, parentFolderId) -> folderId

list_folders(; vaultId) -> folders[]

create_vault(name;) -> vaultId

list_vaults(;) -> vaults[]

Agent Messaging#

send_message(targetId, content; targetType, category=info, priority=3, subject, vaultId, expiresInDays=30, template, templateData, parentMessageId, metadata) -> messageId, created, targetType, category

read_messages(; vaultId, limit) -> messages[]

pending_messages(;) -> messages[]

ack_message(messageId;) -> acknowledged

list_active_agents(; vaultId) -> agents[]

Documents & Settings#

read_document(documentType; vaultId) -> documentType, content, inheritMode, agentEditable, appendOnly

update_document(documentType, content; vaultId) -> updated

get_settings(; vaultId) -> settings

update_settings(updates; vaultId) -> updated
wiki_link | derived_from | contradicts | refines | part_of | supersedes | source_of | references | manual

Memory Types for write_memory#

fact | skill | preference | constraint | task | episodic | correction

Context Modes for session_start#

default    -> episodic:3, facts:5, tasks:5, constraints:10
planning   -> episodic:1, facts:8, tasks:8, constraints:10
incident   -> episodic:5, facts:8, tasks:3, constraints:10
handoff    -> episodic:5, facts:5, tasks:8, constraints:10
deep       -> episodic:5, facts:10, tasks:5, constraints:10
minimal    -> (reduced retrieval)
none       -> (no context retrieval)

Message Categories#

directive | question | info | task | alert

Task Statuses#

backlog | todo | in_progress | done | blocked