Skip to main content
Glama
navid-kianfar

Claude Memory MCP

Claude Memory MCP

Persistent, searchable, per-project memory for Claude Code.

CI License: MIT Docker Hub

Claude forgets everything between sessions. You re-explain the same decisions, rules get missed, and context is lost when the window fills up. Claude Memory MCP gives each of your projects its own brain — decisions, rules, architecture notes, and sprint goals stored locally in a vector database, retrieved by meaning, and automatically loaded every time you start a session.

Claude Memory MCP management UI


What you get

  • Per-project memory — each project has an isolated DuckDB database; memory never leaks between projects.

  • Semantic search — ask "what database did we pick?" and it finds the Postgres decision even if you never typed "Postgres".

  • Rule enforcement — mandatory/forbidden rules are re-injected into Claude's context every turn (via hooks) so they survive context compaction and stop being forgotten.

  • A management UI — a React app to browse, search, and edit every project's memories, rules, sessions, and history, with a Cmd+K command palette.

  • One shared daemon — a single background process serves the MCP endpoint and the UI; the embedding model loads once, and there are no database lock conflicts between clients.

  • Templates — define a set of default rules once, then seed every new project from it (pick exactly which rules with checkboxes) instead of re-typing them. New projects can also import selected rules from any existing project.

  • CLAUDE.md import — convert an existing CLAUDE.md into structured memory.

  • Portable & team-shareable — move a project's database into the repo, commit it, and teammates get the same memory after git pull.

Related MCP server: Claude Persistent Memory

How it works

flowchart LR
  subgraph clients[Claude Code]
    CLI[Terminal CLI]
    APP[Desktop app]
  end
  UI[Management UI<br/>React + command palette]
  subgraph daemon[memory-mcp daemon · port 8765]
    MCP[/MCP endpoint  /mcp/]
    API[/JSON API  /api/]
    EMB[Embedding model<br/>loaded once]
  end
  DB[(Per-project<br/>DuckDB + vector index)]

  CLI -->|HTTP| MCP
  APP -->|HTTP| MCP
  UI -->|HTTP| API
  MCP --> DB
  API --> DB
  MCP --- EMB

Both Claude Code clients and the UI connect to the same daemon, which is the sole owner of the DuckDB files. A UserPromptSubmit hook asks the daemon for the current project's rules and injects them into context on every turn.

docker run -d --name memory-mcp \
  -p 8765:8765 \
  -v memory-mcp-data:/data \
  kianfar/claude-memory-mcp:latest

Or with Compose:

docker compose up -d

Then:

  • Management UI — open http://localhost:8765/

  • Connect Claude Code — register the MCP server:

    claude mcp add --transport http memory http://localhost:8765/mcp

Quick start — Homebrew

brew tap navid-kianfar/tap
brew install claude-memory-mcp
brew services start claude-memory-mcp        # runs the daemon in the background

Then claude mcp add --transport http memory http://localhost:8765/mcp. See packaging/homebrew/ for tap setup details.

Quick start — from source

Requires uv and (for the UI) Node 20+.

git clone https://github.com/navid-kianfar/claude-memory-mcp.git
cd claude-memory-mcp
./install.sh

install.sh installs dependencies, builds the UI, downloads the embedding model, installs a launchd agent so the daemon auto-starts, points Claude Code at the daemon, and installs the rule-enforcement hooks. It prints a one-time sudo command to add a claude-memory-mcp entry to /etc/hosts so the UI URL resolves — after that the UI is at http://claude-memory-mcp:8765/.

Screenshots

Once the daemon is running, the management UI is at http://localhost:8765/ — browse, search, and edit every project's memories, rules, and sessions.

Templates — define a baseline rule set once, then reuse it for every new project:

Templates view

Seed a new project — on creation, import exactly the rules you want (with checkboxes) from a template or from another existing project:

Importing rules into a new project

Using it

Inside Claude Code:

memory_init_project("my-app", "My App")   # create a project
memory_session_start("my-app")            # loads rules + context

From then on Claude stores decisions, rules, and sprint notes automatically and recalls them with semantic search. At the start of each session it loads the project's rules, last summary, and recent decisions.

Rule enforcement

Rules you set (mandatory_rules / forbidden_rules) are enforced three ways:

  1. Hook injection — a UserPromptSubmit hook injects the actual rule text into context every turn, so rules survive context compaction.

  2. Server instructions — the MCP server tells Claude to load and honor rules.

  3. Tool responses — search/store responses carry a compact rules reminder.

Hooks are silent in directories that are not registered memory projects, so they can be installed globally without noise.

Importing an existing CLAUDE.md

memory_import_claude_md("/path/to/project")            # import into memory
memory_import_claude_md("/path/to/project", stub_rewrite=True)  # + slim the file

Headings are mapped to categories (rules, architecture, decisions, devops, docs); rule sections are split per bullet. With stub_rewrite, CLAUDE.md is replaced by a short pointer at memory MCP (the original is backed up).

The management UI

A React single-page app served by the daemon at /:

  • Browse, search, create, edit, and archive memories in every category

  • Manage mandatory/forbidden rules

  • Inspect sessions and per-memory provenance/history

  • Switch and set the active project

  • Cmd+K command palette for fast navigation and actions

MCP tools

35 tools, including:

Area

Tools

Projects

memory_init_project, memory_load_from_folder, memory_link_folder, memory_list_projects, memory_project_info, memory_use

Memories

memory_store, memory_search, memory_recall, memory_update, memory_delete, memory_list

Rules

memory_get_rules, memory_add_rule, memory_update_rule, memory_delete_rule

Templates

memory_list_templates, memory_create_template, memory_add_template_rule, memory_apply_template, memory_import_rules

Sessions

memory_session_start, memory_session_end

Portability

memory_attach_project, memory_make_portable, memory_sync

Import/Export

memory_export, memory_import, memory_import_claude_md

Model

memory_model_info, memory_set_model, memory_reembed

Misc

memory_provenance, memory_version, memory_check_update

Configuration

Environment variables (prefix MEMORY_MCP_):

Variable

Default

Purpose

MEMORY_MCP_DATA_DIR

~/.claude-memory-mcp

Where databases are stored

MEMORY_MCP_DAEMON_HOST

127.0.0.1

Daemon bind address (0.0.0.0 in Docker)

MEMORY_MCP_DAEMON_PORT

8765

Daemon port

MEMORY_MCP_DAEMON_HOSTNAME

claude-memory-mcp

Hostname used in the UI URL

Team / multi-device memory (git sync)

Bind a project to its source folder and its memory travels with the code through git — across your devices and teammates:

memory_link_folder("/path/to/project")   # bind an existing project to its folder

You can also set the folder when creating a project — the New Project dialog has a Project folder field, and memory_load_from_folder binds it automatically.

