Indian Stock Exchange API2 MCP Server

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided, so the description carries full disclosure burden. It only reveals the HTTP method (GET), implying a read operation, but fails to specify the data format returned, what constitutes a valid period string, rate limits, or error behavior. The default value description is truncated ('default is \"'), leaving critical behavioral context missing.

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 formatting is garbled (markdown bullets merged into a single line) and the text appears truncated mid-value. While brief, the structure is poor for an AI reader, mixing endpoint syntax with parameter documentation without clear intent hierarchy.

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?

Lacking output schema and annotations, a data retrieval tool needs description of return values (OHLCV? adjusted prices? splits/dividends?). The description omits what 'historical data' encompasses, pagination behavior, and time range limits, leaving critical gaps for invocation planning.

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?

With 100% schema description coverage, the baseline is 3. The description merely lists parameters already documented in the schema without adding semantic depth (e.g., explaining period formats like '1Y' vs '5Y', or filter syntax). The schema examples are empty strings for optional parameters, which the description doesn't compensate for.

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 provides technical endpoint details (GET /historical_data) and parameter listings but fails to state what business function it performs (e.g., 'retrieves historical price data'). It restates implementation metadata rather than describing the tool's purpose or distinguishing it from siblings like historical_stats.

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?

No guidance provided on when to use this tool versus alternatives (e.g., get_stock_data_by_name for current prices, historical_stats for aggregates). No mention of prerequisites, data availability constraints, or typical use cases.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.