OptionsAhoy MCP Server
Независимо проверено третьими лицами. Glama: оценка качества сторонней MCP-директории (документация инструмента, поведение, полнота). · npm: опубликовано с доказательством происхождения сборки, подписанная аттестация SLSA о том, что пакет собран из этого репозитория с помощью GitHub Actions (проверить через npm audit signatures). · MCPSafe: независимый скан безопасности по 5 моделям консенсуса (AIVSS), рейтинг A без замечаний.
Проверено на доверенных источниках (проверки, которые мы выполняем сами, на основе ссылок, которыми мы не управляем, и которые вы можете воспроизвести). Computation: каждое значение федерального налога на 2026 год совпадает с его значением в IRS Rev. Proc. 2025-32 / Internal Revenue Code, и 14 рассмотренных федеральных дел (обычный доход, долгосрочные капитальные доходы и AMT, включая элемент опциона incentive stock option) воспроизводятся до цента против независимого PSL Tax-Calculator, налоговой модели, которую мы не писали. Налог на доход штатами проверяется тем же способом: 16 случаев по штатам California, New York, New Jersey, Pennsylvania и Massachusetts воспроизводятся до цента против OpenTaxSolver, независимого движка по налогам штатов, который мы тоже не писал. Основной ответ пересчитывается в реальном времени прямо в вашем браузере.
Протестировано и укреплено. Безопасность входных данных: запросы проходят проверку по опубликованной схеме; некорректные входы возвращают явный 400 с указанием проблемного поля, и никогда не приводят к сбою или неверному числу, а живой API после каждого деплоя дополнительно проверяется набором тестов на устойчивость. · Тестовый набор: вычислительный движок охвачен более чем тысячу автоматизированных тестов по федеральным и 50‑штатной налоговой логике, возврату AMT-кредитов и ценообразованию опционов; падение любого теста блокирует выпуск.
Использование в реальном времени: обращения к MCP за последние 30 дней обслуживаются непосредственно телеметрией сервера (/api/v1/stats, только агрегированные счётчики, без PII).
Детерминированная налоговая математика по компенсации акций, которую любой клиент Model Context Protocol (MCP) может вызвать: расписания упражнений incentive stock option (ISO) при AMT, решения по non-qualified stock option (NSO) и RSU, квалификация QSBS, концентрация по одной акции, страхование защитной-put и цели по финансированию эквити. Соответствует федеральному налоговому кодексу плюс все 50 штатов и DC, годовые диапазоны 2026 года. Разработано компанией AlphaLatitude Inc., компанией за OptionsAhoy.
Зачем вообще спрашивать у модели? Мы провели бенчмарк пяти передовых языковых моделей (LLMs), по 3 прогона каждая, всего 15 испытаний на той же задаче ISO по нескольким годам. Каждое испытание завышало чистый после‑налоговый результат предлагаемого графика в 2–20 раз. Многолетнее планирование имеет пространство поиска, которое слишком велико, чтобы просчитать в контексте; эти инструменты возвращают проверяемый ответ. Актуальный бенчмарк, обновляемый под последние модели: optionsahoy.com/benchmark. Исходные ответы и оценки: llm-iso-benchmark. Полный разбор: Но смогут ли они считать налоги вообще?
Установка в одну строку
Здесь размещённый endpoint: https://optionsahoy.com/mcp (HTTP, без аутентификации, без учётной записи). Самые быстрые способы:
| Клиент | Установка |
|---|---|
| Любой MCP клиент | Добавьте https://optionsahoy.com/mcp в качестве удалённого HTTP-сервера, или npx add-mcp https://optionsahoy.com/mcp |
| Claude Desktop | Скачайте optionsahoy.mcpb и дважды кликните по нему |
| 19 клиентов через Smithery | npx @smithery/cli install alphalatitude/optionsahoy --client claude |
| Local stdio (npm) | npx -y optionsahoy-mcp |
Полная матрица установки (Gemini CLI-расширение, конфигурационный JSON, REST API, Google Cloud Agent Registry): optionsahoy.com/for-agents.
Восемь инструментов
| Название инструмента | Что вычисляет |
|---|---|
| amt_iso_optimize | Расписание многолетней ISO‑задачи, максимизирующее итоговую после‑налоговую стоимость на горизонте планирования, моделируя возврат AMT кредита, истечение грантов и окно exercisable после увольнения |
| nso_calculate | После‑налоговая выплата по NSO при упражнении (федеральный, штатный, FICA), сравнение продажи на упражнение vs удержание для долгосрочного капитального дохода |
| rsu_sell_vs_hold | Решение по vesting RSU: продажа при vesting vs удержание для LTCG, включая разрыв между 22% дополнительным удержанием и вашей маржинальной ставкой |
| concentration_analyze | Риск концентрации одной акции (риски снижения в 30/50/70%), сравнение после‑налогового снижения продаж, держания и хеджирования |
| protective_put_price | Расчёт защитной put, нулево‑стоимостной шард (zero-cost collar) и put‑spread через Black‑Scholes: годовая стоимость хеджирования, максимальные потери, верхний лимит прибыли, защищённый диапазон, вероятность попадания в нижнюю границу и рекомендуемая структура |
| qsbs_check | Квалификация QSBS по разделу 1202 через шесть критериев закона, с многоуровневым исключением OBBBA 2026 года и приведением к конвенциям по штатам |
| equity_funding_plan | Многолетнее расписание продаж с несколькими стеками для достижения целевой суммы после уплаты налогов к заданной дате; возвращает четыре именованных плана плюс полный риск/богатство-пограничник |
| rsu_lot_optimize | Какие лоты RSU vested продавать и на какие даты, чтобы вывести целевую долю акций при минимальной рассчитанной налоговой нагрузке: идентификация по конкретному лоту, долгосрочное откладывание, многолетнее распределение по диапазонам ставок с переносом убытков в рамках плана, против продаж FIFO |
ISO‑оптимизатор ищет своё полное дискретное множество кандидатов и дорабатывает долю за долей, достигая максимума по центу на опубликованном выпуклом кейсе (см. доказательство); планировщики выполняют детерминированные обзоры по ставкам, а калькуляторы возвращают точные результаты. Детerministическая вычислительная модель, а не догадка языковой модели. Охват относится к соответствующему федеральному налоговому кодексу (обычные ставки, LTCG, AMT с кредитами, FICA, NIIT) плюс все 50 штатов и DC (штатные обычные ставки, LTCG‑обложение, штатный AMT для CA, CO, CT, MN). Тот же движок, что и в браузерных калькуляторах на optionsahoy.com/tools; ответ API несёт те же рассчитанные цифры, что и при клике по инструменту.
Используйте его в своем агентском фреймворке (Python)
Если вы строите агентов на Python, а не обращаетесь напрямую к MCP‑концу, OptionsAhoy предоставляет устанавливаемые пакеты инструментов для основных фреймворков агентов. Каждый оборачивает те же калькуляторы за нативным интерфейсом инструментов фреймворка. Все публикуются на PyPI и все без ключа: без учётной записи OptionsAhoy, без API‑ключа.
| Фреймворк | Установка | Импорт | Пример |
|---|---|---|---|
| LangChain | pip install optionsahoy-langchain | from langchain_optionsahoy import get_optionsahoy_tools | equity_agent.py |
| LlamaIndex | pip install llama-index-tools-optionsahoy | from llama_index.tools.optionsahoy import OptionsAhoyToolSpec | equity_agent.py |
| CrewAI | pip install crewai-optionsahoy | from crewai_optionsahoy import get_optionsahoy_tools | equity_crew.py |
| Plain Python client | pip install optionsahoy | from optionsahoy import OptionsAhoyClient | basic_client.py |
Три адаптера под фреймворки автоматически подтягивают безключевого клиента optionsahoy. Также есть агент OpenBB Workspace (FastAPI‑приложение на клиенте OptionsAhoy) для использования внутри OpenBB Workspace. Исходники и воспроизводимые примеры по всем вышеуказанным находятся в integrations/python.
Еще способы сборки
Как угодно выстроен ваш агент, есть готовый модуль. Все они общедоступны и без ключей.
| Элемент сборки | Что это такое |
|---|---|
| Vercel AI SDK инструменты | TypeScript‑пакет (optionsahoy-ai-sdk), выставляющий все восемь калькуляторов в виде tool() функций Vercel AI SDK, готовых к внедрению в generateText / streamText. |
| Инструкционные наборы | Правила редактора и навыки для Cursor, Windsurf, Claude Skills и Claude Code подагентов, чтобы ваш агент по коду вызывал инструменты OptionsAhoy для вопросов об equity-компенсации. |
| Рецепты кода | Копировать – вставить рецепты на Python, по одному файлу на вопрос, вызывая безключевой API исключительно через requests. Также в integrations/recipes. |
| Шаблоны сборки | Импортируемый рабочий процесс n8n плюс рецепты сборки для Flowise, Langflow и Dify. |
| Оценка использования инструментов | Оценка inspect_ai, измеряющая, достигает ли агент provable optimum на задаче ISO с несколькими годами, с инструментом и без него. |
| Открытая карта знакомства A2A | Карточка агента Agent2Agent (A2A), чтобы другие агенты могли обнаруживать и передавать вопросы по equity‑compensation планировщику. |
| Zed extension | extension контекст‑сервер в Zed, соединяющий агента редактора с MCP‑сервером OptionsAhoy. |
| Приложение ACI.dev | Определение приложения OptionsAhoy для открытой платформы агенто‑инструментов ACI.dev. |
| OpenRouter bridge | Рецепт подключения безключевого MCP‑сервера OptionsAhoy к любому моделирующему сервису через OpenRouter и совместимый с OpenAI‑endpoint. |
Попробуйте без установки
Живой виджет на optionsahoy.com/for-agents обращается к тому же endpoint прямо в вашем браузере. Клиент не требуется, настройка не нужна.
Предпочитаете чат‑интерфейс? Те же калькуляторы отвечают на вопросы на естественном языке на poe.com/OptionsAhoy.
Или посмотрите реальный сеанс:
Real Claude Code session, unedited. A multi-stack META question (10K ISOs + 6K vested RSUs + 2K fresh RSUs + $400K house in 2027) fires 4 OptionsAhoy MCP tools in parallel: concentration risk, equity funding plan, AMT/ISO optimization, protective put pricing. Claude synthesizes the outputs into one plan that overrides each tool's standalone pick because the user is 86% concentrated in META. 2:13. Click the poster to play it on optionsahoy.com.
Концевые точки и обнаружение
Live MCP endpoint: https://optionsahoy.com/mcp
Live REST API: https://optionsahoy.com/api/v1
OpenAPI 3.1 спецификация: /openapi.json
МанIFEST-файлы обнаружения: /.well-known/mcp.json · /.well-known/openapi.json
Документация по интеграции агентов: optionsahoy.com/for-agents
Ресурсы MCP (тематические обзоры)
В папке resources/list содержится восемь markdown‑ресурсов, которые дают LLM ориентир перед выбором инструмента. Большинство из них соответствуют базовой статье на optionsahoy.com/learn и сопутствующему калькулятору; брифинг по equity‑финансированию соответствует своему калькулятору, а брифинг по охвату тикеров перечисляет символы, которые разрешает опциональный ярлык ticker.
| URI ресурса | Тема | Связано с |
|---|---|---|
| https://optionsahoy.com/learn/amt-crossover | ISO/AMT переход и четыре дорогих ошибки | amt_iso_optimize |
| https://optionsahoy.com/learn/nso-sell-vs-hold | NSO: продажа на упражнение vs удержание для LTCG | nso_calculate |
| https://optionsahoy.com/learn/rsu-withholding-gap | Разрыв удержания RSU и пять сюрпризов апреля | rsu_sell_vs_hold |
| https://optionsahoy.com/learn/single-stock-concentration-risk | Риск концентрации: диверсификация | concentration_analyze |
| https://optionsahoy.com/learn/zero-cost-collars | Защитные put, нулево‑стоимостные шарды и spreads | protective_put_price |
| https://optionsahoy.com/learn/qsbs | QSBS: квалификация и пять способов потерять исключение | qsbs_check |
| https://optionsahoy.com/tools/equity-funding | Продажа доли для финансирования цели до дедлайна | equity_funding_plan |
MCP prompts (workflow scaffolds)
Восемь промптов в prompts/list моделируют типичные вопросы пользователя и направляют к нужному инструменту. В Claude Desktop они появляются как именованные команды slash; в любом MCP клиента prompts/get { name, arguments } возвращает полностью заготовленное сообщение пользователю.
| Имя подсказки | Переходит к |
|---|---|
| optimize-iso-exercise | amt_iso_optimize |
| analyze-nso-decision | nso_calculate |
| analyze-rsu-vest | rsu_sell_vs_hold |
| analyze-concentration | concentration_analyze |
| price-protective-put | protective_put_price |
| check-qsbs-eligibility | qsbs_check |
| plan-equity-funding | equity_funding_plan |
Детали установки
Расширение Claude Desktop (один клик)
Пакет optionsahoy.mcpb устанавливается двойным кликом (или перетянуть в Claude Desktop → Settings → Extensions), без терминала и редактирования конфигурационного файла, с использованием встроенного runtime Node.js в Claude Desktop.
Чтобы собрать пакет из исходников:
npm install && npm run build:mcpb
Smithery CLI (19 клиентов, одна команда)
npx @smithery/cli install alphalatitude/optionsahoy --client claude
Заменяйте claude на любого клиента, который поддерживает Smithery: claude-code, cursor, vscode, gemini-cli, codex, windsurf, cline, goose, opencode и еще 10+. Список: smithery.ai/servers/alphalatitude/optionsahoy.
Gemini CLI extension
gemini extensions install https://github.com/AlvisoOculus/optionsahoy-mcp
Этот репозиторий также выступает в роли Gemini CLI extension: gemini-extension.json задаёт hosted MCP endpoint, а GEMINI.md предоставляет контекст использования модели.
Local stdio (npm)
Для клиентов, поддерживающих только локальные stdio‑серверы (Claude Desktop без mcp-remote, некоторые IDE‑интеграции):
npx -y optionsahoy-mcp
Или добавьте в конфигурационный файл Claude Desktop / Cline / Goose:
{
"mcpServers": {
"optionsahoy": {
"command": "npx",
"args": ["-y", "optionsahoy-mcp"]
}
}
}
Локальный сервер возвращает те же вычисленные цифры, что и размещённый endpoint по адресу https://optionsahoy.com/mcp. Исходники для обоих размещены в functions/_lib/mcp-tools.ts; точки входа для stdio — src/stdio-server.ts.
Использование REST API напрямую
# Перечень endpoints
curl https://optionsahoy.com/api/v1
# Запустить оптимизацию
curl -X POST https://optionsahoy.com/api/v1/amt-iso \
-H "content-type: application/json" \
-d @input.json
Схемы тела запроса задокументированы в public/openapi.json.
Структура репозитория
functions/ Cloudflare Pages Functions (MCP server + REST API endpoints)
mcp.ts HTTP MCP server
api/v1/*.ts Восемь эндпоинтов инструментов + stats + GET /api/v1 discovery
_lib/*.ts Общие помощники, парсеры calc-input, дескрипторы MCP инструментов
lib/ Логика оптимизатора + налогового кода
calc/ Функции оптимизации per‑tool (computeAmtIso и т. д.)
tax/ Налоговые ставки федералов + 50 штатов + DC, AMT, FICA, NIIT
markets/ Статистика по секторам
options/ Модель Black‑Scholes, безрисковые ставки
data/ Типы данных для данных по опционному цепи
public/ Статические ресурсы: спецификация OpenAPI, llms.txt, discovery manifests
tests/ Наборы тестов Vitest (обширный тестовый набор, включая проверки идентичности байтов)
Запуск тестов
npm install
npm test # обширный набор тестов, ~3s на ноутбуке
npm run typecheck
Реестры и каталоги
-
Official MCP Registry —
io.github.AlvisoOculus/optionsahoy-mcp, статус active -
Smithery —
alphalatitude/optionsahoy(плюс навык equity-plan) -
Gemini CLI extensions gallery —
@AlvisoOculus/optionsahoy-mcp -
PulseMCP (цитирует Official Registry)
-
Continue.dev hub — YAML‑блок размещён на .continue/mcpServers/optionsahoy.yaml
Использование в Google Cloud (агенты Gemini)
Google Cloud Agent Registry позволяет каждому проекту GCP регистрировать внешние MCP‑серверы для использования агентами Gemini. Регистрация на уровне проекта (централизованной подачи нет). Два пути:
# Путь A: агентный реестр выполняет интроспекцию нашего MCP endpoint
gcloud alpha agent-registry mcp-servers register \
--uri=https://optionsahoy.com/mcp \
--display-name="OptionsAhoy" \
--location=us-central1 \
--import-tools
# Путь B: передайте наш опубликованный toolspec.json напрямую (быстрее, без интроспекции)
gcloud alpha agent-registry mcp-servers register \
--uri=https://optionsahoy.com/mcp \
--display-name="OptionsAhoy" \
--location=us-central1 \
--tool-spec=<(curl -sSL https://optionsahoy.com/toolspec.json)
toolspec.json повторяет ответ MCP tools/list с аннотациями readOnlyHint и idempotentHint на всех восьми инструментах (все они — чистые детерминированные калькуляторы без побочных эффектов). Чтобы переработать после изменения формы инструмента:
public/toolspec.json">```
curl -sS -X POST https://optionsahoy.com/mcp
-H 'content-type: application/json'
-d '{"jsonrpc":"2.0","method":"tools/list","id":1}'
| jq -c '{tools: [.result.tools[] | . + {annotations: {readOnlyHint:true, idempotentHint:true, destructiveHint:false, openWorldHint:false}}]}' \
public/toolspec.json
## Поиск неисправностей
**Соединение отклонено / 404 от MCP‑endpoint**
`https://optionsahoy.com/mcp` требует HTTP‑POST с `content-type: application/json` и тело JSON‑RPC. `GET` возвращает описание сервера; иные методы возвращают 405. Проверьте:
curl -X POST https://optionsahoy.com/mcp -H 'content-type: application/json'
-d '{"jsonrpc":"2.0","method":"initialize","id":1,"params":{}}'
**Инструмент делает ответ типа `Error: ...` в ответе**
MCP‑сервер возвращает `isError: true` с понятным сообщением, если валидация входных данных не прошла. Чаще всего: отсутствует требуемое поле или число передано как строка. Проверьте входные данные относительно `inputSchema`, возвращаемого `tools/list`, или относительно [/openapi.json](https://optionsahoy.com/openapi.json).
**Инструмент не появляется в Claude.ai или Claude Desktop**
- Убедитесь, что URL коннектора точно `https://optionsahoy.com/mcp` (без завершающего слеша, без `/v1`).
- В Claude Desktop перезапустите приложение после редактирования `claude_desktop_config.json`.
- В Claude.ai переключатель коннектора действителен на уровне чата: включите его в меню вложений.
- Проверьте живой ответ `tools/list` (ожидано восемь инструментов): `curl -X POST https://optionsahoy.com/mcp -H 'content-type: application/json' -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'`
**Ошибки CORS у браузера**
Сервер возвращает `access-control-allow-origin: *` во всех ответах, включая preflight, и принимает стандартные заголовки MCP (`content-type`, `mcp-session-id`, `mcp-protocol-version`). Если браузер всё ещё блокирует, клиент, вероятно, отправляет неподдерживаемый заголовок — проверьте заголовки запроса на соответствие ответу `access-control-allow-headers`.
**Ресурс / подсказка не найдены**
URI ресурсов и названия подсказок чувствительны к регистру. Получайте канонический список через `resources/list` и `prompts/list`, а не набирать вручную.
**Устаревшая налоговая ставка за год**
Налоговый движок работает с инфляционными коэффициентами 2026 года, правила QSBS OBBBA 2026 года и таблицами соответствия штатам. Если результаты выглядят некорректно на горизонте нескольких лет, проверьте, что `grantDate`, `acquisitionDate` или `saleDate` попадают в ожидаемый год — движок рассчитывает ставки по налоговым годам.
**Сообщение об ошибке вычисления или неожиданный вывод**
Напишите на [andrew@alphalatitude.com](mailto:andrew@alphalatitude.com) с: точным JSON‑RPC запросом, ответом, ожидаемым значением и (если известно) IRS‑публикацией или государственным законом, на основании которого получено ожидаемое значение.
## Политика конфиденциальности
Полная политика: [optionsahoy.com/privacy](https://optionsahoy.com/privacy).
Коротко: входа в учётная запись не требуется и персональные данные не собираются — ни имя, ни электронная почта, IP-адрес, ни вход в систему. Вводимые данные инструментов и их выводы хранятся недолго (около семи дней) для отладки и улучшения продукта, наряду с агрегированными метаданными использования (инструмент, временная отметка, примерное местоположение, тип клиента), помогающими понимать использование и предотвращать злоупотребления. Локальный stdio‑сервер и расширение Claude Desktop выполняют всё на вашем устройстве; единственный сетевой запрос — поиск по цепочке опционов (только тикер) для `protective_put_price`.
## Лицензия
MIT. См. [LICENSE](https://github.com/AlvisoOculus/optionsahoy-mcp/blob/main/LICENSE). Развернутый сервис по адресу [https://optionsahoy.com/mcp](https://optionsahoy.com/mcp) и [https://optionsahoy.com/api/v1](https://optionsahoy.com/api/v1) бесплатен в режиме бета‑тестирования согласно [terms](https://optionsahoy.com/terms).
## Контакты
Для партнерств, раннего доступа к API, поддержки интеграции MCP: [andrew@alphalatitude.com](mailto:andrew@alphalatitude.com)