Headroom Desk options calculators
Remote, read-only options calculators: exact P/L at expiry and breakevens for up to 8 legs, Black-Scholes value, Greeks and implied volatility, covered call, cash-secured put, roll and annualized return. No sign-in, no market data; every input comes from the user.
Hosted MCP Server
npx add-mcp 'https://headroomdesk.com/mcp'Installs into Claude Code, Codex, Cursor and more
Documentation
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
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
One endpoint for every client. One-click installs: Add to Cursor Add to VS Code (each opens the app and asks you to confirm)
| Client | How to add it |
|---|---|
| Claude (web, desktop, mobile) | Settings, Connectors, add a custom connector with the endpoint above. Custom connectors are on paid Claude plans. |
| Claude Code | claude mcp add --transport http headroom-desk https://headroomdesk.com/mcp |
| ChatGPT | Turn on developer mode in the apps settings, then create a connector with the endpoint above and no authentication, where your plan allows it. |
| Cursor | The button above, or ~/.cursor/mcp.json: { "mcpServers": { "headroom-desk": { "url": "https://headroomdesk.com/mcp" } } } |
| VS Code (Copilot agent mode) | The button above, or .vscode/mcp.json: { "servers": { "headroom-desk": { "type": "http", "url": "https://headroomdesk.com/mcp" } } } |
| Windsurf | mcp_config.json: { "mcpServers": { "headroom-desk": { "serverUrl": "https://headroomdesk.com/mcp" } } } |
| Gemini CLI | settings.json: { "mcpServers": { "headroom-desk": { "httpUrl": "https://headroomdesk.com/mcp" } } } |
| Codex CLI | ~/.codex/config.toml: [mcp_servers.headroom-desk] with url = "https://headroomdesk.com/mcp" |
| Any other MCP client | A remote server over Streamable HTTP at the endpoint above, no authentication. It is also listed in the official MCP Registry as io.github.headroomdesk/calculators. |
Tools
| Tool | What it returns |
|---|---|
| options_pnl_at_expiry | Up 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_expiry | Black-Scholes model estimate of the same position's P/L on a later day at a given underlying price. |
| black_scholes | Model value of one call or put, delta, gamma, theta per day, vega and rho. |
| implied_volatility | The volatility that fits an option price, or "No implied volatility fits this price". |
| covered_call | Net debit, breakeven, return if called and if not, each beside its per-year figures, highest and lowest P/L at expiry. |
| cash_secured_put | Cash set aside, breakeven and cost if assigned, return on the cash and its per-year figures. |
| covered_call_roll | Net credit or debit of the roll, total premium, new breakeven, return if called at the new strike. |
| annualized_return | A 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.