Headroom Desk options calculators is an MCP server published by io.github.headroomdesk, hosted at headroomdesk.com. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 8 tools, including options_pnl_at_expiry, options_pnl_before_expiry, black_scholes, implied_volatility, covered_call.
Exact options P/L at expiry, Black-Scholes, Greeks and covered-call/put returns on your numbers.
Nothing else in the archive shares these values.
Exact P/L at expiry for a position of up to 8 legs (calls, puts, shares, long or short): net premium (debit or credit), breakevens, highest and lowest P/L at expiry (or Unlimited), and the P/L at each strike and at any underlying prices given. Covers spreads, straddles, strangles, iron condors, butterflies, covered calls and collars. Uses only the numbers supplied.
| Parameter | Type | Description |
|---|---|---|
| legs * | array | The position: 1 to 8 legs (calls, puts or shares, long or short). |
| prices_at_expiry | array | Optional underlying prices at expiry to evaluate. |
{
"name": "options_pnl_at_expiry",
"title": "Options P/L at expiry",
"description": "Exact P/L at expiry for a position of up to 8 legs (calls, puts, shares, long or short): net premium (debit or credit), breakevens, highest and lowest P/L at expiry (or Unlimited), and the P/L at each strike and at any underlying prices given. Covers spreads, straddles, strangles, iron condors, butterflies, covered calls and collars. Uses only the numbers supplied.",
"inputSchema": {
"type": "object",
"required": [
"legs"
],
"properties": {
"legs": {
"type": "array",
"items": {
"type": "object",
"required": [
"type",
"side",
"quantity",
"price"
],
"properties": {
"side": {
"enum": [
"long",
"short"
],
"type": "string",
"description": "long = bought (premium paid), short = written or sold short (premium received)."
},
"type": {
"enum": [
"call",
"put",
"stock"
],
"type": "string",
"description": "The leg: a call option, a put option, or shares of the underlying stock."
},
"price": {
"type": [
"string",
"number"
],
"description": "Premium per share for an option, or the price paid per share for stock."
},
"strike": {
"type": [
"string",
"number"
],
"description": "Strike per share (options only)."
},
"quantity": {
"type": "integer",
"minimum": 1,
"description": "Contracts for an option, shares for stock."
},
"multiplier": {
"type": "integer",
"minimum": 1,
"description": "Shares per contract; default 100."
}
},
"additionalProperties": false
},
"maxItems": 8,
"minItems": 1,
"description": "The position: 1 to 8 legs (calls, puts or shares, long or short)."
},
"prices_at_expiry": {
"type": "array",
"items": {
"type": [
"string",
"number"
],
"description": "Dollars per share, at most 4 decimals, for example \"2.35\"."
},
"maxItems": 20,
"description": "Optional underlying prices at expiry to evaluate."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Options P/L at expiry",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Black-Scholes model estimate of a position's P/L a given number of days from now at a given underlying price, for up to 8 legs. Each option leg needs its days to expiry and volatility. The interest rate and dividend yield must be supplied; nothing is built in.
| Parameter | Type | Description |
|---|---|---|
| legs * | array | The position: 1 to 8 legs; each option leg also needs days_to_expiry and volatility_pct. |
| rate_pct * | number | Interest rate per year in percent, continuously compounded (0 is allowed). |
| days_from_now * | integer | Calendar days from now; not after any leg's expiry. |
| underlying_price * | number | Underlying price in dollars at which to value the position. |
| dividend_yield_pct * | number | Dividend yield per year in percent, continuous (0 is allowed). |
{
"name": "options_pnl_before_expiry",
"title": "Options P/L before expiry (model estimate)",
"description": "Black-Scholes model estimate of a position's P/L a given number of days from now at a given underlying price, for up to 8 legs. Each option leg needs its days to expiry and volatility. The interest rate and dividend yield must be supplied; nothing is built in.",
"inputSchema": {
"type": "object",
"required": [
"legs",
"underlying_price",
"days_from_now",
"rate_pct",
"dividend_yield_pct"
],
"properties": {
"legs": {
"type": "array",
"items": {
"type": "object",
"required": [
"type",
"side",
"quantity",
"price"
],
"properties": {
"side": {
"enum": [
"long",
"short"
],
"type": "string",
"description": "long = bought (premium paid), short = written or sold short (premium received)."
},
"type": {
"enum": [
"call",
"put",
"stock"
],
"type": "string",
"description": "The leg: a call option, a put option, or shares of the underlying stock."
},
"price": {
"type": [
"string",
"number"
],
"description": "Premium per share for an option, or the price paid per share for stock."
},
"strike": {
"type": [
"string",
"number"
],
"description": "Strike per share (options only)."
},
"quantity": {
"type": "integer",
"minimum": 1,
"description": "Contracts for an option, shares for stock."
},
"multiplier": {
"type": "integer",
"minimum": 1,
"description": "Shares per contract; default 100."
},
"days_to_expiry": {
"type": "integer",
"minimum": 0,
"description": "Calendar days from now to this option's expiry (options only)."
},
"volatility_pct": {
"type": "number",
"description": "Volatility per year in percent for this option, for example 30 (options only)."
}
},
"additionalProperties": false
},
"maxItems": 8,
"minItems": 1,
"description": "The position: 1 to 8 legs; each option leg also needs days_to_expiry and volatility_pct."
},
"rate_pct": {
"type": "number",
"description": "Interest rate per year in percent, continuously compounded (0 is allowed)."
},
"days_from_now": {
"type": "integer",
"minimum": 0,
"description": "Calendar days from now; not after any leg's expiry."
},
"underlying_price": {
"type": "number",
"description": "Underlying price in dollars at which to value the position."
},
"dividend_yield_pct": {
"type": "number",
"description": "Dividend yield per year in percent, continuous (0 is allowed)."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Options P/L before expiry (model estimate)",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Black-Scholes model value of one European-style call or put per share and per 100-share contract, with delta, gamma, theta per calendar day, vega per volatility point and rho per rate point. All inputs, including the interest rate and dividend yield, must be supplied.
| Parameter | Type | Description |
|---|---|---|
| strike * | number | Strike in dollars. |
| rate_pct * | number | Interest rate per year in percent (0 is allowed). |
| option_type * | string | Option type: call or put. |
| days_to_expiry * | number | Calendar days to expiry (above zero). |
| volatility_pct * | number | Volatility per year in percent, for example 30. |
| underlying_price * | number | Underlying price in dollars. |
| dividend_yield_pct * | number | Dividend yield per year in percent (0 is allowed). |
{
"name": "black_scholes",
"title": "Black-Scholes value and Greeks",
"description": "Black-Scholes model value of one European-style call or put per share and per 100-share contract, with delta, gamma, theta per calendar day, vega per volatility point and rho per rate point. All inputs, including the interest rate and dividend yield, must be supplied.",
"inputSchema": {
"type": "object",
"required": [
"option_type",
"underlying_price",
"strike",
"days_to_expiry",
"volatility_pct",
"rate_pct",
"dividend_yield_pct"
],
"properties": {
"strike": {
"type": "number",
"description": "Strike in dollars."
},
"rate_pct": {
"type": "number",
"description": "Interest rate per year in percent (0 is allowed)."
},
"option_type": {
"enum": [
"call",
"put"
],
"type": "string",
"description": "Option type: call or put."
},
"days_to_expiry": {
"type": "number",
"description": "Calendar days to expiry (above zero)."
},
"volatility_pct": {
"type": "number",
"description": "Volatility per year in percent, for example 30."
},
"underlying_price": {
"type": "number",
"description": "Underlying price in dollars."
},
"dividend_yield_pct": {
"type": "number",
"description": "Dividend yield per year in percent (0 is allowed)."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Black-Scholes value and Greeks",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}The Black-Scholes volatility at which the model value equals a given option price, or a message when no volatility fits that price. All inputs, including the interest rate and dividend yield, must be supplied.
| Parameter | Type | Description |
|---|---|---|
| strike * | number | Strike in dollars. |
| rate_pct * | number | Interest rate per year in percent (0 is allowed). |
| option_type * | string | Option type: call or put. |
| option_price * | number | Option price per share in dollars. |
| days_to_expiry * | number | Calendar days to expiry (above zero). |
| underlying_price * | number | Underlying price in dollars. |
| dividend_yield_pct * | number | Dividend yield per year in percent (0 is allowed). |
{
"name": "implied_volatility",
"title": "Implied volatility from an option price",
"description": "The Black-Scholes volatility at which the model value equals a given option price, or a message when no volatility fits that price. All inputs, including the interest rate and dividend yield, must be supplied.",
"inputSchema": {
"type": "object",
"required": [
"option_type",
"option_price",
"underlying_price",
"strike",
"days_to_expiry",
"rate_pct",
"dividend_yield_pct"
],
"properties": {
"strike": {
"type": "number",
"description": "Strike in dollars."
},
"rate_pct": {
"type": "number",
"description": "Interest rate per year in percent (0 is allowed)."
},
"option_type": {
"enum": [
"call",
"put"
],
"type": "string",
"description": "Option type: call or put."
},
"option_price": {
"type": "number",
"description": "Option price per share in dollars."
},
"days_to_expiry": {
"type": "number",
"description": "Calendar days to expiry (above zero)."
},
"underlying_price": {
"type": "number",
"description": "Underlying price in dollars."
},
"dividend_yield_pct": {
"type": "number",
"description": "Dividend yield per year in percent (0 is allowed)."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Implied volatility from an option price",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}For 100 shares per contract with one call written against them: net debit, breakeven at expiry, return if called and if not called (each with its per-year figures), highest and lowest P/L at expiry.
| Parameter | Type | Description |
|---|---|---|
| premium * | ["string","number"] | Premium received per share for the call. |
| contracts | integer | Number of contracts; each covers 100 shares. Default 1. |
| call_strike * | ["string","number"] | Strike of the call written against the shares, in dollars. |
| share_price * | ["string","number"] | Price per share paid for the stock (or its price now), in dollars, e.g. "50". |
| days_to_expiry * | integer | Calendar days until the call expires. |
{
"name": "covered_call",
"title": "Covered call returns",
"description": "For 100 shares per contract with one call written against them: net debit, breakeven at expiry, return if called and if not called (each with its per-year figures), highest and lowest P/L at expiry.",
"inputSchema": {
"type": "object",
"required": [
"share_price",
"call_strike",
"premium",
"days_to_expiry"
],
"properties": {
"premium": {
"type": [
"string",
"number"
],
"description": "Premium received per share for the call."
},
"contracts": {
"type": "integer",
"default": 1,
"minimum": 1,
"description": "Number of contracts; each covers 100 shares. Default 1."
},
"call_strike": {
"type": [
"string",
"number"
],
"description": "Strike of the call written against the shares, in dollars."
},
"share_price": {
"type": [
"string",
"number"
],
"description": "Price per share paid for the stock (or its price now), in dollars, e.g. \"50\"."
},
"days_to_expiry": {
"type": "integer",
"minimum": 1,
"description": "Calendar days until the call expires."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Covered call returns",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}For a put written with cash set aside to take 100 shares per contract at the strike: cash secured, breakeven and cost per share if assigned, return on the cash with its per-year figures, highest and lowest P/L at expiry.
| Parameter | Type | Description |
|---|---|---|
| premium * | ["string","number"] | Premium received per share for the put. |
| contracts | integer | Number of contracts; each secures 100 shares. Default 1. |
| put_strike * | ["string","number"] | Strike of the put written, in dollars. |
| days_to_expiry * | integer | Calendar days until the put expires. |
{
"name": "cash_secured_put",
"title": "Cash-secured put returns",
"description": "For a put written with cash set aside to take 100 shares per contract at the strike: cash secured, breakeven and cost per share if assigned, return on the cash with its per-year figures, highest and lowest P/L at expiry.",
"inputSchema": {
"type": "object",
"required": [
"put_strike",
"premium",
"days_to_expiry"
],
"properties": {
"premium": {
"type": [
"string",
"number"
],
"description": "Premium received per share for the put."
},
"contracts": {
"type": "integer",
"default": 1,
"minimum": 1,
"description": "Number of contracts; each secures 100 shares. Default 1."
},
"put_strike": {
"type": [
"string",
"number"
],
"description": "Strike of the put written, in dollars."
},
"days_to_expiry": {
"type": "integer",
"minimum": 1,
"description": "Calendar days until the put expires."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Cash-secured put returns",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Closing a written call and writing a new one: net credit or debit of the roll, total premium kept, new breakeven, return if called at the new strike with its per-year figures, highest and lowest P/L at the new expiry.
| Parameter | Type | Description |
|---|---|---|
| contracts | integer | Number of contracts; each covers 100 shares. Default 1. |
| new_strike * | ["string","number"] | Strike of the new call, in dollars. |
| share_cost * | ["string","number"] | What the shares cost per share, in dollars. |
| new_premium * | ["string","number"] | Premium per share received for the new call. |
| cost_to_close | ["string","number"] | Cost per share to close the current call (default 0). |
| days_to_new_expiry * | integer | Calendar days until the new call expires. |
| premiums_received_so_far | ["string","number"] | Premiums kept so far per share (default 0). |
{
"name": "covered_call_roll",
"title": "Covered call roll",
"description": "Closing a written call and writing a new one: net credit or debit of the roll, total premium kept, new breakeven, return if called at the new strike with its per-year figures, highest and lowest P/L at the new expiry.",
"inputSchema": {
"type": "object",
"required": [
"share_cost",
"new_premium",
"new_strike",
"days_to_new_expiry"
],
"properties": {
"contracts": {
"type": "integer",
"default": 1,
"minimum": 1,
"description": "Number of contracts; each covers 100 shares. Default 1."
},
"new_strike": {
"type": [
"string",
"number"
],
"description": "Strike of the new call, in dollars."
},
"share_cost": {
"type": [
"string",
"number"
],
"description": "What the shares cost per share, in dollars."
},
"new_premium": {
"type": [
"string",
"number"
],
"description": "Premium per share received for the new call."
},
"cost_to_close": {
"type": [
"string",
"number"
],
"description": "Cost per share to close the current call (default 0)."
},
"days_to_new_expiry": {
"type": "integer",
"minimum": 1,
"description": "Calendar days until the new call expires."
},
"premiums_received_so_far": {
"type": [
"string",
"number"
],
"description": "Premiums kept so far per share (default 0)."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Covered call roll",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Turns a return over a number of calendar days into per-year figures, simple and compounded, shown beside the period return.
| Parameter | Type | Description |
|---|---|---|
| days * | integer | Calendar days the return took. |
| return_pct * | number | Return over the period in percent; a loss with a minus, not below -100. |
{
"name": "annualized_return",
"title": "Annualized return",
"description": "Turns a return over a number of calendar days into per-year figures, simple and compounded, shown beside the period return.",
"inputSchema": {
"type": "object",
"required": [
"return_pct",
"days"
],
"properties": {
"days": {
"type": "integer",
"minimum": 1,
"description": "Calendar days the return took."
},
"return_pct": {
"type": "number",
"description": "Return over the period in percent; a loss with a minus, not below -100."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Annualized return",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Arithmetic on numbers supplied in each call: options P/L at expiry for any combination of calls, puts and shares; Black-Scholes value, Greeks and implied volatility; covered call, cash-secured put, covered-call roll and annualized return. No market data is fetched and no interest rate, dividend yield or volatility is built in, so every input must come from the user. Results at expiry are exact; values before expiry are Black-Scholes model estimates. Prices are per share; one contract is 100 shares.
Names, descriptions and schemas were written by the server and are shown as data.