Once bound, the project's rules and decisions are mirrored to a committable .claude-memory/ snapshot in the project folder — one JSON file per category, diff- and merge-friendly (no binary database, no embeddings). A git push carries the latest memory; a teammate's git pull plus their next session imports it back. The export runs at the end of each turn and the import at session start (both via hooks), and the central database stays the daemon's fast working copy.

Import is safe by design: it only adds new entries and applies edits that are strictly newer — it never deletes, and never reverts a more recent local change. Removing a rule is always explicit. Each project's memory is separate — sharing one never exposes the others.

Architecture

  • Python + FastMCP — the MCP server and HTTP daemon (Starlette + uvicorn)

  • DuckDB + VSS — per-project memory storage with an HNSW cosine vector index

  • SQLite — the local registry (project list + app settings); stdlib, no extra dependency

  • sentence-transformers — local embeddings (all-MiniLM-L6-v2, 384-dim; a 50+ language multilingual preset is also available)

  • Layered design — repositories → services → container → tool/HTTP layer

  • React + Vite + Tailwind — the management UI, with hand-built shadcn-style components

Existing databases are migrated automatically on open, so older project databases keep working after upgrades.

Development

uv sync --all-extras
uv run pytest -v          # backend tests

cd frontend
npm install
npm run dev               # UI dev server (proxies the API to the daemon)
npm run build             # production build into frontend/dist

Run the daemon directly:

uv run memory-mcp serve

Releasing

The Docker image is published only for tagged releases — never on ordinary commits. Cut a release with the helper script:

./scripts/release.sh           # patch bump (0.6.0 -> 0.6.1)
./scripts/release.sh minor     # 0.6.0 -> 0.7.0
./scripts/release.sh 1.2.3     # explicit version

It runs the tests, bumps the version in pyproject.toml and the package, commits, creates a vX.Y.Z tag, and pushes. The tag push triggers the workflow that builds and publishes the multi-arch image to Docker Hub.

License

MIT — see LICENSE.

Available Tools

37 tools
memory_add_ruleB

Add a project rule. rule_type is 'mandatory' (always do) or 'forbidden' (never do). The rule is enforced in every future session.

ParametersJSON Schema
NameRequiredDescriptionDefault
titleYes
contentYes
projectNo
priorityNo
rule_typeYes

Output Schema

ParametersJSON Schema
NameRequiredDescription

No output parameters

TDQS

B3.3/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided, so description carries the burden. It discloses that rules apply to future sessions, but omits details like overwriting behavior, duplicate handling, or limits. Adequate but not rich.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two concise sentences with front-loaded verb ('Add a project rule'). No wasted words; all information is relevant.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Despite having an output schema, the description lacks parameter explanations and usage context. For a tool with 5 parameters, this is insufficient for complete understanding.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, so description must compensate. It only explains rule_type ('mandatory'/'forbidden') and ignores title, content, project, and priority. Minimal added value for 5 parameters.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool adds a project rule, differentiating it from siblings like memory_add_rule_bulk and memory_update_rule. It specifies the two rule types (mandatory/forbidden), making the purpose unambiguous.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No explicit guidance on when to use this tool versus alternatives (e.g., bulk add, update, delete). The description only implies that rules are enforced in future sessions, but does not clarify prerequisites or context for using the project parameter.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

memory_add_rule_bulkA

Add one rule to many projects at once.

rule_type is 'mandatory' or 'forbidden'. projects=None adds it to every registered project; otherwise pass a list of project slugs. Lets you push a rule to all your projects without doing it one by one.

ParametersJSON Schema
NameRequiredDescriptionDefault
titleYes
contentYes
priorityNo
projectsNo
rule_typeYes

Output Schema

ParametersJSON Schema
NameRequiredDescription

No output parameters

TDQS

A4/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided, so description carries full burden. Explains parameter behavior (rule_type values, projects=None meaning) but does not mention side effects, authorization, or error cases. Adequate but not comprehensive.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three sentences: purpose, parameter explanation, use case. No redundant information. Front-loaded main action.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given 5 params, no schema descriptions, but output schema exists. Describes key parameters and use cases. Misses priority semantics and constraints, but sufficient for typical usage.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 0%, so description must compensate. Covers rule_type (mandatory/forbidden) and projects (null vs list). Missing details for title, content, priority beyond default. Partial coverage.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Description clearly states verb 'Add', resource 'rule', and scope 'many projects at once'. Distinguishes from sibling 'memory_add_rule' by specifying bulk behavior.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicitly describes when to use (add rule to multiple projects, especially all) and alternatives (doing it one by one via memory_add_rule). Lacks explicit when-not-to-use but context is clear.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

memory_add_template_ruleA

Add a rule to a template (by template name). rule_type is 'mandatory' or 'forbidden'.

ParametersJSON Schema
NameRequiredDescriptionDefault
titleYes
contentYes
priorityNo
templateYes
rule_typeYes

Output Schema

ParametersJSON Schema
NameRequiredDescription

No output parameters

TDQS

A3.5/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description must fully disclose behavioral traits. It explains rule_type values but does not mention whether the rule is appended or inserted, effects on existing rules, or required permissions. This leaves significant ambiguity for an agent.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is two short sentences, front-loading the essential purpose and the key constraint on rule_type. Every word serves a purpose with no redundancy.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given an output schema exists, return values need not be described. However, for a 5-parameter tool with 4 required fields, the description covers only two parameters adequately. Information on priority defaults (default 2) and formatting of content is missing, limiting completeness.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema has 0% description coverage, so the description must compensate. It adds meaning to 'template' (by name) and 'rule_type' (mandatory/forbidden), but provides no explanation for 'title', 'content', or 'priority'. A baseline score of 3 is appropriate given partial value.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('Add a rule to a template') and specifies the identifying field ('by template name'). It also clarifies the two permitted values for rule_type ('mandatory' or 'forbidden'), distinguishing it from sibling tools like memory_add_rule which add rules directly.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage when adding a rule to a template, but provides no explicit guidance on when to prefer this tool over alternatives like memory_add_rule_bulk or memory_update_rule. There is no mention of prerequisites or when not to use it.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

memory_apply_templateC

Apply a template's rules/memories into a project (by template name).

ParametersJSON Schema
NameRequiredDescriptionDefault
projectNo
templateYes

Output Schema

ParametersJSON Schema
NameRequiredDescription

No output parameters

TDQS

C2.6/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description must disclose behavioral traits. It states 'apply a template's rules/memories into a project' but does not specify whether this merges or overwrites existing content, whether it is idempotent, or what permissions are required. The vague verb 'apply' leaves critical behavior unspecified.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single brief sentence, which is efficient. However, it sacrifices necessary detail for brevity. It is front-loaded with the verb but lacks substantive information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the existence of an output schema (unknown content) and two parameters, the description is insufficiently complete. It does not explain return values, side effects, or how the template is applied. The tool is part of a large ecosystem, but the description provides minimal context.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 0%, yet the description does not explain the parameters. The template parameter is mentioned only as 'by template name' with no format or constraints. The project parameter is completely ignored. This fails to add meaning beyond the basic schema definition.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the verb 'Apply' and identifies both the resource (template's rules/memories) and the target (project). It distinguishes from other memory tools like memory_add_template_rule or memory_list_templates. However, 'by template name' is slightly ambiguous—it could mean the template identifier is a name, but the schema confirms template is a string.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus alternatives (e.g., memory_add_template_rule, memory_create_template). There is no mention of prerequisites or context for application.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

