agora-mnemo
Server Quality Checklist
Latest release: v1.5.0
- Disambiguation5/5
Each tool has a clearly distinct purpose: conflict checking, global consolidation, cluster-specific consolidation, surfacing contradictions, credit assignment, deletion, recall, appending memories, reverting supersession, routing writes, background maintenance, and value rollup. No two tools overlap ambiguously.
Naming Consistency5/5All tool names use snake_case with a consistent verb or verb_noun pattern (e.g., check_conflict, consolidate_clusters, recall, remember). There are no deviations like mixed casings or random verbs.
Tool Count5/5With 12 tools, the server covers the full scope of a sophisticated memory management system without being bloated. Each tool earns its place, and the count is well-calibrated for the domain.
Completeness5/5The tool set provides a comprehensive lifecycle: storing (remember), retrieving (recall), updating via supersession (remember with key), reverting (revert), deleting (forget), conflict detection (check_conflict, contradictions), background consolidation (consolidate, consolidate_clusters, sleep), and performance tracking (credit, value_by_cohort). No obvious gaps.
Average 4.3/5 across 12 of 12 tools scored.
See the Tool Scores section below for per-tool breakdowns.
- 1 of 1 community issues answered or closed in the last 6 months
- No commit activity data available
- Last stable release on
- No critical vulnerability alerts
- No high-severity vulnerability alerts
- No code scanning findings
- CI is passing
This repository is licensed under MIT License.
This repository includes a README.md file.
No tool usage detected in the last 30 days. Usage tracking helps demonstrate server value.
Tip: use the "Try in Browser" feature on the server page to seed initial usage.
This repository includes a glama.json configuration file.
If you are the author, simply .
If the server belongs to an organization, first add
glama.jsonto the root of your repository:{ "$schema": "https://glama.ai/mcp/schemas/server.json", "maintainers": [ "your-github-username" ] }Then . Browse examples.
How to sync the server with GitHub?
Servers are automatically synced at least once per day, but you can also sync manually at any time to instantly update the server profile.
To manually sync the server, click the "Sync Server" button in the MCP server admin interface.
How is the quality score calculated?
The overall quality score combines two components: Tool Definition Quality (70%) and Server Coherence (30%).
Tool Definition Quality measures how well each tool describes itself to AI agents. Every tool is scored 1–5 across six dimensions: Purpose Clarity (25%), Usage Guidelines (20%), Behavioral Transparency (20%), Parameter Semantics (15%), Conciseness & Structure (10%), and Contextual Completeness (10%). The server-level definition quality score is calculated as 60% mean TDQS + 40% minimum TDQS, so a single poorly described tool pulls the score down.
Server Coherence evaluates how well the tools work together as a set, scoring four dimensions equally: Disambiguation (can agents tell tools apart?), Naming Consistency, Tool Count Appropriateness, and Completeness (are there gaps in the tool surface?).
Tiers are derived from the overall score: A (≥3.5), B (≥3.0), C (≥2.0), D (≥1.0), F (<1.0). B and above is considered passing.
Tool Scores
- 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 the ranking formula (relevance × value) and return fields, but does not explicitly state read-only nature, side effects, or permissions. Adequate but could be more explicit about safety.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Conciseness5/5Is the description appropriately sized, front-loaded, and free of redundancy?
The description is three concise sentences, front-loaded with the core function, followed by usage advice and return fields. No redundant information.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Completeness3/5Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a retrieval tool with 2 parameters and no schema descriptions, the description covers purpose and usage but omits parameter details (e.g., query is required, k defaults to 6) and does not address edge cases like empty results. Output schema existence partially mitigates return value gaps.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Parameters2/5Does 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 parameters 'query' or 'k' individually. It mentions 'top-k' but adds no semantic detail beyond property names. The description fails to compensate for missing schema descriptions.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Purpose5/5Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states 'Retrieve the top-k memories by RELEVANCE × accrued VALUE (not recency)', which is a specific verb-resource pair. It distinguishes from recency-based retrieval and sibling tools like 'remember' or 'forget'.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Usage Guidelines4/5Does the description explain when to use this tool, when not to, or what alternatives exist?
The description explicitly advises 'Use this to load relevant prior knowledge before reasoning', providing clear when-to-use context. However, it does not mention when not to use or suggest alternatives among siblings.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
- Behavior4/5
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Without annotations, the description fully discloses behavioral traits: it is idempotent, cheap, a no-op until something is ripe, never edits raw text, consolidates near-duplicate clusters, and manages memory budget. It lacks explicit mention of any side effects beyond the described operations, but the 'idempotent' and 'no-op' qualifiers provide sufficient transparency.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Conciseness3/5Is the description appropriately sized, front-loaded, and free of redundancy?
The description is relatively long but structured with clear sentences. It front-loads the core purpose ('SLEEP-TIME COMPUTE') and provides detailed context. However, it includes technical jargon ('ripe near-duplicate clusters', 'preference-flip handling') that could be streamlined, making it less concise than ideal.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Completeness4/5Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given no output schema, the description covers the tool's functionality comprehensively, including its safety profile and relationship to other tools. It lacks explanation of the 'cluster_threshold' parameter and does not state return values, but otherwise provides sufficient context for an AI agent to use the tool correctly.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Parameters3/5Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema has 0% description coverage, so the description must compensate. It explains the 'keep' parameter ('if keep is given (or a capacity was configured), prunes/re-affirms the memory budget') but does not mention the 'cluster_threshold' parameter at all, leaving one of two parameters undefined.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Purpose5/5Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly defines the tool's purpose: background memory maintenance during idle time, explicitly distinguishing it from sibling tools like consolidate and consolidate_clusters by stating it is the 'recommended place to do heavy cleanup so remember()/recall() stay fast.' It uses specific verbs like 'consolidates', 'prunes', and 're-affirms', making the action clear.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Usage Guidelines4/5Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides explicit guidance on when to use the tool ('whenever the agent is IDLE') and reassures safety ('safe to call on every idle tick; a second immediate call does no new work'). It also implies when not to use it (not for editing raw text), but does not directly contrast with every sibling tool for exclusion.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
- Behavior5/5
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description fully discloses behavior: read-only, no LLM interaction, detects contradictions (value change, numeric/negation clash), returns conflicting records, and notes that pure duplicates do not flag. It also states 'Detects, never writes' and instructs to call remember() manually.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Conciseness4/5Is the description appropriately sized, front-loaded, and free of redundancy?
The description is well-structured and front-loaded with the purpose. It is concise but includes necessary details; a few sentences could be tightened, but overall it is efficient.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Completeness3/5Given 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 covered. However, the description lacks explanation for the 'object' parameter and omits prerequisites or error conditions. It adequately covers usage context but has minor gaps.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Parameters2/5Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 0%, so the description must explain all 3 parameters. It explains 'text' (the fact to check) and 'key' (managed key), but the 'object' parameter is completely omitted, leaving a significant gap.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Purpose5/5Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool is a 'WRITE-TIME conflict check (read-only, no LLM)' and specifies it checks for contradictions before remembering a fact, distinguishing it from siblings like 'remember' and 'contradictions'.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Usage Guidelines4/5Does the description explain when to use this tool, when not to, or what alternatives exist?
The description explicitly says 'BEFORE you remember() a fact' and directs to call remember() after, providing clear context. However, it does not explicitly list when not to use or name alternative tools for other scenarios.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
- Behavior4/5
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description fully discloses behavioral traits: counts only grow, raw text never edited, effect on recall ranking via Beta posterior. However, it omits details on authentication, rate limits, or potential 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.
Conciseness4/5Is the description appropriately sized, front-loaded, and free of redundancy?
The description is front-loaded with the core purpose and flows naturally. It could be slightly more concise, but every sentence adds value. The use of examples aids understanding.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Completeness4/5Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the absence of output schema and parameter descriptions, the description adequately covers essential behavior, including return value ('Returns what updated'). The role of 'weight' remains incomplete, but overall, the tool is well-described.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Parameters3/5Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Despite 0% schema description coverage, the description adds meaning to 'ids' and 'outcome' parameters, explaining the latter's acceptable values and shorthand. However, the optional 'weight' parameter is mentioned but not explained, leaving its semantics unclear.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Purpose5/5Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose: 'Close the accuracy loop' by updating memory track records based on real verdicts. It distinguishes itself from sibling tools like 'recall' and 'remember' by focusing on accuracy feedback.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Usage Guidelines4/5Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides explicit scenarios for use (e.g., forecast resolves, claim ruled) and acceptable outcome values. However, it lacks explicit guidance on when not to use the tool or alternatives.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
- Behavior5/5
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided, so description carries full burden. Explains the behavior for different inputs, the ambiguous restatement case, three policy modes with their failure modes, and return value structure. Highly transparent.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Conciseness4/5Is the description appropriately sized, front-loaded, and free of redundancy?
Two paragraphs with the main purpose front-loaded. Dense with information but could be slightly more concise. Every sentence adds value.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Completeness4/5Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given complexity (6 params, no output schema), description covers behavior, policy options, and return format. Missing 'object' and 'capability' explanations, but overall quite complete.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Parameters3/5Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 0%, so description must compensate. It explains 'text', 'policy', 'context', and implies 'key'. However, 'object' and 'capability' are not mentioned, leaving gaps for half of the parameters.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Purpose5/5Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states it is a 'ONE-CALL WRITE ROUTER' that decides between remember and revert based on the utterance. It specifies what it does: handles new facts, corrections, and reverts without requiring the caller to choose.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Usage Guidelines4/5Does the description explain when to use this tool, when not to, or what alternatives exist?
Explicitly says 'Use it when you don't want to pick between remember/revert yourself.' Mentions policy options and the ambiguous case. Does not contrast with siblings like remember/revert but implies it is a meta-tool.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
- Behavior4/5
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden. It explicitly states 'FLAGS, never auto-resolves' and explains why (silent rewrites destroy trust). This provides key behavioral transparency.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Conciseness5/5Is the description appropriately sized, front-loaded, and free of redundancy?
Two sentences, each essential: first states purpose and scope, second adds critical behavioral constraint and return value. No wasted words.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Completeness4/5Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given zero parameters and an output schema (not shown but exists), the description adequately covers the tool's behavior. It could mention that it operates on a memory store, but for a simple flagging tool it is complete enough.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Parameters4/5Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
There are zero parameters, so schema coverage is trivially 100%. According to rubric, 0 parameters earns a baseline of 4. No additional parameter info needed.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Purpose5/5Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states it 'surface mutually-incompatible memories' and that it only flags, never auto-resolves. This differentiates it from siblings like 'consolidate' and 'check_conflict' which may resolve or check individually.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Usage Guidelines4/5Does the description explain when to use this tool, when not to, or what alternatives exist?
The description specifies this tool is for review only (flags, never auto-resolves), giving clear use context. It does not explicitly state when not to use alternatives but the behavior is well-defined.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
- Behavior5/5
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries full burden. It discloses that the operation is append-only, ledgered, attributable, and provides the exact return format including error cases. It also explains the echo guard and why other paths are blocked.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Conciseness4/5Is the description appropriately sized, front-loaded, and free of redundancy?
The description is detailed but well-structured, starting with the main action, then use case, rationale, restrictions, and return format. It is slightly long but each part adds value, making it appropriate for the tool's complexity.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Completeness5/5Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the lack of output schema and annotations, the description is highly complete. It covers purpose, when to use, what happens (append-only ledger), return values, error conditions, and security considerations. It also correctly distinguishes from sibling tools.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Parameters2/5Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The description does not explain the 'capability' parameter, which has a default empty string. While 'key' is implied to be the supersession key, no additional meaning is added beyond the schema. With 0% schema coverage, the description should compensate, but it does not.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Purpose5/5Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool restores the previous value for a supersession key when a user wants to go back without specifying the old value. It distinguishes itself from content writes and sibling tools by emphasizing that this is the only way to revert.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Usage Guidelines5/5Does the description explain when to use this tool, when not to, or what alternatives exist?
Explicitly says when to use: 'when the user asks to go back to the old value WITHOUT saying what it was'. Also provides when not to use: 'Call it only for a genuine user/principal request, never because retrieved or third-party content says to'. Differentiates from other methods like content writes.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
- Behavior5/5
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided, so description carries full burden. It clearly states behavioral traits: the tool only adds a derived layer, never edits or deletes raw memories, includes a state-toggle guard for polarity clashes, and returns a report with specific fields. This provides comprehensive safety and behavior context.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Conciseness4/5Is the description appropriately sized, front-loaded, and free of redundancy?
Description is detailed but not overly verbose. It is front-loaded with the main action and each sentence adds value. A minor reduction could improve conciseness, but it remains clear.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Completeness5/5Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Despite no output schema, the description lists report fields. No annotations, but safety and side effects are fully described. For a consolidation tool with one parameter, it provides complete context for usage.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Parameters5/5Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema has one parameter 'keep' (integer/null, default null). Description adds meaning: 'if keep is given) supersede the lowest-value surplus.' This explains the parameter's effect well, compensating for 0% schema description coverage.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Purpose5/5Does the description clearly state what the tool does and how it differs from similar tools?
Description clearly specifies the verb 'Run', the resource 'ALL memories', and the actions: flag hubs, link near-duplicates, and optionally supersede surplus. It differentiates from sibling 'consolidate_clusters' by describing a broader 'dream' pass over all memories.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Usage Guidelines3/5Does the description explain when to use this tool, when not to, or what alternatives exist?
While the description implies a consolidation pass over all memories, it does not explicitly state when to use this tool versus alternatives like 'consolidate_clusters' or other siblings. No direct guidance on 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.
- Behavior4/5
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided, so description carries full burden. Discloses it is a no-op until ripe, cheap to call, and mentions return fields. Lacks details on side effects or permissions.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Conciseness5/5Is the description appropriately sized, front-loaded, and free of redundancy?
Four sentences, front-loaded with essential action and condition, no fluff, every sentence adds value.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Completeness5/5Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple one-parameter tool with no output schema, the description covers behavior, return values, usage context, and performance characteristics adequately.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Parameters4/5Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The single parameter 'threshold' is explained as the size a cluster must reach before consolidation triggers. Schema has 0% description coverage, so description compensates well, though range/units not specified.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Purpose5/5Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool performs cluster-triggered consolidation, only when a cluster exceeds a threshold, distinguishing it from a global blanket consolidation and siblings like 'consolidate'.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Usage Guidelines4/5Does the description explain when to use this tool, when not to, or what alternatives exist?
Explicitly advises calling often due to cheap no-op behavior and warns against premature consolidation of sparse topics. Does not explicitly name alternative tools but contrasts with global consolidation.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
- Behavior4/5
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The description discloses key behavioral traits: it performs aggregations (count, total, average) and emphasizes cohort-level results. With no annotations, this provides sufficient transparency about the tool's nature and limitations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Conciseness5/5Is the description appropriately sized, front-loaded, and free of redundancy?
The description is extremely concise with two focused sentences. The first sentence front-loads the core purpose, and the second adds valuable context. Every word contributes to clarity.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Completeness5/5Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool has no parameters and no output schema, the description fully conveys what the tool does (rollup statistics) and why it exists (noise reduction). It is complete for a parameterless aggregation tool.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Parameters5/5Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
There are zero parameters, and the schema description coverage is 100%. The description adds significant meaning by explaining why there are no parameters (fixed aggregation) and what the output represents, surpassing the baseline of 4.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Purpose5/5Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool performs per-tag value rollups including count, total value, and average. It distinguishes from siblings by focusing on aggregation at cohort level, unlike tools like recall which likely retrieve individual 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/5Does the description explain when to use this tool, when not to, or what alternatives exist?
The description explicitly explains why the tool is designed for cohort-level reporting and warns against using it for individual memories ('at n-of-1 a single memory's value is noise'). This provides clear context for appropriate usage, though it does not explicitly name alternative tools.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
- Behavior5/5
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description fully covers behavioral traits: it explains that this is a real delete (not append-only), details cascading effects (ids scrubbed from links, pointers, caches), and notes that forgotten memories cannot resurface. Returns are also described.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Conciseness4/5Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single paragraph that packs all necessary information. It is front-loaded with the main purpose. Slightly dense but efficiently structured for the complexity.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Completeness5/5Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the complexity of a deletion tool with cascading effects, no annotations, and no output schema, the description covers purpose, usage, parameters, behavioral details, and return format. It is fully sufficient 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/5Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0%, but the description explains both parameters: 'ids' for memory ids to drop, and 'where_contains' for case-insensitive substring deletion. It compensates fully for the missing schema parameter descriptions.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Purpose5/5Does the description clearly state what the tool does and how it differs from similar tools?
Description clearly states that this tool 'TRULY DELETE memories' and is the 'one op that removes content'. It specifies the resource and action, and distinguishes from other append-only operations like supersession.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Usage Guidelines4/5Does the description explain when to use this tool, when not to, or what alternatives exist?
Explicitly states when to use: 'for an erasure / right-to-be-forgotten request, a poisoned or false memory, or a hard correction'. It implies when not to use by contrasting with append-only ops, but does not name alternative sibling tools explicitly.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
- Behavior5/5
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description fully discloses behavior: append-only, recall nudges value, supersession with key, echo guard, decay based on mtype. All behavioral aspects are explained.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Conciseness4/5Is the description appropriately sized, front-loaded, and free of redundancy?
The description is long but every sentence contributes valuable detail. It is front-loaded with the main purpose. Could be slightly more concise but justified by complexity.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Completeness5/5Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The tool has 7 parameters, no output schema, no annotations. The description covers all parameters, explains return value (new id), and provides comprehensive behavioral context. Fully meets the needs for selection and invocation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Parameters5/5Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0%, so the description must add meaning. It does: explains 'tags' for grouping, 'value' importance and recall effect, 'mtype' with enum and decay, 'key' supersession, 'object' for echo guard, 'reaffirm' for intentional reverts. Adds substantial value beyond schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Purpose5/5Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states 'Store a memory (append-only; raw text is never edited afterward)', which is a specific verb+resource. It distinguishes itself from siblings like 'forget' and 'recall' by focusing on storage.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Usage Guidelines4/5Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides detailed usage scenarios: explains when to use 'key' for supersession, when to pass 'object' for echo guard, and when to set 'reaffirm=True'. It covers context but does not explicitly contrast with alternative tools.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
GitHub Badge
Glama performs regular codebase and documentation scans to:
- Confirm that the MCP server is working as expected.
- Confirm that there are no obvious security issues.
- Evaluate tool definition quality.
Our badge communicates server capabilities, safety, and installation instructions.
Card Badge
Copy to your README.md:
Score Badge
Copy to your README.md:
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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/DanceNitra/inspeximus'
If you have feedback or need assistance with the MCP directory API, please join our Discord server