# optionsahoy-mcp

Подключает детерминированный расчёт налогов на опционы и акции в США к ИИ-агентам. Помогает планировать исполнение ISO, продажу RSU и хеджирование без ошибок в математике.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6
- Автор: AlvisoOculus
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/AlvisoOculus/optionsahoy-mcp
- Обновлён: 2026-10-22
- HTML: https://affpapa.org/nevibecode/mcp/optionsahoy-mcp

## Что делает

Сервер добавляет восемь инструментов для точного расчёта налогов на опционы и акции американских компаний. Встроенные функции берут на себя составление графика исполнения ISO с учётом налога AMT, сценарии удержания или реализации RSU и расчёт выплат по NSO. Также поддерживается проверка статуса акций QSBS по Статье 1202 и оценка стоимости опционов по формуле Блэка — Шоулза.

В логику заложены федеральные ставки 2026 года, правила всех 50 штатов и округа Колумбия. Вычисления сверены с открытыми пакетами PSL Tax-Calculator и OpenTaxSolver до цента. При некорректных параметрах запрос не падает с ошибкой, а возвращает статус 400 с точным именем проблемного поля.

Удалённый эндпоинт `https://optionsahoy.com/mcp` работает по HTTP без авторизации. Если связь с облачным сервером прервётся, расчёты остановятся: локальный запуск требует отдельного вызова через `npx -y optionsahoy-mcp`.

## Требования
- Удалённый сервер: `https://optionsahoy.com/mcp`

## Установка

### Claude Code (родная платформа)

**Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http optionsahoy-mcp https://optionsahoy.com/mcp
```

### Codex

**Командой платформы: удалённый сервер**
```bash
codex mcp add optionsahoy-mcp --url https://optionsahoy.com/mcp
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "optionsahoy-mcp": {
            "url": "https://optionsahoy.com/mcp"
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "optionsahoy-mcp": {
            "type": "http",
            "url": "https://optionsahoy.com/mcp"
        }
    }
}
```

### Gemini CLI

**Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http optionsahoy-mcp https://optionsahoy.com/mcp
```

## Когда брать
- рассчитать график исполнения опционов ISO с учётом налога AMT
- сравнить удержание и немедленную продажу акций RSU после вестинга
- оценить риски концентрации капитала в акциях одной компании
- проверить право на налоговую льготу QSBS по Статье 1202
- рассчитать стоимость защитного опционного хеджа через путы и воротники

## Примеры запросов агенту
- Посчитай оптимальный график выкупа опционов ISO на четыре года с учётом возврата AMT в Калифорнии.
- Сравни продажу сразу после вестинга и удержание моих RSU на 2026 налоговый год.
- Рассчитай стоимость защитного пута для пакета акций через инструмент protective_put_price.

## Похожие
- [World Monitor](https://affpapa.org/nevibecode/mcp/world-monitor.md) — MCP-сервер · ★ 89609
- [CCXT](https://affpapa.org/nevibecode/mcp/ccxt.md) — MCP-сервер · ★ 44591
- [Finance Toolkit](https://affpapa.org/nevibecode/mcp/finance-toolkit.md) — MCP-сервер · ★ 5469
- [EdgarTools](https://affpapa.org/nevibecode/mcp/edgartools.md) — MCP-сервер · ★ 2817
- [LetsFG — Flights & Hotels](https://affpapa.org/nevibecode/mcp/letsfg-flights-hotels.md) — MCP-сервер · ★ 2197
- [AutoTS](https://affpapa.org/nevibecode/mcp/autots.md) — MCP-сервер · ★ 1434

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md