memory_attach_projectC

Attach an existing project directory. Auto-activates on success.

ParametersJSON Schema
NameRequiredDescriptionDefault
slugNo
descriptionNo
display_nameNo
project_pathYes

Output Schema

ParametersJSON Schema
NameRequiredDescription

No output parameters

TDQS

C2.6/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided, so description bears full burden. It mentions 'Auto-activates on success' but does not disclose side effects (e.g., what happens to previously attached projects), permissions, or error conditions. Behavioral transparency is poor.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is concise with two short sentences. However, it sacrifices necessary detail for brevity. Structure is clean but incomplete.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Despite having an output schema, the description doesn't explain what the tool returns or what constitutes a successful attachment. No context about the project_path format, whether it's relative/absolute, or what 'attach' means in terms of state changes.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Input schema has 0% description coverage, and the description adds no parameter details. The 4 parameters (slug, description, display_name, project_path) are not explained at all, leaving the agent to guess their meaning.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('Attach an existing project directory') with a specific verb and resource. It implies the project already exists, distinguishing it from memory_init_project, but does not explicitly differentiate from siblings like memory_load_from_folder or memory_link_folder.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool vs alternatives. No context about prerequisites or scenarios where this tool is appropriate. The description lacks any usage context.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

memory_check_updateA

Check if a newer version of the Memory MCP server is available.

Queries GitHub Releases first, falls back to git commit comparison. Does NOT modify anything - it only reports. Returns step-by-step update instructions when a new version is available.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription

No output parameters

TDQS

A4.7/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description fully discloses behavior: it queries GitHub Releases first, falls back to git commit comparison, and asserts it does not modify anything. This gives the agent confidence in its read-only nature and the fallback logic.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is concise with four short sentences. The main purpose is front-loaded, and every sentence adds value: purpose, method, side-effect clarification, and output description. No wasted words.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple check tool with an output schema and zero parameters, the description provides complete context: purpose, method (two fallback sources), side-effect clarification (no modification), and output (update instructions). Nothing is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool has zero parameters and schema coverage is 100%. The description adds no parameter information (as none are needed) but explains the internal process and output. Baseline for zero params is 4, and the description meets that.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description explicitly states the tool's purpose: 'Check if a newer version of the Memory MCP server is available.' This is a specific verb+resource pair, and it clearly distinguishes from siblings like 'memory_version' (which likely reports current version) and 'memory_update' (which likely performs the update).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description explains when to use the tool ('Check if a newer version is available') and what it returns ('step-by-step update instructions'). It explicitly states that it does not modify anything, which implies it is safe for read-only checks. However, it does not explicitly mention when not to use it or list alternatives, but the context is clear.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

memory_create_templateA

Create a reusable template - a named set of default rules/memories that can be applied when creating new projects so they need not be re-typed.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYes
descriptionNo

Output Schema

ParametersJSON Schema
NameRequiredDescription

No output parameters

TDQS

A3.6/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries full burden. It reveals the tool creates a named set of default rules/memories that are reusable. However, it does not disclose behavior on duplicate names, whether it modifies existing templates, or any side effects. Basic transparency but missing important details.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence that is front-loaded with the action and clearly states the tool's purpose. No unnecessary words.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given there is an output schema, return value explanation is not needed. However, with 2 parameters and 1 required, the description does not address behavior on duplicate template names or any prerequisites. It is adequate for a simple creation tool but could add context about conflict handling.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, so the description should explain parameters. It only hints at the 'name' parameter (as a named set) but completely omits the optional 'description' parameter. It adds no value beyond the schema for either parameter.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description gives a specific verb ('Create') and resource ('reusable template'), and clearly explains what a template is ('named set of default rules/memories') and its use case ('applied when creating new projects so they need not be re-typed'). This distinguishes it from sibling tools like memory_list_templates or memory_apply_template.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies the tool should be used to create a template for new projects, but it doesn't explicitly state when to use this vs. alternatives like memory_add_template_rule or memory_apply_template. No when-not or alternative guidance is provided.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

memory_deleteB

Soft-delete (archive) or hard-delete a memory.

ParametersJSON Schema
NameRequiredDescriptionDefault
hardNo
reasonNo
projectNo
memory_idYes

Output Schema

ParametersJSON Schema
NameRequiredDescription

No output parameters

TDQS

B3/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description must carry the full burden. It discloses the two deletion modes but omits details about reversibility, side effects, permissions, or return values. The output schema exists but is not referenced.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence with no waste. However, it could be slightly longer to cover key aspects without losing conciseness.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool has 4 parameters, no annotation, and no schema-level descriptions, the description is too sparse. It fails to explain the difference between soft and hard delete, and does not mention output or error conditions.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, and the description does not explain any of the four parameters (hard, reason, project, memory_id). The agent gains no insight into what these parameters control or their valid values.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's action (delete) and the two modes (soft-delete/archive and hard-delete), effectively distinguishing it from sibling tools like memory_update or memory_store.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use soft vs hard delete, or when to choose this tool over alternatives. The description lacks context about prerequisites or typical use cases.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

memory_delete_ruleA

Delete a rule by its id. Soft-deletes (archives) unless hard=True.

ParametersJSON Schema
NameRequiredDescriptionDefault
hardNo
projectNo
rule_idYes

Output Schema

ParametersJSON Schema
NameRequiredDescription

No output parameters

TDQS

A4/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided, so description carries full burden. It discloses the key behavioral nuance: soft-deletes by default, hard deletes with hard=True. Lacks details on authentication or side effects.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences, front-loaded with primary action, no redundant text. Every clause adds value.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Covers core delete behavior and soft/hard distinction, but misses documenting the project parameter. Given output schema exists, return format is not needed, but missing parameter info is a gap.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With 0% schema description coverage, description must compensate. It only clarifies rule_id and hard behavior, ignoring the project parameter entirely, leaving its purpose ambiguous.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Clearly states 'Delete a rule by its id', specifying the action (delete) and resource (rule), distinguishing it from sibling tools like memory_delete which targets memories.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Implies usage context by describing soft-delete vs hard delete ('unless hard=True'), but does not explicitly compare with alternatives like memory_delete or mention prerequisites.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

memory_exportC

Export all active memories to human-readable .md files.

ParametersJSON Schema
NameRequiredDescriptionDefault
projectNo
export_pathYes

Output Schema

ParametersJSON Schema
NameRequiredDescription

