Skip to main content
Glama
indian-option-mcp

indian-option-mcp

iv_smile

Retrieve implied volatility across strike prices for a single expiry to analyze the volatility smile and spot strike-level skew in option chains.

Instructions

Get the IV Smile — Implied Volatility across different strike prices for a single expiry.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "symbol": "<symbol>"
    },
    "name": "iv_smile"
  }
}

Input Schema

NameRequiredDescriptionDefault
expiryNo
symbolYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observedv1.1.0

TDQS

C2.8/5.0
Behavior2/5

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

No annotations are supplied, so the description carries the full burden and it says nothing beyond the conceptual definition. It does not state what happens when expiry is omitted, whether the result is a raw series or interpolated smile, whether strikes are filtered, or any rate/latency constraints. For a read-only analytics tool this leaves the agent guessing about core behavior.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

A single front-loaded sentence with the resource name first and the explanatory gloss after the dash — no filler. It is arguably too short rather than padded, so the only deduction is that there is no second sentence carrying operational detail.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a two-parameter read tool with no output schema, the definition covers what the tool conceptually returns (IV per strike for one expiry). The key omission is the behavior of the optional expiry argument, which materially affects how the call is made.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0% for both parameters, so the description must compensate. It only implies that expiry selects the expiration and that strikes are involved; it does not clarify the symbol format, whether expiry is optional and what default applies, or what strike universe is returned.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description names a specific resource ('IV Smile') and immediately defines it as implied volatility across strike prices for a single expiry, which is genuinely clarifying for a jargon term. It stops short of distinguishing this from siblings like calculate_iv or get_option_chain, so an agent must infer the boundary itself.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

There is no explicit when-to-use, when-not-to-use, or named alternative. The phrase 'for a single expiry' hints at the scope but gives no routing guidance against calculate_iv (single option IV) or get_option_chain (full chain), which are the obvious overlaps.

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