MCP Tools Reference
Every Recordari tool, what it does, and how to ask your agent to use it.
Recordari exposes its functionality through MCP tools. Your agent uses them automatically when you give it natural language instructions - you don't call tools directly. This page covers what each tool does and gives you example prompts that work well.
Starting a session
Orient
Loads context from a domain at the start of a session. This is the first thing you should ask your agent to do when beginning work on a project. It returns a summary of recent activity, important decisions, and active threads - everything the agent needs to be useful immediately.
"Orient on the recordari-web domain." "Before we start, orient on the payments domain."
Filing memories
Remember
Stores a piece of information as a node in the graph. Works best when you include a why it matters - that context is what makes memories useful when they're retrieved later.
"File a memory that we're switching from REST to GraphQL. Why it matters: all new endpoints will use GraphQL and old REST routes will be deprecated over the next two sprints." "Remember that the deploy environment requires Node 20. Why it matters: the CI image needs updating before we can ship the new build step."
Revise
Updates an existing memory when something has changed. Use this instead of filing a new one - it keeps the history clean and the graph accurate.
"Revise the memory about our auth approach - we've moved from JWTs to sessions." "Update the deployment memory: we've migrated off Heroku, we're on Fly.io now."
Finding memories
Search
Finds memories by meaning, not just keywords. Useful when you want to check what the agent already knows about a topic, or when you're not sure whether something has been filed.
"Search your memory for anything about the payment integration." "What do you know about the database migration plan?"
Recall
Retrieves the full content of a specific memory by its ID. Useful when you have an ID from a previous session and want everything on record about that node.
"Recall node abc-1234."
Recent
Returns memories that have been touched most recently - filed, revised, or connected. A quick way to catch up on what's been happening in a domain.
"What are the most recently updated memories in the recordari domain?"
Connecting memories
Connect
Creates a labelled relationship between two nodes. Relationships make the graph navigable - when an agent orients, it can follow connections to pull in related context automatically.
"Connect the auth decision to the session handling memory." "Link the deployment memory to the CI configuration memory - they're directly related."
Disconnect
Removes a relationship between two nodes. Use this when a connection was made in error or is no longer meaningful.
"Remove the connection between the auth node and the legacy API node."
Suggest connections
Asks Recordari to look for memories that should probably be linked but aren't yet. Useful after a burst of new memories, or when you want to check whether the graph is well-connected.
"Are there any memories that should be connected but aren't?" "Suggest connections for recent memories about the checkout flow."
Why connected
Explains the reasoning behind a specific relationship - what was the agent thinking when it made this connection?
"Why are these two nodes connected?"
Trace
Follows a chain of connections from one memory outward, showing how one decision relates to others. Useful for understanding the downstream impact of a change.
"Trace the connections from the database schema decision."
Refining
Alias
Gives a memory node a short, memorable name so it's easier to reference in future prompts.
"Give the PostgreSQL database decision memory the alias 'db-choice'."
Significance
Marks a memory as particularly important. Significant memories are surfaced more prominently when orienting.
"Mark the auth architecture decision as significant."
Organising
Domains
Lists all the domains in your workspace. A domain is a named collection of memories - usually one per project or team.
"What domains do we have in this workspace?"
Rename domain
Renames an existing domain.
"Rename the old-payments domain to payments-v2."
Maintenance
Forget
Deletes a single memory node. The audit trail records the deletion.
"Forget the memory about the old Redis caching approach - it's been replaced."
Restore
Brings back a node that has been archived due to age or low access frequency. Archive nodes still count against your plan's archive limit, not your live limit.
"Restore the node about the original API design - we're revisiting it."
Forget all
Clears all memories from a domain. This is not reversible.
"Clear all memories from the scratch-pad domain."
Insight
Audit
Returns the full audit log for a domain - every read, write, connection, and deletion, with timestamps. Available on Pro and above; full export on Team and Enterprise.
"Show me the audit log for the last 7 days on the payments domain."
History
Shows the change history for a specific memory node - what it looked like when it was first filed, and every revision since.
"Show me the history of the database schema decision."
Visualise
Returns a representation of the memory graph - nodes and their connections - that can be rendered as a diagram.
"Visualise the memory graph for the checkout domain."