No output parameters

TDQS

C2.6/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries full burden but only states the basic action. It does not disclose whether files are overwritten, if a directory is created, how memories are organized (e.g., one file per memory), or any side effects. Critical behavioral details are missing.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single concise sentence, which is efficient for a simple purpose. However, it lacks structure (e.g., bullet points) that could improve readability, but it does not contain unnecessary words.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the presence of many sibling tools and the simplicity of the schema, the description is insufficient. It omits parameter details, output structure (though output schema exists, the description could still clarify), and usage context. An agent would struggle to determine if this is the right tool for a given task.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema has 0% description coverage for parameters, and the description does not explain the 'project' parameter or the format of 'export_path'. An agent cannot infer that 'project' likely filters memories by project or that the path should point to a directory. Parameter meanings are entirely opaque.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states that the tool exports all active memories to human-readable .md files, specifying the verb (Export), resource (active memories), and output format. This distinguishes it from other memory tools like import or load, but it could be more explicit about where the files are created (implied by export_path).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool vs. alternatives such as memory_make_portable or memory_load_from_folder. The description does not mention prerequisites, limitations, or scenarios where this export is appropriate.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

memory_get_rulesB

Get all mandatory and forbidden rules (direct SQL, cached).

ParametersJSON Schema
NameRequiredDescriptionDefault
projectNo

Output Schema

ParametersJSON Schema
NameRequiredDescription

No output parameters

TDQS

B3.2/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden. It mentions 'direct SQL, cached' which implies performance characteristics and possible bypass of higher-level APIs, but lacks detail on safety or side effects for a read operation.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single concise sentence that front-loads the key action. No redundant words, but could include more detail without harming conciseness.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the one parameter and available output schema, the description is too sparse. It does not explain what 'mandatory and forbidden' rules mean, the effect of the optional 'project' parameter, or the structure of the output.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has one parameter 'project' with no description, and the tool description does not explain its purpose or effect. Schema description coverage is 0%, and the description fails to compensate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the verb 'Get', the resource 'rules', and specifies 'mandatory and forbidden' with implementation details 'direct SQL, cached'. It distinguishes from sibling tools that add/update/delete rules.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description does not explicitly compare with alternatives like 'memory_list' or provide when-not-to-use guidance. Usage is implied as the primary read for rule retrieval.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

memory_importC

Import memories from exported .md files.

ParametersJSON Schema
NameRequiredDescriptionDefault
projectNo
import_pathYes

Output Schema

ParametersJSON Schema
NameRequiredDescription

No output parameters

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries full burden. It fails to disclose whether the import merges, overwrites, or appends memories, file format specifics, or error behavior.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is very concise (one short sentence) but achieves no wasted words. However, it is too brief for the complexity of the task; could add more detail without being verbose.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool has an output schema and many sibling import tools, the description lacks details on import behavior, what the output represents, and how it differs from related tools.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 0%, so description must compensate. It does not explain the 'import_path' parameter's expected format or the optional 'project' parameter's role beyond the bare minimum.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Description clearly states the verb ('import'), resource ('memories'), and source ('exported .md files'), distinguishing it from sibling tools like 'memory_export', 'memory_import_claude_md', and 'memory_import_rules'.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool versus alternatives like 'memory_import_claude_md' or 'memory_import_rules'. Lacks context about prerequisites or exclusions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

memory_import_claude_mdA

Import a project's CLAUDE.md into memory as categorized entries.

path is the CLAUDE.md file or the directory containing it. Headings are mapped to categories (rules, architecture, decisions, devops, docs...) and rule sections are split per bullet. When stub_rewrite=True, CLAUDE.md is replaced with a slim pointer at memory MCP (the original is backed up).

ParametersJSON Schema
NameRequiredDescriptionDefault
pathYes
projectNo
stub_rewriteNo

Output Schema

ParametersJSON Schema
NameRequiredDescription

No output parameters

TDQS

A4.2/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description fully discloses key behaviors: heading-to-category mapping, bullet splitting, and stub_rewrite with backup. It covers the main side effects but lacks details on error handling or idempotency.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Concise two-paragraph structure with clear first sentence and efficient bullet-like details. No redundant information; every sentence adds value.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Covers main functionality and parameters well, but lacks information on prerequisites (e.g., file existence), error cases, or return value details (though output schema exists). Still fairly complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 0%, but description explains 'path' (file or directory) and 'stub_rewrite' (replaces file with pointer). However, 'project' parameter is not described, requiring inference from default null.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states exactly what the tool does: import a CLAUDE.md file into memory with category mapping and optional stub rewrite. It distinguishes from siblings like memory_import and memory_load_from_folder by focusing on CLAUDE.md files.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage for importing CLAUDE.md files but does not explicitly state when to use this tool versus alternatives like memory_import or when not to use it. No exclusions or context provided.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

memory_import_rulesA

Copy selected rules/memories from another project into this one. Use memory_get_rules(source_project) first to get the ids to import.

ParametersJSON Schema
NameRequiredDescriptionDefault
projectNo
memory_idsYes
source_projectYes

Output Schema

ParametersJSON Schema
NameRequiredDescription

No output parameters

TDQS

A4.4/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden. It discloses the basic behavior (copy/import) but does not specify whether existing rules are overwritten, whether the operation is reversible, or any side effects. The description is adequate but lacks depth on behavioral traits.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences with no fluff: first sentence states the purpose, second provides a specific usage instruction. Every sentence earns its place.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's moderate complexity (3 parameters, no annotations) and the existence of an output schema, the description covers the core functionality well. It explains the source_project and memory_ids, but does not clarify the optional project parameter or the meaning of 'this one.' Still, it is mostly complete for a copy/import tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, so the description must compensate. It explains that 'source_project' is the project to copy from and that 'memory_ids' should be obtained via memory_get_rules. However, the optional 'project' parameter (default null) is not explained, leaving ambiguity about its purpose. Overall, it adds significant meaning beyond the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('Copy selected rules/memories from another project into this one') and specifies the resource (rules/memories). It differentiates from siblings by mentioning a prerequisite step (use memory_get_rules to get ids), which is unique to this tool.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description explicitly says when to use this tool (to import rules/memories from another project) and provides a step-by-step usage hint: 'Use memory_get_rules(source_project) first to get the ids to import.' This gives clear guidance on how to prepare the input.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

memory_init_projectA

Initialize a new project namespace (creates DuckDB + registers it).

