Skip to main content
Glama

Agent Financial Advisor

Options risk and margin check

options_risk_check

Check an options book (existing or proposed legs) the way a broker's options desk would: covered, cash-secured, spread or naked; margin requirement under FINRA Rule 4210; cash-account limits; required approval level; early-assignment risk around ex-dividend dates; pin risk; auto-exercise of expiring in-the-money longs and the capital it needs; max loss; and net Greeks. Returns approve / approve_with_warnings / reject with reasons. Price: $0.01.

Input Schema

NameRequiredDescriptionDefault
legsYes
as_ofNoDate of the check (YYYY-MM-DD); defaults to today in New York.
policyNoOverrides: pin_band_pct, max_requirement_pct_of_equity, max_delta_dollars_pct_of_equity, assignment_dte, low_extrinsic.
accountYes
underlyingYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedInput schema / examples
      Added value: +[
      +  {
      +    "account": {
      +      "equity": 50000,
      +      "options_level": 3,
      +      "shares_held": 100,
      +      "type": "margin"
      +    },
      +    "as_of": "2026-10-19",
      +    "legs": [
      +      {
      +        "expiry": "2026-11-20",
      +        "premium": 3.1,
      +        "quantity": 1,
      +        "side": "short",
      +        "strike": 210,
      +        "type": "call"
      +      },
      +      {
      +        "expiry": "2026-11-20",
      +        "premium": 2.6,
      +        "quantity": 2,
      +        "side": "short",
      +        "strike": 190,
      +        "type": "put"
      +      },
      +      {
      +        "expiry": "2026-11-20",
      +        "premium": 1.2,
      +        "quantity": 2,
      +        "side": "long",
      +        "strike": 180,
      +        "type": "put"
      +      }
      +    ],
      +    "underlying": {
      +      "price": 200,
      +      "symbol": "AAPL"
      +    }
      +  }
      +]
  2. Added

TDQS

A3.7/5.0
Behavior4/5

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

With no annotations, the description carries the full burden and does well: it enumerates the checks performed, names FINRA Rule 4210, and states the return contract (approve / approve_with_warnings / reject with reasons). It omits whether the call is read-only with no side effects, whether authentication or an API key is required, and any rate-limit behavior, which keeps it from a 5.

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?

The description is a single dense paragraph that front-loads the purpose and then lists checks, the return contract, and pricing. It is appropriately sized and largely waste-free, though the long checklist of checks could be structured more cleanly.

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

Completeness4/5

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

For a complex computational tool with nested inputs, no output schema, and no annotations, the description gives a strong conceptual account of what is evaluated and what the return statuses mean. It still leaves the agent without parameter-level guidance on required fields, policy overrides, and side-effect/auth expectations, but the core contract is present.

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

Parameters3/5

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

Schema description coverage is only 40%, so the description must compensate more than it does. It conceptually maps some inputs to checks (ex_dividend_date to assignment risk, account type to cash limits, options_level to approval level), but it never explains the legs structure, the required/optional distinction, or the policy override object, so meaningful gaps remain.

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 states a specific verb and resource: check an options book (existing or proposed legs) for margin, cash-account limits, assignment risk, pin risk, exercise, max loss, and Greeks. It is unmistakably an options risk/margin tool, but it does not explicitly name or distinguish itself from overlapping siblings such as pre_trade_check or suitability_check, so it falls short of a 5.

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

Usage Guidelines3/5

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

It implies usage by saying it can check 'existing or proposed legs,' which covers both post-trade review and pre-trade evaluation. However, it gives no explicit when-to-use guidance versus alternatives like pre_trade_check or position_size, nor does it state prerequisites or exclusions.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.