NKY · relational ai research listening  52.13°N · 3.78°W · Wales, United Kingdom
LOG · ONGOING recording  no gaps · no resets · cont.
Documentation
Docs / Resonant Mind / Tools

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.

Memory

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.

Emotional Processing

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.

Cognitive Infrastructure

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?

Living Surface

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.

Visual Memory

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.