# Optionsahoy MCP

> Optionsahoy MCP is an MCP server for finance and payments. Deterministic equity compensation tax math for ISO, NSO, RSU and QSBS decisions. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Platforms:** API, CLI
- **Website:** https://optionsahoy.com/for-agents
- **Repository:** https://github.com/alvisooculus/optionsahoy-mcp
- **MCP Registry name:** io.github.AlvisoOculus/optionsahoy-mcp
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments)
- **Listing updated:** 2026-11-14

## About

The calculations run in a tax engine instead of in the model's context. The README reports a benchmark where five frontier language models, 15 trials in all, each overstated the after-tax result of their own multi-year ISO exercise schedule by 2x to 20x, which is the argument for calling a verifiable tool.

Coverage includes ISO exercise schedules under the alternative minimum tax, NSO and RSU decisions, QSBS qualification, single-stock concentration, protective-put hedging and equity-funding goals, using federal rules, all 50 states and DC with 2026 brackets. The maker lists checks against IRS Rev. Proc. 2025-32 constants, the PSL Tax-Calculator and OpenTaxSolver, and more than a thousand automated tests. Inputs out of range return the specific field flagged.

The hosted endpoint takes no auth or account. It is built by AlphaLatitude Inc., which also runs OptionsAhoy.

## Features

- **ISO and AMT schedules:** Plans multi-year ISO exercises with AMT effects.
- **NSO and RSU decisions:** Covers non-qualified options and restricted stock units.
- **QSBS qualification:** Checks qualified small business stock treatment.
- **Hedging and concentration:** Covers protective puts and single-stock risk.
- **50 states and DC:** Includes state tax rules for 2026.
- **Input validation:** Flags the offending field instead of returning a wrong number.

## Good for

- Planning ISO exercises across several years to manage AMT
- Comparing NSO and RSU tax outcomes
- Estimating whether stock may qualify as QSBS
- Sizing a protective put on a concentrated position

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http optionsahoy-mcp https://optionsahoy.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://optionsahoy.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "optionsahoy-mcp": {
      "url": "https://optionsahoy.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "optionsahoy-mcp": {
      "type": "http",
      "url": "https://optionsahoy.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "optionsahoy-mcp": {
      "serverUrl": "https://optionsahoy.com/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://optionsahoy.com/mcp
```

Enter a Name (for example "Optionsahoy MCP"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "optionsahoy-mcp": {
      "type": "http",
      "url": "https://optionsahoy.com/mcp"
    }
  }
}
```

## FAQ

### Is an account required?

No, the hosted endpoint needs no auth or account.

### Which tax year is covered?

2026 brackets.

### How is accuracy checked?

Against IRS constants and independent tax engines, with a test suite of more than a thousand tests.

### Why not just ask an LLM?

The README's benchmark found every trial overstated after-tax results.

### How do I add Optionsahoy MCP to Claude Code?

Run this command in your terminal: claude mcp add --transport http optionsahoy-mcp https://optionsahoy.com/mcp

### What are the best alternatives to Optionsahoy MCP?

The closest alternatives to Optionsahoy MCP are Irs Taxpayer, Roth vs Traditional Optimizer, QuantLedger 73-Engine CPA, GAAP, IRC Tax, Credit & SEC 10-K API, QuantCalc Retirement Engine and Roth Conversion Calculator.

## Where this comes from

- Description: written from the project's README and the project's website.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Irs Taxpayer](https://ai-powered.com/mcp/irs-taxpayer): Irs Taxpayer is an open-source MCP server for finance and payments.
- [Roth vs Traditional Optimizer](https://ai-powered.com/mcp/roth-vs-traditional-optimizer): Roth vs Traditional Optimizer is a free MCP server for finance and payments.
- [QuantLedger 73-Engine CPA, GAAP, IRC Tax, Credit & SEC 10-K API](https://ai-powered.com/mcp/quantledger-73-engine-cpa-gaap-irc-tax-credit-and-sec-10-k-a): QuantLedger 73-Engine CPA, GAAP, IRC Tax, Credit & SEC 10-K API is a freemium MCP server for finance and payments.
- [QuantCalc Retirement Engine](https://ai-powered.com/mcp/quantcalc-retirement-engine): QuantCalc Retirement Engine is a freemium MCP server for finance and payments.
- [Roth Conversion Calculator](https://ai-powered.com/mcp/roth-conversion-calculator): Roth Conversion Calculator is a free MCP server for finance and payments.
- [QuantLedger 73-Engine CPA, GAAP, IRC Tax, Credit & SEC 10-K API](https://ai-powered.com/mcp/quantledger-73-engine-cpa-gaap-irc-tax-credit-and-sec-10-k-a-2): QuantLedger 73-Engine CPA, GAAP, IRC Tax, Credit & SEC 10-K API is a freemium MCP server for finance and payments.
- [TradingCalc MCP: Options, Forex, Risk Stats, Prediction Markets, On-Chain & Crypto Futures](https://ai-powered.com/mcp/tradingcalc-mcp-options-forex-risk-stats-prediction-markets): TradingCalc MCP: Options, Forex, Risk Stats, Prediction Markets, On-Chain & Crypto Futures is a free MCP server for finance and payments.
- [HPSILab Quant Finance](https://ai-powered.com/mcp/hpsilab-quant-finance): HPSILab Quant Finance is a freemium MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/optionsahoy-mcp
