Skip to Content
remimem

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): boolean

A 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, UserService

Annotations

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.

On this page