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). |
Changes observed during successful MCP inspections. Dates show when Glama detected each change.
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already mark this as readOnly, idempotent, and non-destructive. The description adds useful context by listing the returned fields (id, type, params, created_at, last_fired_at, fire_count) and clarifies it returns only the caller's subscriptions. No contradiction.
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, front-loaded with the core purpose, and every sentence adds value: the first states what it does and returns, the second explains when to use it. No fluff.
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 read-only tool with one optional parameter. The description covers the purpose, return fields, and typical usage scenarios, making it fully self-contained even without an output schema.
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). The description's mention of 'active subscriptions' implicitly relates to the parameter, but it adds no new syntax or behavior beyond the schema's own description.
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 'List the caller's active subscriptions,' a specific verb+resource that clearly states the action. It also distinguishes from siblings like subscribe/unsubscribe by focusing on listing 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?
Explicit guidance: 'Use this to review what you're monitoring before adding more or to find an id to cancel.' This tells the agent when to call this tool versus alternatives like subscribe or unsubscribe.
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 tools are near-duplicates: ask_pipeworx, ask_pipeworx_beta, and ask_pipeworx_grounded all route questions to the same underlying toolset with only minor differences. Additionally, the five polymarket_* tools overlap significantly in purpose, and the mix of Storting parliament tools with a general-purpose data platform creates confusion about which tool is appropriate.
Tool names use snake_case but with inconsistent conventions. Some are verb-first (get_, list_, discover_, validate_), while others are noun-first (entity_profile, bet_research, recent_alerts). There are predictable prefixes like ask_pipeworx and polymarket_, but overall the naming pattern is not uniform, making it harder to predict tool names.
With 38 tools, the count exceeds the 25-tool threshold for 'too many.' Many tools are unrelated to the server name 'Storting No' (which implies a Norwegian parliament focus), and the broad range of data-research and prediction-market tools feels bloated for the apparent scope. A smaller, more focused set would improve coherence.
The Storting-related tools cover the main parliamentary entities (cases, parties, representatives, sessions, votes) and include an export fallback for any additional data.stortinget.no resource. The Pipeworx side has meta-tools (ask, discover, suggest) and specialized analyses (entity_profile, validate_claim, polymarket_*). However, there are notable gaps, such as no direct tool for searching parliamentary speeches or committee documents without relying on the generic export, and the mixed domains leave some workflows incomplete.