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=true, idempotentHint=true, and destructiveHint=false, so the safety profile is covered. The description adds value by specifying the scope (caller's own subscriptions) and the default filtering to active ones, and it lists the exact fields returned, which is not in the annotations nor an output schema.
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 long and front-loaded with the action and resource. Every phrase earns its place—scope, return fields, and use case all in one compact text.
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?
The tool is low complexity with one optional param and no output schema, but the description lists return fields, making the response clear. Annotations cover safety and idempotency. The tool's purpose, usage, and behavior are fully captured for an agent to invoke it correctly.
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 (default false), so schema coverage is 100%. The description does not explicitly mention the parameter, but it refers to 'active subscriptions' which aligns with the default. No additional semantic information is needed, so baseline score of 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 it lists the caller's active subscriptions and enumerates the return fields (id, type, params, created_at, last_fired_at, fire_count). This distinguishes it from sibling tools like subscribe and unsubscribe by focusing on the read-only listing action.
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 says to use this 'to review what you're monitoring before adding more or to find an id to cancel,' which gives concrete when-to-use context. It implies alternatives by referencing the actions of adding more (subscribe) and cancelling (unsubscribe), though it doesn't name them directly. This is clear enough for an agent to select appropriately.
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 nearly identical or heavily overlapping purposes: ask_pipeworx and ask_pipeworx_beta are explicitly identical, and the six Polymarket tools (arbitrage, edges, edge_tracker, fill_risk, kalshi_spread, bet_research) all involve finding/analyzing prediction-market opportunities. deep_research and ask_pipeworx also overlap as general query routers, and ai_visibility_check vs scan_competitor_ai_presence is another confusable pair.
All names use snake_case and are descriptive, but verb placement is inconsistent: some are verb-first (check_domain, compare_entities, resolve_entity), others are verb-last or noun-like (ai_visibility_check, entity_profile, pipeworx_trending, bet_research). There is no chaotic camelCase mix, but the pattern is not predictable enough to guess a tool's behavior from its name.
33 tools is far above the typical well-scoped range and the set spans multiple unrelated domains (data lookup, prediction markets, AI visibility, memory, subscriptions, email/domain validation) that have no cohesive purpose under the 'disify' name. Most tools are not related to domain or email checking, making the count feel like a grab bag rather than a focused toolkit.
For a server named 'disify', the core domain-validation surface is minimal (only check_domain and validate_email) and misses obvious operations like WHOIS lookup or breach/debounce checks. As a general data toolset it is broad but shallow in each area, with gaps such as entity_profile only supporting US public companies and no update/delete operations for most data resources.