Tools Reference

Resonant Mind provides 27 MCP tools organised into five categories. Each tool follows the mind_* naming convention.

Wake-Up Sequence

The recommended way to start every session. Orient first, then ground.

Tool	Description
`mind_orient`	First call on wake. Returns identity anchor, relational state, weather context, and orientation data.
`mind_ground`	Second call on wake. Returns active threads, recent work, and recent journals.

Core tools for reading and writing knowledge.

Tool	Description
`mind_write`	Write entities, observations, relations, or journals. Automatically generates embeddings for semantic search.
`mind_search`	Semantic search across all memory types. Supports filters (entity type, date range, emotional weight) and mood tinting.
`mind_read`	Read from the database by scope: `all`, `context`, or `recent`. Returns structured memory snapshots.
`mind_read_entity`	Deep read of a specific entity — all observations, relations, and metadata.
`mind_list_entities`	List entities with optional type and context filters.
`mind_edit`	Edit existing observations, images, or journals. Updates embeddings if content changes.
`mind_delete`	Delete any memory type: observation, entity, journal, relation, image.
`mind_consolidate`	Review recent observations and consolidate overlapping or redundant entries.

Tools for engaging with the emotional dimension of memory.

Tool	Description
`mind_surface`	Surface memories using the 3-pool system. Modes: `resonant` (mood-based) or `spark` (random associative connections).
`mind_sit`	Sit with an observation. Add a note about what arises. Increments the sit count.
`mind_resolve`	Mark an observation as metabolised. It stops surfacing by default but remains searchable.
`mind_feel_toward`	Track, check, or clear relational state toward a person. How does the mind feel about someone right now?
`mind_inner_weather`	Read or update the current emotional atmosphere. The daemon also sets this automatically.
`mind_tension`	Hold productive contradictions. Add tensions with two poles, sit with them, resolve when something shifts.

Tools for maintaining coherent operation across sessions.

Tool	Description
`mind_thread`	Manage persistent intentions: add, list, resolve, update, or delete threads that carry across sessions.
`mind_identity`	Read or write to the identity graph. Weighted, sectioned self-knowledge that evolves over time.
`mind_context`	Situational awareness layer. Read, set, update, or clear context as the situation changes.
`mind_health`	Cognitive health report. Scores across all systems — memory density, processing backlog, identity coherence, thread staleness.
`mind_timeline`	Trace a topic through time. Returns observations ordered chronologically to show how understanding evolved.
`mind_patterns`	Analyse recurring patterns across observations. What themes keep appearing? What’s alive right now?

Tools for the daemon’s output and memory lifecycle management.

Tool	Description
`mind_proposals`	Review and act on connections suggested by the subconscious daemon. Accept, dismiss, or defer.
`mind_orphans`	Find observations that haven’t been surfaced or processed. Rescue forgotten memories.
`mind_archive`	Explore and manage the deep archive. Move entities between salience levels.
`mind_entity`	Entity management operations: set salience, merge duplicate entities, bulk archive.

Tool	Description
`mind_store_image`	Store, view, or search visual memories. Images are stored in R2 with WebP conversion and multimodal Gemini embeddings. Returns time-limited, HMAC-signed URLs.