list_subscriptionsList the caller's active subscriptions. Returns id, type, params, created_at, last_fired_at, fire_count for each. Use this to review what you're monitoring before adding more or to find an id to cancel.
| Name | Required | Description | Default |
|---|---|---|---|
| include_inactive | No | Include cancelled subscriptions in the response (default false). |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint, openWorldHint, idempotentHint, and destructiveHint false, so the safety profile is covered. The description adds value by listing the exact returned fields and clarifying that only active subscriptions are returned by default ("active subscriptions"), which goes beyond 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?
The description is two sentences, front-loaded with the action and resource, and every word earns its place. It efficiently covers purpose, return values, and usage context without redundancy.
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?
This is a simple list tool with one optional parameter and no output schema. The description covers purpose, return fields, and use cases, while annotations cover side-effect safety. Nothing further exists to disclose.
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?
The single parameter include_inactive is fully described in the schema (100% coverage), so the baseline is 3. The description reinforces the active-subscription default but does not add new parameter-specific 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 uses a specific verb ("List") with a clear resource ("the caller's active subscriptions") and explicitly enumerates the returned fields. It clearly distinguishes from sibling tools like subscribe and unsubscribe by focusing on read-only access to existing subscriptions.
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?
The description explicitly tells when to use this tool: "before adding more" (i.e., before subscribing) and "to find an id to cancel" (i.e., before unsubscribing). This provides clear context and practical use cases, effectively guiding the agent to the right tool.
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 near-duplicate tool clusters exist: ask_pipeworx, ask_pipeworx_beta (explicitly identical right now), and ask_pipeworx_grounded overlap heavily, as do polymarket_arbitrage, polymarket_edges, polymarket_edge_tracker, polymarket_fill_risk, and polymarket_kalshi_spread. The three ArcGIS tools (search_datasets, layer_info, query_layer) are distinct, but their purpose is drowned out by the unrelated Pipeworx data tools.
Most names use snake_case, but the pattern is inconsistent: some are verb_noun (ask_pipeworx, search_datasets, resolve_entity), some are noun_noun (layer_info, entity_profile, pipeworx_feedback), and some are adjective_noun (recent_alerts, recent_changes). Verbs are also inconsistent across similar actions (scan_ vs check_ vs compare_, and three different polymarket_ verbs plus a bare bet_research).
34 tools is already heavy, but the server is named Arcgis Pittsburgh and only 3 of the 34 tools relate to Pittsburgh GIS data; the other 31 belong to unrelated domains (Pipeworx data lookup, prediction markets, memory, npm auditing). This is an extreme scope mismatch — the tool count is far too high for the stated purpose and mostly irrelevant noise.
For the ArcGIS Pittsburgh domain, the surface has basic read coverage (search datasets, inspect layer schema, query records) but no update/delete/write operations and no geospatial analysis tools, which are significant gaps for a GIS server. The broader tool set is a grab bag of research, prediction-market, and memory features that don't form a coherent lifecycle for any single domain, so completeness cannot be assessed as a unified surface.