HeadroomDESK

Options calculators for AI assistants (MCP)

The same engine as the options calculators on this site, as a remote MCP server. An AI assistant that supports the Model Context Protocol can send it the numbers you give it and get back exact results at expiry, instead of doing the arithmetic in its head. Free, no sign-in, nothing stored.

Endpoint

https://headroomdesk.com/mcp

Transport: Streamable HTTP (JSON-RPC 2.0 over POST, plain JSON replies). No authentication, no sessions. Every tool is read-only.

Add it to your assistant

  • Claude: add a custom connector with the endpoint above (custom connectors are available on paid Claude plans).
  • ChatGPT: add it as a connector where your plan allows remote MCP servers.
  • Cursor, VS Code and other MCP clients: add the server to your MCP configuration, for example:
{ "mcpServers": { "headroom-desk": { "url": "https://headroomdesk.com/mcp" } } }

Tools

ToolWhat it returns
options_pnl_at_expiryUp to 8 legs (calls, puts, shares, long or short): net premium, breakevens, highest and lowest P/L at expiry (or Unlimited), P/L at each strike and at prices you give. Exact.
options_pnl_before_expiryBlack-Scholes model estimate of the same position's P/L on a later day at a given underlying price.
black_scholesModel value of one call or put, delta, gamma, theta per day, vega and rho.
implied_volatilityThe volatility that fits an option price, or "No implied volatility fits this price".
covered_callNet debit, breakeven, return if called and if not, each beside its per-year figures, highest and lowest P/L at expiry.
cash_secured_putCash set aside, breakeven and cost if assigned, return on the cash and its per-year figures.
covered_call_rollNet credit or debit of the roll, total premium, new breakeven, return if called at the new strike.
annualized_returnA return over any number of days as a per-year figure, simple and compounded, beside the period return.

Prices are per share, as strings or numbers with at most 4 decimals; one contract is 100 shares unless a multiplier is given. No quote, interest rate, dividend yield or volatility is built in: the tools that need them ask for them. When an input has no answer (a loss over 100%, a date after expiry, a price no volatility can produce), the tool returns a message, never a number.

Examples

A long call at expiry

options_pnl_at_expiry legs: [{ type: call, side: long, quantity: 1, strike: "100", price: "3.45" }] -> net premium 345.00 debit paid · breakeven 103.45 · highest Unlimited gain · lowest -345.00

An iron condor

options_pnl_at_expiry legs: long put 90 @0.45, short put 95 @1.40, short call 105 @1.55, long call 110 @0.60 -> net premium 190.00 credit received · breakevens 93.10 and 106.90 · highest +190.00 · lowest -310.00

A cash-secured put

cash_secured_put put_strike: "40", premium: "0.80", days_to_expiry: 30 -> cash secured 4,000.00 · breakeven 39.20 · return on cash 2.00% over 30 days (24.33% simple, 27.24% compounded per year)

What the answers carry

Exact at expiry for the numbers you typed. Not included: fees and commissions, early assignment, dividends, and what your broker does at expiry.

Model: Black-Scholes. No early exercise, constant volatility and rate, dividends as a continuous yield. For American options (most US stock options) the price, Greeks and implied volatility are approximations, least reliable for deep in-the-money puts and around dividend dates.

Per year: assumes the same result repeated; not a forecast.

Conventions: days/365; continuous compounding; returns on net debit or cash secured.

This calculator does not know your broker, account type, tax position or fees.

Checked against 3,123 test cases (2026-11-20).

Privacy

The server works only on the numbers in each request and keeps none of them. For each tool used it counts the tool's name, the name of the client software (for example the first word of its user-agent) and the date, with no IP address, identifier or input value. It reads nothing from your assistant, your account or your files. See Privacy.

Support

Questions or a wrong result: desk@headroomdesk.com. Fixes are listed in the corrections log.

Last reviewed (UTC).