Headroom Desk options calculators

● Active

io.github.headroomdesk/calculators

Exact options P/L at expiry, Black-Scholes, Greeks and covered-call/put returns on your numbers.

Connect this server

One click to install, or copy the config below. Suits: Cursor · HTTP clients.

Add to Cursor Add to VS CodeClaude Desktop / Claude Code: paste the config below.

Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):

{
  "mcpServers": {
    "calculators": {
      "url": "https://headroomdesk.com/mcp"
    }
  }
}
One line, from the terminal
Claude Code
claude mcp add --transport http calculators https://headroomdesk.com/mcp
VS Code
code --add-mcp '{"name":"calculators","type":"http","url":"https://headroomdesk.com/mcp"}'

Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in. Codex takes hosted servers in config.toml ([mcp_servers.<name>] url = …) rather than on the command line.

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Other
Version
1.0.1
Registry
active
Published
11/20/2026
Listed in:Official MCP registry ↗how this is checked

Is it safe? Is it maintained?

Serverdex check: Nov 22, 2026

Looks healthy: Headroom Desk options calculators is maintained, open source, hosted endpoint answering without a key.

Maintained
Active
Last commit 2 days ago (Nov 20, 2026), 0 open issues.
Official registry
Active
Published as io.github.headroomdesk/calculators in the official MCP registry, version 1.0.1.
Source
Open source, MIT
Public repository under the MIT licence, 0 stars, 0 forks.
Runs
Hosted by the publisher
Your client talks to headroomdesk.com: prompts and tool arguments leave your machine for that host.
Credentials
None needed to connect
The hosted endpoint completed the Serverdex initialize + tools/list handshake with no key (checked Nov 22, 2026); individual tools may still ask for one.
Owner
Unclaimed
Nobody has claimed this page yet; the data above comes from the registry, GitHub and the live check.

Facts only: last commit and licence from GitHub, the entry's status from the official registry, credentials from the live check. Not a code audit — run the security scan on the endpoint yourself and see the status history.

Live check

checked Nov 22, 2026, 07:08 UTCStatus history & uptime →
● Working201 msprotocol 2025-06-18v1.0.1tools

The endpoint answered the MCP handshake as "Headroom Desk options calculators" and listed 8 tools. Answering since Nov 21, 2026.

Context cost ≈ 2.7k tokens of tool definitions a client loads per conversation (estimate: characters ÷ 4) across 8 tools.

Tools (8)

  • options_pnl_at_expiry2 params

    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.

    Show parameters
    • legsarrayrequiredThe position: 1 to 8 legs (calls, puts or shares, long or short).
    • prices_at_expiryarrayOptional underlying prices at expiry to evaluate.
  • options_pnl_before_expiry5 params

    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.

    Show parameters
    • legsarrayrequiredThe position: 1 to 8 legs; each option leg also needs days_to_expiry and volatility_pct.
    • underlying_pricenumberrequiredUnderlying price in dollars at which to value the position.
    • days_from_nowintegerrequiredCalendar days from now; not after any leg's expiry.
    • rate_pctnumberrequiredInterest rate per year in percent, continuously compounded (0 is allowed).
    • dividend_yield_pctnumberrequiredDividend yield per year in percent, continuous (0 is allowed).
  • black_scholes7 params

    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.

    Show parameters
    • option_typestringrequiredOption type: call or put.
    • underlying_pricenumberrequiredUnderlying price in dollars.
    • strikenumberrequiredStrike in dollars.
    • days_to_expirynumberrequiredCalendar days to expiry (above zero).
    • volatility_pctnumberrequiredVolatility per year in percent, for example 30.
    • rate_pctnumberrequiredInterest rate per year in percent (0 is allowed).
    • dividend_yield_pctnumberrequiredDividend yield per year in percent (0 is allowed).
  • implied_volatility7 params

    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.

    Show parameters
    • option_typestringrequiredOption type: call or put.
    • option_pricenumberrequiredOption price per share in dollars.
    • underlying_pricenumberrequiredUnderlying price in dollars.
    • strikenumberrequiredStrike in dollars.
    • days_to_expirynumberrequiredCalendar days to expiry (above zero).
    • rate_pctnumberrequiredInterest rate per year in percent (0 is allowed).
    • dividend_yield_pctnumberrequiredDividend yield per year in percent (0 is allowed).
  • covered_call5 params

    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.

    Show parameters
    • share_pricestring | numberrequiredPrice per share paid for the stock (or its price now), in dollars, e.g. "50".
    • call_strikestring | numberrequiredStrike of the call written against the shares, in dollars.
    • premiumstring | numberrequiredPremium received per share for the call.
    • days_to_expiryintegerrequiredCalendar days until the call expires.
    • contractsintegerNumber of contracts; each covers 100 shares. Default 1.
  • cash_secured_put4 params

    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.

    Show parameters
    • put_strikestring | numberrequiredStrike of the put written, in dollars.
    • premiumstring | numberrequiredPremium received per share for the put.
    • days_to_expiryintegerrequiredCalendar days until the put expires.
    • contractsintegerNumber of contracts; each secures 100 shares. Default 1.
  • covered_call_roll7 params

    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.

    Show parameters
    • share_coststring | numberrequiredWhat the shares cost per share, in dollars.
    • premiums_received_so_farstring | numberPremiums kept so far per share (default 0).
    • cost_to_closestring | numberCost per share to close the current call (default 0).
    • new_premiumstring | numberrequiredPremium per share received for the new call.
    • new_strikestring | numberrequiredStrike of the new call, in dollars.
    • days_to_new_expiryintegerrequiredCalendar days until the new call expires.
    • contractsintegerNumber of contracts; each covers 100 shares. Default 1.
  • annualized_return2 params

    Turns a return over a number of calendar days into per-year figures, simple and compounded, shown beside the period return.

    Show parameters
    • return_pctnumberrequiredReturn over the period in percent; a loss with a minus, not below -100.
    • daysintegerrequiredCalendar days the return took.

