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?
With annotations already declaring readOnlyHint, openWorldHint, idempotentHint, and destructiveHint=false, the description adds valuable context by specifying it returns the caller's subscriptions and listing the returned fields. This goes beyond the annotations without contradicting them.
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 succinct sentences. The first states purpose and return fields; the second gives practical usage guidance. No filler or 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?
For a simple read-only list tool with one optional parameter and no output schema, the description covers the key aspects: what it lists, what it returns, and when to use it. Combined with strong annotations, this is 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 coverage is 100% for the single parameter include_inactive, whose description already explains behavior and default. The tool description adds no additional semantic beyond what the schema provides, so baseline 3 is appropriate.
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 'List the caller's active subscriptions' with a specific verb and resource. It also enumerates the returned fields, making it distinct from sibling mutation tools like subscribe and unsubscribe.
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 provides two explicit use cases: reviewing current subscriptions before adding more, and finding an id to cancel. This implicitly references the subscribe and unsubscribe sibling tools, though it does not name them explicitly or state when not to use the 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 tools have overlapping purposes (e.g., ai_visibility_check and scan_competitor_ai_presence; ask_pipeworx, ask_pipeworx_grounded, and deep_research). However, detailed descriptions and specific use cases help agents distinguish between them in most cases.
All tools use snake_case naming consistently, e.g., ask_pipeworx, compare_entities, govcon_agency_landscape. The pattern is uniform across the entire set.
With 33 tools, the set is slightly over the typical well-scoped range. While many tools serve distinct purposes, some seem redundant (e.g., memory tools, multiple research tools), making the count feel a bit heavy.
The tool surface covers a broad range of research and intelligence domains but lacks actionable tools for core government contracting tasks like submitting bids or tracking contract performance. Several obvious operations (e.g., user profile management, submission tools) are missing.