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 indicate destructive and idempotent behavior. The description adds that it targets 'previously stored memory,' clarifying the scope of deletion. This is useful context without contradicting the annotations.
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 concise sentences with the action front-loaded. The first sentence states the operation; the second provides usage scenarios and sibling relationship. No wasted words.
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 and complete schema, the description effectively covers purpose, usage, and related tools. It omits edge-case behavior like missing keys, but that is minor for this tool.
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 coverage is 100% and the parameter 'key' is described as 'Memory key to delete.' The description's 'by key' essentially restates this, adding minimal extra meaning beyond the schema.
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 opens with a specific verb and resource: 'Delete a previously stored memory by key.' It clearly distinguishes the tool from siblings by naming 'remember and recall' and framing this as the opposite operation.
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?
It explicitly lists when to use the tool: 'Use when context is stale, the task is done, or you want to clear sensitive data the agent saved earlier.' It also points to related tools ('Pair with remember and recall'), giving clear contextual guidance.
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.
Multiple tools have overlapping purposes, notably ask_pipeworx, ask_pipeworx_beta, and ask_pipeworx_grounded which are near-identical in function. The polymarket_* family also has several members with closely related scopes, and the large number of data-query tools makes it hard to choose the right one without careful reading.
All names use snake_case, but the pattern is inconsistent: some are verb-first (list_subscriptions, validate_claim), others are noun-first (entity_profile, bet_research), and proper-noun prefixes like pipeworx_ and polymarket_ are used liberally. The gitlab_* tools follow a clear verb_noun pattern, but the rest of the set is mixed.
With 36 tools, the server is overloaded, especially given that only 5 are GitLab-related while the rest are a sprawling data-access toolkit. Many tools could be consolidated (e.g., the ask_pipeworx variants), and the count exceeds what is reasonable for a focused GitLab server.
For a server named Gitlab, the coverage is severely incomplete: only list/get operations exist for projects, issues, and MRs, with no create, update, or delete capabilities. The broader data tools are more complete, but the nominal purpose of the server is clearly not fulfilled.