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 |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already provide destructiveHint=true and idempotentHint=true. Description adds relevant context about use cases for stale/sensitive data, but no additional behavioral details beyond what annotations imply.
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 efficient sentences with front-loaded primary action, no redundant information.
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?
Fully adequate for a simple deletion tool with one parameter and no output schema; covers purpose, usage, and related tools.
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 covers parameter 'key' with 100% description coverage. Description adds no extra semantics beyond the schema's own description, so baseline 3 applies.
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?
Clearly states the action (delete) and resource (memory by key), with explicit distinction from siblings 'remember' and 'recall'.
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 when-to-use conditions (stale context, task done, clear sensitive data) and names related tools for context.
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.
Several tool families overlap heavily: ask_pipeworx and ask_pipeworx_beta are functionally identical today, and the polymarket_edges/arbitrage/fill_risk/kalshi_spread family plus entity_profile/recent_changes/compare_entities cover adjacent jobs. The descriptions are detailed enough to separate them with careful reading, but an agent could easily select the wrong one without deep inspection.
The set has recognizable prefixes like ecos_, ask_pipeworx, and polymarket_, but it also mixes verb_noun names (validate_claim, discover_tools), bare verbs (remember, forget, recall), reversed/gerund forms (bet_research, pipeworx_trending), and special tokens (generate_llms_txt). The naming is readable on a per-family basis but not predictable across the full surface.
35 tools is above the comfortable range for a coherent tool set, and several entries are near-duplicates or wrappers: ask_pipeworx_beta is currently identical to ask_pipeworx, and scan_competitor_ai_presence wraps ai_visibility_check. The prediction-market and company-research families could be consolidated without losing capability.
For the server's broad scope, lifecycle coverage is strong: ECOS has search/items/get/indicators, subscriptions have create/list/read/cancel, memory has save/read/delete, and the data-research surface covers lookup, grounded verification, comparison, profiles, changes, and discovery. Minor gaps exist, such as no direct tool to fetch a pipeworx:// record by URI or execute a single catalog tool directly, but these are workable.