OptionsAhoy — Claude Code MCP server: what it does, how to install
OptionsAhoy runs the tax and timing math on employee equity: ISO exercises against AMT, NSO and RSU payouts, QSBS eligibility, single-stock concentration and hedge cost.
no license 828 installs updated 2026-06-11
claude mcp add --transport http optionsahoy https://optionsahoy.run.toolsWhat OptionsAhoy does
Seven tools handle the arithmetic people usually end up doing in a spreadsheet: what an option exercise leaves after tax, whether to sell vested shares now, whether a holding clears §1202. Answers come back computed, not estimated.
amt_iso_optimize spreads ISO exercises over several years and picks the schedule with the best after-tax value at your horizon. nso_calculate and rsu_sell_vs_hold work the payout side: federal, state and FICA, plus the gap between the flat 22% withholding and your real bracket. concentration_analyze measures drawdown on one position, protective_put_price quotes a put or a zero-cost collar, equity_funding_plan returns four plans along the risk/wealth frontier.
Nothing to sign up for: the config holds one endpoint, https://optionsahoy.run.tools. Routing is where it goes wrong. The tools are not interchangeable, so NSO math sent to amt_iso_optimize comes back wrong, and the ISO exercise behind a QSBS holding should go through amt_iso_optimize first or AMT never enters the picture.
What it helps with
- schedule ISO exercises so AMT does not swallow the gain
- compare selling at NSO exercise with holding for long-term gains
- decide whether vested RSUs are worth keeping past the withholding gap
- test a holding against §1202 before selling
- price a protective put on a single stock
Example prompts for the agent
- Build an ISO exercise schedule with
amt_iso_optimizethat leaves the most after tax. - Run
nso_calculateon selling at exercise versus holding for long-term capital gains. - Use
equity_funding_planto get four ways of reaching a target amount by a deadline.
How to install OptionsAhoy
Platform CLI: remote server
claude mcp add --transport http optionsahoy https://optionsahoy.run.toolsPlatform CLI: remote server
codex mcp add optionsahoy --url https://optionsahoy.run.toolsConfig file
{
"mcpServers": {
"optionsahoy": {
"url": "https://optionsahoy.run.tools"
}
}
}Config file
{
"servers": {
"optionsahoy": {
"type": "http",
"url": "https://optionsahoy.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http optionsahoy https://optionsahoy.run.toolsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about OptionsAhoy
How do I install OptionsAhoy in Claude Code?
Run claude mcp add --transport http optionsahoy https://optionsahoy.run.tools. It is a remote server, so there is no local process to keep running.
What does OptionsAhoy do?
It computes tax and timing on employee equity: ISO exercise schedules, NSO and RSU payouts, QSBS checks, concentration risk, hedge pricing and funding plans for a target amount.
Do I need an API key?
No. The server is free and takes no auth, so the only value in your config is https://optionsahoy.run.tools.