Pass project_path (the project's source folder) to enable git-synced memory: rules/decisions mirror to /.claude-memory/.

ParametersJSON Schema
NameRequiredDescriptionDefault
slugYes
set_activeNo
descriptionNo
display_nameYes
project_pathNo

Output Schema

ParametersJSON Schema
NameRequiredDescription

No output parameters

TDQS

A3.5/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries full burden. It discloses key behavioral traits: creates a database, registers it, and enables git-synced memory. However, it does not mention side effects like overwriting existing projects, permission requirements, or potential failures.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences that are front-loaded with purpose and essential details. No fluff. Every sentence adds value.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Despite having an output schema, the description lacks completeness. It does not clarify required parameters (slug, display_name) or optional ones (description, set_active). The initialization process may have constraints or defaults that are undocumented.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 0%, so description must compensate. It explains project_path's role in enabling git sync, but ignores slug, display_name, description, and set_active. Two out of five parameters are partially explained.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's function: 'Initialize a new project namespace' and adds technical detail about creating DuckDB and registering it. It distinguishes from siblings like memory_rename_project or memory_list_projects by focusing on initialization.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No explicit guidance on when to use this tool vs alternatives. The description implies it's for new projects but does not mention when not to use it or suggest other tools for related tasks (e.g., renaming or listing projects).

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

memory_listC

List memories with filtering, sorting, and pagination.

ParametersJSON Schema
NameRequiredDescriptionDefault
tagsNo
limitNo
offsetNo
statusNoactive
projectNo
sort_byNoupdated_at
categoryNo
sort_orderNodesc

Output Schema

ParametersJSON Schema
NameRequiredDescription

No output parameters

TDQS

C2.6/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description should carry the burden of behavioral disclosure. It only states the basic functionality and does not mention side effects (expected none), rate limits, output details, or prerequisites like authentication or project scoping.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence, which is efficient but may be too brief given the tool's complexity. It front-loads the main action but lacks structure and additional context.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given 8 parameters, many sibling tools, and no annotations, the description is insufficient. It does not cover default behaviors, pagination limits, or how results are sorted by default. The existence of an output schema is not mentioned, though it partially compensates.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema has 8 parameters with 0% description coverage. The description only vaguely groups parameters into filtering, sorting, and pagination but does not explain individual parameters or their semantics, leaving the agent to infer from names and defaults.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool lists memories and mentions filtering, sorting, and pagination, which helps differentiate it from other tools like memory_search or memory_recall. However, it does not explicitly distinguish it from all sibling tools.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool versus alternatives such as memory_search, memory_recall, or memory_list_projects. The description only states what it does, not when or when not to use it.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

memory_list_projectsA

List all registered projects.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription

No output parameters

TDQS

A3.5/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, and the description does not explicitly state that the operation is read-only or side-effect-free. While it implies a simple list, more transparency would be beneficial.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is one concise sentence with no extraneous words. It front-loads the purpose effectively.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The output schema handles return values, so the description is adequate for a simple list. However, it could mention scope (e.g., 'all projects in the current session') or edge cases.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

There are no parameters, so the baseline is 4. The description does not need to add parameter semantics.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description 'List all registered projects' uses a specific verb ('list') and resource ('projects'), clearly distinguishing it from siblings like 'memory_list' which lists memories.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool versus alternatives such as 'memory_project_info' or 'memory_attach_project'. The description provides no context for usage.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

memory_list_templatesA

List reusable rule/memory templates that can be applied to new projects.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription

No output parameters

TDQS

A4/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden. It describes a read-only listing operation without side effects, but it does not explicitly confirm that the tool is non-destructive or mention any other behavioral traits.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, front-loaded sentence that conveys the purpose without extraneous words. Every part is essential.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The tool has no parameters and a likely simple return value (list of templates). The description is sufficient for a basic understanding, though it could mention the output format. Since an output schema exists, the description is adequately complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has zero parameters, so no parameter explanation is needed. The description does not add parameter information, but with 100% schema coverage and no parameters, the baseline of 4 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the verb 'List' and the resource 'reusable rule/memory templates', and it distinguishes from siblings like memory_create_template and memory_apply_template, which create or apply templates.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies the tool is used to see available templates before applying them, but it does not explicitly state when to use it versus alternatives, such as before calling memory_apply_template. No exclusions or context provided.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

memory_load_from_folderA

Load a project from a local folder.

The project name is taken from the folder's package.json ("name") or the folder name. If the folder already contains a portable .memory-mcp.duckdb it is attached as-is; otherwise the project is created and a CLAUDE.md, if present, is imported into memory. The project is auto-activated.

ParametersJSON Schema
NameRequiredDescriptionDefault
pathYes

Output Schema

ParametersJSON Schema
NameRequiredDescription

No output parameters

TDQS

A4.4/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries full burden and covers key behaviors: auto-activation, database attachment or creation, and CLAUDE.md import. It does not detail nondestructive assurance, permissions, or error handling, but the provided details are substantial.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is three sentences, each serving a distinct purpose: stating the overall action, detailing name derivation and database handling, and noting auto-activation. No extraneous information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the single parameter and presence of an output schema, the description covers all essential aspects: load behavior, name logic, database state handling, CLAUDE.md import, and post-load activation. It is sufficiently complete for an agent to use correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 0%, but the description fully explains the single 'path' parameter: it's a local folder, and the project name is derived from package.json or folder name. This adds significant meaning beyond the schema's bare type definition.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses the specific verb 'Load' and resource 'project from a local folder', clearly stating the tool's function. It also implies differentiation from sibling tools like memory_init_project by noting that if a database already exists, it is attached as-is, and otherwise created with CLAUDE.md import.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description explains what the tool does but does not explicitly state when to use it versus alternatives like memory_init_project or memory_link_folder. It provides no 'when-not-to-use' guidance or comparison to siblings, leaving usage context implied.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

memory_make_portableC

Move the project's DB into the project directory for git sharing.

ParametersJSON Schema
NameRequiredDescriptionDefault
projectNo
project_pathYes

Output Schema

ParametersJSON Schema
NameRequiredDescription

No output parameters

TDQS

C2.5/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries full burden. The description only says 'move' without explaining whether it copies or deletes the original, what 'project DB' refers to, or any side effects. This is insufficient for a mutating tool.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness2/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single short sentence, but it lacks necessary detail. While front-loaded, it is too terse to be useful. Every sentence should earn its place, but this one omits critical information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness1/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given no annotations, 0% schema coverage, and no explanation of return values (though output schema exists), the description is completely inadequate. It does not describe behavior, prerequisites, or consequences, leaving the agent unable to use the tool correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, but the description does not explain the parameters 'project' and 'project_path'. The optional 'project' parameter is not described at all, and 'project_path' is not clarified. The description adds no value beyond what the schema provides.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action: moving the project's DB into the project directory for git sharing. It specifies the verb 'move', the resource 'project DB', and the purpose, distinguishing it from other memory tools like memory_sync or memory_export.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool versus alternatives like memory_sync or memory_export. The description does not provide context for appropriate usage or prerequisites.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

memory_model_infoC

Current embedding model + available presets.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription

No output parameters

TDQS

C2.8/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description must disclose behavioral traits. It only states the output content (model and presets) but does not mention that it is a read-only operation, any authentication needs, or potential side effects. The description is too minimal.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is extremely short (one sentence), which is concise but at the cost of completeness. It is front-loaded but could benefit from a clearer verb and additional context.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the simplicity of the tool (no parameters) and existence of an output schema, the description is minimally adequate. It hints at the return content but does not clarify that it is informational only or how it differs from similar tools.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool has zero parameters, so the baseline is 4. The description adds minimal context but does not contradict the schema. No parameter documentation is needed, and the description provides a hint of what the output covers.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description 'Current embedding model + available presets.' is a noun phrase that vaguely indicates what the tool returns, but lacks a specific verb like 'get' or 'retrieve'. It distinguishes from siblings like 'memory_version' only by name, not by explicit differentiation.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus alternatives such as 'memory_set_model' or 'memory_version'. The description does not mention context, prerequisites, or exclusions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

memory_project_infoC

Get detailed info for a project.

ParametersJSON Schema
NameRequiredDescriptionDefault
projectNo

Output Schema

ParametersJSON Schema
NameRequiredDescription

No output parameters

TDQS

C2.4/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries full responsibility for disclosing behavioral traits. It only states 'Get detailed info,' implying a read operation, but does not mention side effects, authentication, rate limits, or how the optional null parameter behaves (e.g., defaults to current project). The bare description fails to provide transparency beyond the basic action.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single clear sentence, which is concise but at the expense of necessary detail. It is front-loaded with the core action, but it omits critical information about the parameter and usage context. Conciseness should not sacrifice completeness; here it does.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The tool is simple with one parameter, but the description is incomplete. While an output schema exists, the parameter and default behavior are unexplained. For a tool with 0% schema coverage, the description should provide more context about the project parameter and when to use it. The current description does not enable safe and effective invocation.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, and the description does not explain the 'project' parameter at all. It lacks format, valid values, default behavior, or semantics. The output schema exists but the description adds no meaning beyond the schema structure. This is insufficient for the agent to use the parameter correctly.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('Get') and resource ('detailed info for a project'), making the purpose clear. It distinguishes itself from siblings like memory_list_projects (which lists projects) and memory_store (which stores data). However, it does not clarify what 'detailed info' includes or that the optional parameter defaults to the current project, which slightly reduces specificity.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. Given the large number of sibling tools (e.g., memory_list_projects, memory_store, memory_recall), the lack of usage context or exclusions leaves the agent without decision support.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

memory_provenanceC

Get the full audit trail for a memory.

ParametersJSON Schema
NameRequiredDescriptionDefault
projectNo
memory_idYes

Output Schema

ParametersJSON Schema
NameRequiredDescription

No output parameters

TDQS

C2.4/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden. It only states 'Get the full audit trail,' which implies a read-only operation but gives no details on performance, limits, or what 'full' entails. No behavioral traits beyond the basic action are disclosed.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence, making it concise, but it omits crucial information about parameters and usage. It is front-loaded with the purpose but under-specified for effective tool invocation.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given an output schema exists, return values are not required, but the description still lacks detail about input parameters and behavioral context. The minimal description is insufficient for a tool with two parameters and no schema descriptions.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 0%, meaning no parameter descriptions exist in the schema. The tool description does not explain what 'memory_id' or 'project' represent or how to use them, adding no semantic value beyond the schema's structural definition.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states 'Get the full audit trail for a memory' with a specific verb and resource, distinguishing it from siblings focused on storing, updating, or deleting memories. However, 'full audit trail' is somewhat vague and does not explicitly differentiate it from version tracking tools like memory_version.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool versus alternatives. It is implied that it is for retrieving audit trails, but there are no exclusion criteria, prerequisites, or mentions of related tools despite many siblings.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

memory_recallC

Recall a specific memory by ID or exact title.

ParametersJSON Schema
NameRequiredDescriptionDefault
titleNo
projectNo
memory_idNo

Output Schema

ParametersJSON Schema
NameRequiredDescription

No output parameters

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description should disclose side effects, authentication, or return behavior. It only states 'Recall', implying read-only, but fails to mention case sensitivity, uniqueness, or how missing parameters behave.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence, which is concise but lacks structure. It states the core function but provides no additional context or organization beyond that.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the many sibling tools and three optional parameters with no descriptions, the description is too brief. It does not address expected output (despite an output schema), parameter relationships, or the tool's specific role in the broader set.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0% so the description must explain parameters. It mentions memory_id and title but omits the project parameter entirely. No explanation that parameters may be combined or are mutually exclusive, leaving ambiguity.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool retrieves a specific memory by ID or exact title, differentiating it from siblings like memory_search (likely fuzzy) and memory_list. The verb 'recall' and resource 'memory' are precise.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool versus alternatives such as memory_search or memory_list. The description implies exact matching but does not explicitly advise against using for fuzzy or list operations.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

memory_reembedC

Re-embed all active memories with the current model.

ParametersJSON Schema
NameRequiredDescriptionDefault
projectNo

Output Schema

ParametersJSON Schema
NameRequiredDescription

No output parameters

TDQS

C2.8/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. It only states the action but omits important details such as whether the re-embedding is destructive, requires certain permissions, or has performance implications (e.g., affecting all active memories).

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence with no wasted words. However, it may be too brief for the complexity of the tool, lacking necessary details that could be added without harming conciseness.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool has one undocumented parameter and no usage guidelines or behavioral details, the description is incomplete. While an output schema exists, the description does not provide enough context for an agent to select and invoke this tool correctly among many siblings.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The description does not mention the only parameter 'project' (optional, string or null). Schema description coverage is 0%, so the description adds no value beyond what the schema provides, leaving the agent without guidance on how to use the parameter.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action (re-embed) and the resource (all active memories) with a specific context (with the current model). It effectively differentiates from sibling tools like memory_store or memory_recall by using a unique verb 're-embed'.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. It does not mention prerequisites, exclusions, or scenarios where this tool is preferred over siblings like memory_set_model or memory_store.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

memory_rename_projectC

Rename a project (its display name) and optionally update its description.

ParametersJSON Schema
NameRequiredDescriptionDefault
projectNo
descriptionNo
display_nameYes

Output Schema

ParametersJSON Schema
NameRequiredDescription

No output parameters

TDQS

C2.7/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description must fully disclose behavior. It only states that the tool renames a project and optionally updates description, which implies mutation. No details on side effects, reversibility, permissions, or what happens to related data.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence with no wasted words. It is structured efficiently, but could benefit from a bit more detail without becoming verbose.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given 3 parameters and no annotations, the description is incomplete. It does not explain the 'project' parameter, nor does it reference the output schema or any return values. For a task that involves identifying a project, this is a significant gap.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%. The description mentions 'display_name' and 'description' but omits the 'project' parameter entirely. The 'project' parameter is optional and has default null, but no explanation is given for its purpose or how to identify the project. This leaves the agent unaware of a critical parameter.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the verb 'Rename' and the resource 'project (its display name)'. It also mentions the optional description update. However, it does not explicitly distinguish this tool from siblings like 'memory_update' which might also modify project attributes.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool over alternatives (e.g., memory_update, memory_project_info). It lacks any context about prerequisites, exclusions, or recommendation.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

memory_session_endC

End a session and store its summary.

ParametersJSON Schema
NameRequiredDescriptionDefault
projectNo
summaryYes
session_idYes
memories_createdNo
memories_accessedNo

Output Schema

ParametersJSON Schema
NameRequiredDescription

No output parameters

TDQS

C2.8/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries full burden but only states it ends a session and stores a summary. It does not disclose side effects, permanence, required permissions, or what happens to the session data.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, front-loaded sentence with no wasted words. However, it may be too brief given the tool's complexity.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The description lacks essential context for a tool with 5 parameters, no annotations, and an output schema (not explained). It does not specify what 'ending a session' entails, prerequisites, or the role of 'summary'. Incomplete for effective use.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0% and the description adds no meaning to any of the 5 parameters (session_id, summary, project, memories_created, memories_accessed). The agent gains no insight into parameter roles or formats beyond the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the verb 'End' and the resource 'a session', with the additional action 'store its summary'. It distinctly contrasts with sibling tools like 'memory_session_start'.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus others, no prerequisites or when-not-to-use context, leaving the agent without decision support.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

memory_session_startB

Start a session. Loads rules, last summary, sprint goals, recent decisions.

ParametersJSON Schema
NameRequiredDescriptionDefault
projectNo

Output Schema

ParametersJSON Schema
NameRequiredDescription

No output parameters

TDQS

B3/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations exist, so the description must disclose behavioral traits. It states that a session is started and that specific data is loaded, which is adequate but does not mention potential side effects, prerequisites, or behavior if a session is already active.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence, concise and front-loaded, but could benefit from a slightly more structured format (e.g., listing loaded items separately). No wasted words.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Despite having an output schema and only one parameter, the description lacks critical context such as return value behavior, what happens when 'project' is provided vs null, or how session state is managed. It feels incomplete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has one parameter ('project') with no description coverage (0%). The description does not mention or explain this parameter, leaving its purpose and effect completely unclear.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a specific verb ('Start') and resource ('session') and lists key loading actions (rules, last summary, sprint goals, recent decisions), which clearly distinguishes it from sibling tools like memory_session_end or memory_store.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus alternatives (e.g., when a session already exists, or before calling other memory tools). The description only states what it does, not when it is appropriate.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

memory_set_modelC

Switch embedding model between 'english' and 'multilingual' presets.

ParametersJSON Schema
NameRequiredDescriptionDefault
presetYes
confirmNo
projectNo

Output Schema

ParametersJSON Schema
NameRequiredDescription

No output parameters

TDQS

C2.8/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden. It mentions switching presets but does not disclose any behavioral traits such as whether the operation is destructive, requires confirmation, or affects existing data. The presence of a 'confirm' parameter is not explained.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, efficient sentence that contains no redundant information. It is optimally concise.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's complexity (3 parameters, output schema, state-changing action), the description is too minimal. It omits necessary context about impact, usage scenarios, and parameter details, making it incomplete for safe and effective use.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With 0% schema description coverage, the description should explain all parameters. It only explains the 'preset' parameter by listing its values. The 'confirm' and 'project' parameters are completely undocumented in both the description and schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the verb 'Switch' and resource 'embedding model', and names the two presets ('english' and 'multilingual'). It leaves no ambiguity about the tool's primary action. However, it does not differentiate from sibling tools like memory_model_info or memory_reembed.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

There is no guidance on when to use this tool versus alternatives (e.g., when to switch models, prerequisites, or consequences). The description only states the action without context.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

memory_storeB

Store a new memory with auto-embedding, summary, entity extraction, and TTL.

ParametersJSON Schema
NameRequiredDescriptionDefault
tagsNo
titleYes
sourceNoassistant
contentYes
projectNo
categoryYes
metadataNo
priorityNo
related_idsNo

Output Schema

ParametersJSON Schema
NameRequiredDescription

No output parameters

TDQS

B3/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries full burden. It reveals that the tool performs auto-embedding, summary extraction, entity extraction, and applies a TTL. However, it omits details like required permissions, rate limits, side effects on existing data, or whether the process is synchronous.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

A single 11-word sentence that efficiently conveys the tool's core purpose and automatic features. No redundant information; every phrase earns its place.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Despite having an output schema, the description does not explain the return value. With 9 parameters, many optional, and no annotation or schema descriptions, the single sentence leaves significant gaps in understanding the tool's behavior and how to use it effectively among 30+ siblings.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, and the description adds no parameter-level details. It mentions 'content' but does not clarify the meaning or constraints of 'tags', 'metadata', 'priority', or 'related_ids'. The schema lists defaults but the description does not leverage them.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('Store') and resource ('new memory'), and lists key features (auto-embedding, summary, entity extraction, TTL) that distinguish it from update, delete, or query tools. However, it does not explicitly contrast with siblings like memory_update or memory_use.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool versus alternatives. The description does not mention prerequisites, typical use cases, or when not to use it. The default source 'assistant' is not explained.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

memory_syncC

Sync a portable DB after git pull. Auto-activates on success.

ParametersJSON Schema
NameRequiredDescriptionDefault
slugNo
project_pathYes

Output Schema

ParametersJSON Schema
NameRequiredDescription

No output parameters

TDQS

C2.6/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Mentions auto-activates on success, but lacks details on safety, auth requirements, or side effects. No annotations to supplement.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

One sentence, no waste, but oversimplified; could add parameter context without being verbose.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Output schema exists but unmentioned; with many siblings, more context on what 'sync' entails and return value is needed.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 0%, and description does not explain 'slug' or 'project_path' beyond names, leaving meaning ambiguous.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

Describes a specific action: syncing a portable DB after git pull, which distinguishes it from siblings like memory_make_portable or memory_check_update.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Only states after git pull, but provides no guidance on when not to use or alternatives among siblings.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

memory_updateC

Update an existing memory. Re-embeds if title/content changed.

ParametersJSON Schema
NameRequiredDescriptionDefault
tagsNo
titleNo
statusNo
contentNo
projectNo
metadataNo
priorityNo
memory_idYes
related_idsNo

Output Schema

ParametersJSON Schema
NameRequiredDescription

No output parameters

TDQS

C2.4/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The only behavioral disclosure is the re-embedding trigger on title/content change. With no annotations, the description should cover idempotency, required permissions, error scenarios, and return behavior, but it does not.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two brief sentences, front-loaded with the core action. However, conciseness sacrifices necessary detail for a tool with many parameters.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness1/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given 9 parameters, no schema descriptions, no annotations, and an output schema, the description is severely incomplete. It fails to explain parameter usage, return values, or typical use cases.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, so the description must compensate, but it provides no meaning for any of the 9 parameters. The parameter names are self-explanatory to some degree, but the description adds no extra value.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the verb 'update' and resource 'memory', and hints at a side effect (re-embedding). It distinguishes from sibling creation/deletion tools, though it does not explicitly mention that it requires an existing memory.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool versus alternatives like memory_store or memory_delete. Among many sibling tools, no context is provided for decision-making.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

memory_update_ruleC

Update an existing mandatory or forbidden rule by its id.

ParametersJSON Schema
NameRequiredDescriptionDefault
titleNo
contentNo
projectNo
rule_idYes

Output Schema

ParametersJSON Schema
NameRequiredDescription

No output parameters

TDQS

C2.8/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries full burden but only states 'Update' without disclosing side effects, idempotency, error handling for missing rule, or any behavioral traits. The presence of an output schema is not leveraged in the description.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

One efficient sentence with no wasted words. However, it could include more relevant details without becoming verbose.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The description is minimal and does not cover key aspects like which fields are updatable, constraints, or behavior when rule_id is invalid. Given the sibling tools and complexity, more context is needed.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, and the description adds no meaning beyond the parameter names. It only explains that rule_id identifies the rule, but does not describe title, content, or project fields.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action (Update), the resource (existing mandatory or forbidden rule), and the identifier (by its id). It effectively distinguishes from sibling tools like memory_add_rule and memory_delete_rule.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool versus alternatives. There is no mention of prerequisites, such as the rule must exist or the type constraints (mandatory vs forbidden).

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

memory_useC

Set the active project. Subsequent tools use it by default.

ParametersJSON Schema
NameRequiredDescriptionDefault
projectYes

Output Schema

ParametersJSON Schema
NameRequiredDescription

No output parameters

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description must fully disclose behavior. It mentions that subsequent tools use the active project by default, but it does not disclose potential side effects, reversibility, or permission requirements.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is extremely concise—two short sentences with no wasted words. Each sentence serves a clear purpose: the first defines the action, the second explains the consequence.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the presence of many sibling tools and an output schema, the description leaves significant gaps. It does not explain what 'active project' means, how it interacts with other tools, or what the output contains.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The description does not mention the 'project' parameter at all. With 0% schema description coverage, the description fails to add any meaning beyond the bare schema, leaving the agent uninformed about what values to provide.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states 'Set the active project,' which is a specific verb and resource. It distinguishes itself from sibling tools like memory_init_project and memory_rename_project by focusing on setting the active project for default use.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives such as memory_attach_project or memory_init_project. It does not specify prerequisites or scenarios where this tool is appropriate.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

memory_versionA

Get the current version of the Memory MCP server and configuration.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription

No output parameters

TDQS

A4.3/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The description states the tool performs a read operation ('Get'), which is non-destructive. However, with no annotations provided, the description does not disclose potential latency, authentication requirements, or whether the version is cached. For a simple version check, this is adequate but minimally transparent.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, clear sentence with no unnecessary words. It is front-loaded with the key information ('Get the current version') and is appropriately sized for a simple tool. Every word contributes meaning.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's low complexity (no parameters, trivial function) and the existence of an output schema (which covers return values), the description is complete. It specifies what information is returned (version of server and configuration) and no additional context is needed.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool has no parameters, so the description does not need to add parameter details. The input schema is fully defined and empty, achieving 100% coverage. The description adds no extra parameter semantics, but none are needed, justifying the baseline score of 4.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool retrieves the current version of the Memory MCP server and configuration. The verb 'Get' is specific, and the resource 'version of the Memory MCP server and configuration' is unambiguous. This distinguishes it from all sibling tools, which focus on data operations, project management, or configuration changes.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implicitly indicates that this tool is for checking version information. No sibling tool provides version data, so there are no alternatives to exclude. However, explicit guidance on when to use it (e.g., before performing updates or troubleshooting) is absent but not critical given the tool's simplicity.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. 37 tool updatesv0.6.0
    • First observedmemory_add_rule
    • First observedmemory_add_rule_bulk
    • First observedmemory_add_template_rule
    • First observedmemory_apply_template
    • First observedmemory_attach_project
    • First observedmemory_check_update
    • First observedmemory_create_template
    • First observedmemory_delete
    • First observedmemory_delete_rule
    • First observedmemory_export
    • First observedmemory_get_rules
    • First observedmemory_import
    • First observedmemory_import_claude_md
    • First observedmemory_import_rules
    • First observedmemory_init_project
    • First observedmemory_link_folder
    • First observedmemory_list
    • First observedmemory_list_projects
    • First observedmemory_list_templates
    • First observedmemory_load_from_folder
    • First observedmemory_make_portable
    • First observedmemory_model_info
    • First observedmemory_project_info
    • First observedmemory_provenance
    • First observedmemory_recall
    • First observedmemory_reembed
    • First observedmemory_rename_project
    • First observedmemory_search
    • First observedmemory_session_end
    • First observedmemory_session_start
    • First observedmemory_set_model
    • First observedmemory_store
    • First observedmemory_sync
    • First observedmemory_update
    • First observedmemory_update_rule
    • First observedmemory_use
    • First observedmemory_version

TDQS

A3.5/5.0
Disambiguation5/5

Each tool has a distinct and clear purpose, with names like memory_store, memory_search, memory_add_rule, and memory_session_start all targeting different operations. While there are many tools, descriptions ensure they are easily distinguished, and there is no ambiguity.

Naming Consistency5/5

All tools follow a consistent 'memory_<verb>_<noun>' pattern (e.g., memory_list_projects, memory_init_project, memory_add_rule, memory_session_end). No mixing of conventions, making it predictable and easy to navigate.

Tool Count4/5

37 tools is higher than typical but justified by the broad scope: project management, memory CRUD, rules, templates, sessions, import/export, and model configuration. A slight reduction could improve simplicity, but it remains well-scoped for the domain.

Completeness5/5

The tool surface covers the full lifecycle of memory management: create/read/update/delete for memories, projects, and rules, plus sessions, templates, import/export, and version checking. No obvious gaps for the intended purpose of a persistent memory server.

Maintenance

ActivityInactive
ResponsivenessSyncing

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    B
    maintenance
    Persistent memory + FTS5 full-text search for Claude Code conversation history. Indexes ~/.claude/projects/ JSONL into SQLite, exposes 10 MCP tools (store/recall/search memories, browse sessions, get summaries) plus prompts. Includes a web UI for visual exploration
    10
    94
    91
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Provides persistent, searchable memory for Claude Code using local SQLite, semantic embeddings, and full-text search, enabling Claude to recall and retrieve context across sessions and projects without external services.
    19
    4
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    Provides local-first, cross-session memory for Claude Code, enabling semantic search across past sessions to retrieve procedures, decisions, or answers without exposing secrets.
    Apache 2.0

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/navid-kianfar/claude-memory-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server