forgetDelete a previously stored memory by key. Use when context is stale, the task is done, or you want to clear sensitive data the agent saved earlier. Pair with remember and recall.
| Name | Required | Description | Default |
|---|---|---|---|
| key | Yes | Memory key to delete |
Changes observed during successful MCP inspections. Dates show when Glama detected each change.
Input schema / examplesAdded value: +[
+ {
+ "key": "user_research_topic"
+ }
+]Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already include destructiveHint=true and idempotentHint=true. The description adds context about deleting 'previously stored memory' and 'sensitive data', which clarifies the purpose and consequences beyond the raw annotation. However, it does not detail behaviors like error handling or permission needs, so credit is moderate.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two sentences efficiently state purpose and usage. Front-loaded with the verb and object, then followed by guidance. No unnecessary words or repetition.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple one-parameter tool with strong annotations (destructive, idempotent), the description covers purpose, usage, and related tools. It does not explain the return value or behavior for missing keys, but given the lack of an output schema and the tool's simplicity, the description is sufficiently complete.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema has 100% coverage with the 'key' parameter described as 'Memory key to delete'. The description only reiterates 'by key', adding no new parameter semantics. Baseline 3 is appropriate as the schema carries the burden.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states 'Delete a previously stored memory by key' with a specific verb and resource. It distinguishes from siblings by pairing with 'remember' and 'recall', indicating this is the deletion counterpart.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Provides explicit use cases: 'Use when context is stale, the task is done, or you want to clear sensitive data.' It also mentions pairing with remember and recall, giving context on related tools. No when-not-to-use guidance, but the positive guidance is clear enough.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Add one secure layer between your agents and this server.
Tools have mostly clear distinctions: ask_pipeworx variants differ by grounding/evidence guarantees, and meta-tools (discover_tools, suggest_questions) serve onboarding. However, ask_pipeworx_beta currently matches ask_pipeworx exactly, creating transient ambiguity, and deep_research vs ask_pipeworx overlap in routing capability though with different scopes.
All tools use snake_case and most follow verb-first naming (ask_pipeworx, compare_entities, generate_avatar, subscribe). A few are descriptive nouns (recent_alerts, recent_changes, pipeworx_trending) but still readable and predictable. No mixed conventions; overall consistent style.
33 tools is excessive for a single server, and many are auxiliary (avatar generation, memory, feedback) that do not serve the core data-access purpose. The primary question-answering capability is centralized in a few routers, making many separate tools feel redundant or unrelated, which dilutes navigability.
The core domain of structured data access is well covered with routing, grounded answering, deep research, entity profiles, comparisons, and claim validation. Subscription lifecycle (subscribe/unsubscribe/alerts) and memory (remember/recall/forget) round out the surface. Minor gaps like lack of direct tool invocation outside the router are covered by discover_tools, and no critical dead ends exist for typical queries.