unsubscribeCancel a subscription by id. Ownership is enforced — you can only cancel your own subscriptions. The row is deactivated (not deleted) so its historical events stay available via recent_alerts.
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Subscription id (uuid) returned by subscribe. |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Beyond annotations (destructiveHint=false, idempotentHint=true), the description reveals that the row is deactivated (not deleted) and ownership is enforced, adding significant behavioral context.
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 front-loaded purpose. No fluff; every sentence adds value.
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?
Covers action, constraint, and outcome (deactivated, history preserved). Lacks return value specification, but given tool simplicity and annotations, it's nearly 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 already fully describes the id parameter (type, purpose). The description adds ownership context (id must belong to caller) but no further syntax or format details.
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 it cancels a subscription by ID, with ownership enforcement. It distinguishes from sibling tools like subscribe and list_subscriptions by specifying the action and constraints.
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?
Explicitly mentions ownership enforcement (only own subscriptions) and that deactivation preserves history for recent_alerts, providing clear when-to-use and context about side effects.
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.
The set is organized into clusters (Pipeworx querying, Polymarket analysis, entity research, subscriptions, memory), but several tools within a cluster have heavily overlapping purposes: ask_pipeworx, ask_pipeworx_beta, deep_research, and validate_claim all answer questions, and polymarket_edges, bet_research, and polymarket_arbitrage all surface trading opportunities. The very detailed descriptions help an agent choose correctly, but the boundaries are not crisp enough for a 4.
Most names are lowercase snake_case and there are consistent prefixes like polymarket_ and pipeworx_, which aids predictability. However, the verb/noun ordering is inconsistent across the set (ask_pipeworx, bet_research, entity_profile, duffel_flight_search, ai_visibility_check), and some names are noun-heavy while others are verb-first. It is readable but not a uniform convention.
At 32 tools the surface feels heavy for a coherent server; the rubric treats 25+ as too many. Several tools are wrappers or variants of the same underlying capability (ask_pipeworx_beta, polymarket_edges vs bet_research, ai_visibility_check vs scan_competitor_ai_presence), so the count overstates real functional breadth.
The research/data side is very complete: querying, grounded verification, deep research, entity resolution, comparison, profiles, monitoring, memory, and feedback are all covered. However, the Duffel flight tool only searches and never books, so if the server is meant to be a flight agent there is a notable dead end; the broader toolkit also lacks direct CRUD for most resources beyond subscriptions.