MCP tools
Every tool the server exposes, its inputs, and what it returns.
The server exposes nine tools and one resource. All tools return plain text. Every tool except index_status re-indexes changed files before it answers; see Keeping the index fresh.
A tool that fails returns an error result whose text starts with Error: , and the server keeps running. Inputs are validated: a call with a wrong type or a value out of range is rejected before it runs.
get_context
The best starting context for a task: project memory, the top code in full, and the signatures of what it calls and what calls it.
Prop
Type
Looks at retrieval.contextK results (20) before packing; the budget decides how many are shown. Memory takes at most a quarter of the budget.
get_context({ task: "add rate limiting to the login endpoint" })search_code
Ranked code for a query, with the reason each result matched. No memories.
Prop
Type
With a language or paths filter, remimem looks up to ten times further down the ranking to fill k, so a rare match can still return fewer than k results.
search_code({ query: "parse JWT token", k: 5 })get_symbol
One function, class, or type, with its callers and callees.
Prop
Type
If several symbols share the name, it returns a short list of candidates with their locations instead of guessing; ask again with a qualified name. A function split into several chunks comes back whole.
--- src/auth.ts:10-23 function authenticateUser
(the body)
Calls:
findUser src/db.ts:19-21 [import]
hash src/hash.ts:4-10 [import]
Called by:
UserService.login src/service.ts:33-38 [import]Sections appear when they have entries: Calls, Called by, Extends, Extended by, Implements, Implemented by, Uses types, Used as a type by, Inside, Contains.
get_file_outline
The symbols in a file with signatures and line numbers, no bodies.
Prop
Type
src/auth.ts (typescript, 5 symbols)
5-8 interface Claims
export interface Claims
14-23 function authenticateUser
export async function authenticateUser(id: string, password: string): Promise<boolean>
16-18 function verify
function verify(expected: string, actual: string): booleanA file in a language without structural support answers that it has no symbols (it is still searchable). A path that is not in the index says so.
find_references
Every place a symbol is called, extended, used as a type, or imported, grouped by file.
Prop
Type
4 references in 2 files to function findUser at src/db.ts:19-21
src/auth.ts
src/auth.ts:2 import
src/auth.ts:20 call in authenticateUser [import]
src/service.ts
src/service.ts:2 import
src/service.ts:43 call in UserService.find [import]Only references remimem could resolve are listed: calls into a symbol through a value of unknown type may be missing. See The call graph.
remember
Save a decision, convention, gotcha, or todo.
Prop
Type
Stored memory m_7c03d27f (convention), linked to store.go normalize.
Not linked: nope (no such symbol in the index).Names that cannot be linked are reported, and the memory is stored anyway.
recall
Search saved memories. Stale ones are marked.
Prop
Type
Matching uses the same keyword and vector fusion as code search, with the minimums described in Project memory. Returns No memories match. when nothing does.
forget
Delete a memory.
Prop
Type
An unknown id is an error result.
index_status
What the index covers. No inputs, and it does not refresh first, so it can report pending changes.
Files: 8 | Symbols: 32 | Chunks: 39 | Edges: 34
Last indexed: 2026-11-17T19:36:41.639Z at commit 5322fdffbf2c
Pending changes: 0 changed, 0 new, 0 deleted
Embedding model: local:Xenova/all-MiniLM-L6-v2 (39 of 39 chunks embedded)The overview resource
remimem://overview is a compact map of the repository: the directory tree to depth 3, each directory with its file count and its most-referenced symbols, capped at 1,500 tokens. It is rebuilt whenever the index changes.
8 files, 32 symbols. Directories show their file count and most-referenced symbols.
db/ (1 files)
src/ (6 files): User, UserId, findUser, hash, UserServiceAnnotations
All tools are marked read-only except remember and forget, which change project memory. None of them reaches outside your machine, unless you configured a remote embedding provider.