Checked by Serverdex with a plain initialize + tools/list call to headroomdesk.com/mcp, no credentials, about once a day. A failed check is never a removal.

On GitHub

read Nov 21, 2026
Stars
0
Forks
0
Last push
Nov 20, 2026
License
MIT

JavaScriptblack-scholesmcpmcp-servermodel-context-protocoloptionsoptions-calculator

From the README

Headroom Desk options calculators (MCP server) Exact options arithmetic for AI assistants: P/L at expiry and breakevens for up to 8 legs, Black-Scholes value, Greeks and implied volatility, covered call, cash-secured put, covered-call roll and annualized return. A free remote MCP server, read-only, no sign-in, nothing stored. Endpoint: https://headroomdesk.com/mcp (Streamable HTTP, JSON-RPC 2.0, no authentication) Docs: https://headroomdesk.com/mcp-server/ Official MCP Registry: io.github.headroomdesk/calculators Add it to your assistant Tools No quote, interest rate, dividend yield or volatility is built in: 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. What every answer carries: • 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. • The tools do not know your broker, account type, tax position or fees. What is in this repository Check it yourself (Python 3 and Node 18+): Checked against 3,123 test cases (2026-11-20).…

Read the full README on GitHub →

Remotes

  • streamable-httphttps://headroomdesk.com/mcp

The most-starred Other servers in the index, with their live-check result.

ServerStarsLast pushLive check
Labelhead Artist Momentum114,594Nov 2026Working
World Monitor91,002Nov 2026Needs sign-in
Tldraw51,470Nov 2026Working
OpenSEO28,515Nov 2026Needs sign-in
Windows MCP11,833Nov 2026Local / not checked

Headroom Desk options calculators: questions people ask

Is Headroom Desk options calculators a remote or a local MCP server?
According to its entry in the official MCP registry, Headroom Desk options calculators ships as a hosted endpoint (streamable-http) that your client connects to by URL.
Does Headroom Desk options calculators need an API key?
Its hosted endpoint completed the Serverdex live check — an MCP initialize + tools/list call — with no credentials on Nov 22, 2026. Individual tools may still ask for a key when called.
Is Headroom Desk options calculators safe to use?
Looks healthy: Headroom Desk options calculators is maintained, open source, hosted endpoint answering without a key. In detail — maintained: Active; official registry: Active; source: Open source, MIT; runs: Hosted by the publisher; credentials: None needed to connect. Serverdex check of Nov 22, 2026. This is a reading of the repository, the registry entry and the live check, not a code audit; run the Serverdex security scan on the endpoint before trusting it with real data.
Is Headroom Desk options calculators still maintained?
Active: the repository's last commit 2 days ago. Last push Nov 20, 2026, 0 GitHub stars, MIT licence. Read from GitHub on Nov 21, 2026.
What tools does Headroom Desk options calculators expose?
8 tools as listed by the server itself during the live check, including options_pnl_at_expiry, options_pnl_before_expiry, black_scholes, implied_volatility, covered_call. The full list with parameters is in the Live check section above.
How do I add Headroom Desk options calculators to Claude, Cursor or VS Code?
Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.
Browse all Other →

Add the badge to your site

Show visitors that Headroom Desk options calculators is listed here — it’s also the link we check for a free listing.

Headroom Desk options calculators — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-headroomdesk-calculators?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="Headroom Desk options calculators — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![Headroom Desk options calculators — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-headroomdesk-calculators?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.

Add to CursorAdd to VS CodeOpen in Claude Code

Install buttons — for your README

[![Add to Cursor](https://serverdex.io/brand/install-cursor.svg)](https://serverdex.io/install/cursor/io-github-headroomdesk-calculators) [![Add to VS Code](https://serverdex.io/brand/install-vscode.svg)](https://serverdex.io/install/vscode/io-github-headroomdesk-calculators) [![Open in Claude Code](https://serverdex.io/brand/install-claude-code.svg)](https://serverdex.io/install/claude-code/io-github-headroomdesk-calculators)

One click opens Cursor or VS Code with this server's config prefilled; the Claude Code button lands on the one-line command. The links point at Serverdex, so when your config changes the buttons keep working.

Install buttons — HTML for your docs

<a href="https://serverdex.io/install/cursor/io-github-headroomdesk-calculators"><img src="https://serverdex.io/brand/install-cursor.svg" alt="Add to Cursor — via Serverdex" width="140" height="28"></a>
<a href="https://serverdex.io/install/vscode/io-github-headroomdesk-calculators"><img src="https://serverdex.io/brand/install-vscode.svg" alt="Add to VS Code — via Serverdex" width="147" height="28"></a>
<a href="https://serverdex.io/install/claude-code/io-github-headroomdesk-calculators"><img src="https://serverdex.io/brand/install-claude-code.svg" alt="Open in Claude Code — via Serverdex" width="180" height="28"></a>

Same buttons as plain links for a docs page or website.

Prefer a live badge with the score, stars and live check? Score badge (links to a page that explains the number and back to this listing).