OptionsAhoy

Planejamento de impostos e exercício/venda/hedge de compensação de ações para funcionários dos EUA: cronogramas de exercício de ISO com AMT, calculadoras de NSO e RSU, ordenação de lotes de RSU, verificações de QSBS, análise de concentração e precificação de hedge. Cálculos fiscais federais, dos 50 estados e de DC. Servidor remoto hospedado (Streamable HTTP), gratuito, sem chave de API.

GitHub

Experimente este MCPPatrocinado

Documentação

Servidor MCP OptionsAhoy

_{Verificado de forma independente por terceiros. Glama: pontuação de qualidade de terceiros do diretório MCP (documentação de ferramentas, comportamento, completude). · npm: publicado com proveniência de build, uma atestação SLSA assinada de que este pacote foi construído a partir deste repositório pelo GitHub Actions (verifique com npm audit signatures). · MCPSafe: varredura de segurança independente com consenso de 5 modelos (AIVSS), Nota A com zero achados.}

_{Validado contra fontes confiáveis (verificações que executamos nós mesmos, contra referências que não controlamos e que você pode reproduzir). Cálculo: cada constante tributária federal de 2026 corresponde ao valor da IRS Rev. Proc. 2025-32 / Internal Revenue Code, e 14 casos federais trabalhados (renda ordinária, ganhos de capital de longo prazo e o Imposto Mínimo Alternativo, incluindo o elemento de barganha de opções de ações de incentivo) reproduzem ao centavo contra o PSL Tax-Calculator mantido de forma independente, um modelo tributário que não escrevemos. O imposto de renda estadual é verificado da mesma forma: 16 casos na Califórnia, Nova York, Nova Jersey, Pensilvânia e Massachusetts reproduzem ao centavo contra o OpenTaxSolver, um motor tributário estadual independente que também não escrevemos. A resposta principal é recalculada ao vivo no seu navegador.}

_{Testado e endurecido. Segurança de entrada: as solicitações são validadas contra o esquema publicado; entradas inválidas retornam um 400 claro com o campo problemático nomeado, nunca uma falha ou um número errado, e a API ao vivo é reverificada por uma suíte de robustez após cada implantação. · Suíte de testes: o motor de cálculo é coberto por mais de mil testes automatizados na lógica tributária federal e dos 50 estados, recuperação de crédito AMT e precificação de opções; um teste com falha bloqueia o lançamento.}

_{Uso ao vivo: chamadas MCP nos últimos 30 dias, servidas diretamente da telemetria do próprio servidor (/api/v1/stats, apenas contagens agregadas, sem PII).}

Matemática tributária determinística para remuneração em ações que qualquer cliente do Model Context Protocol (MCP) pode chamar: cronogramas de exercício de opções de ações de incentivo (ISO) sob o imposto mínimo alternativo (AMT), decisões de opções de ações não qualificadas (NSO) e unidades de ações restritas (RSU), qualificação de ações qualificadas de pequenas empresas (QSBS), concentração em ação única, hedge com opções de venda protetoras e metas de financiamento com ações. Código tributário federal relevante, além de todos os 50 estados e DC, faixas de 2026. Construído pela AlphaLatitude Inc., a empresa por trás do OptionsAhoy.

Por que não simplesmente perguntar ao modelo? Avaliamos cinco modelos de linguagem de grande porte (LLMs) de fronteira, 3 execuções cada, 15 tentativas no total, no mesmo problema de exercício de ISO plurianual. Cada tentativa superestimou o resultado após impostos de seu próprio cronograma proposto, em 2x a 20x. O agendamento plurianual tem um espaço de busca maior do que é prático trabalhar no contexto; essas ferramentas retornam a resposta verificável. Benchmark ao vivo, atualizado para os modelos mais recentes: optionsahoy.com/benchmark. Respostas brutas e pontuação: llm-iso-benchmark. Artigo completo: Mas ele sabe fazer impostos?

Instale em uma linha

O endpoint hospedado é https://optionsahoy.com/mcp (HTTP, sem autenticação, sem conta). Caminhos mais rápidos:

Cliente	Instalação
Qualquer cliente MCP	Adicione `https://optionsahoy.com/mcp` como servidor HTTP remoto, ou `npx add-mcp https://optionsahoy.com/mcp`
Claude Desktop	Baixe `optionsahoy.mcpb` e clique duas vezes
19 clientes via Smithery	`npx @smithery/cli install alphalatitude/optionsahoy --client claude`
stdio local (npm)	`npx -y optionsahoy-mcp`

Matriz de instalação completa (extensão Gemini CLI, JSON de arquivo de configuração, API REST, Google Cloud Agent Registry): optionsahoy.com/for-agents.

As oito ferramentas

Nome da ferramenta	O que calcula
`amt_iso_optimize`	Cronograma de exercício de ISO plurianual que maximiza o valor final líquido após impostos no horizonte de planejamento, modelando recuperação de crédito AMT, expiração da concessão e a janela de exercício pós-rescisão
`nso_calculate`	Pagamento após impostos no exercício de NSO (federal, estadual, FICA), comparando vender no exercício vs. manter para ganhos de capital de longo prazo
`rsu_sell_vs_hold`	Decisão de vesting de RSU: vender no vest vs. manter para ganhos de capital de longo prazo, incluindo a lacuna entre a retenção suplementar de 22% e sua faixa marginal
`concentration_analyze`	Risco de concentração em ação única (exposição a queda em 30/50/70%), comparando venda após impostos, manutenção e estratégias de hedge
`protective_put_price`	Precificação de put protetora, collar de custo zero e spread de put via Black-Scholes: custo anualizado do hedge, perda máxima, teto de alta, banda protegida, probabilidade de atingir o piso e qual estrutura é recomendada
`qsbs_check`	Qualificação QSBS da Seção 1202 nos seis testes legais, com a exclusão escalonada OBBBA 2026 e conformidade por estado
`equity_funding_plan`	Cronograma de venda plurianual e multi-carteira para atingir um valor alvo após impostos até um prazo; retorna quatro planos nomeados mais a fronteira completa de risco/riqueza
`rsu_lot_optimize`	Quais lotes de RSU com vesting vender, e em quais datas, para desinvestir uma fração alvo de ações ao menor imposto calculado: identificação de lote específico, adiamento de longo prazo e distribuição plurianual de faixas com compensação de perdas no plano, versus uma ordem de venda FIFO

O otimizador de ISO busca todo o seu espaço de candidatos discretizado e refina ação por ação, igualando um máximo de força bruta ao centavo em um caso tratável publicado (veja a prova); os planejadores executam buscas determinísticas cientes de faixas e as calculadoras retornam resultados exatos. Cálculo determinístico, não um palpite de modelo de linguagem. A cobertura abrange o código tributário federal relevante (faixas ordinárias, ganhos de capital de longo prazo, AMT com recuperação de crédito, FICA, NIIT) mais todos os 50 estados e DC (faixas ordinárias estaduais, tratamento de LTCG, AMT estadual para CA, CO, CT, MN). Mesmo motor das calculadoras no navegador em optionsahoy.com/tools; a resposta da API carrega os mesmos valores calculados que clicar na ferramenta.

Use no seu framework de agentes (Python)

Se você constrói agentes em Python em vez de chamar o endpoint MCP diretamente, o OptionsAhoy oferece pacotes de ferramentas instaláveis para os principais frameworks de agentes. Cada um encapsula as mesmas calculadoras atrás da interface nativa de ferramentas do framework. Todos são publicados no PyPI e todos são sem chave: sem conta OptionsAhoy, sem chave de API.

Framework	Instalação	Importação	Exemplo
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`
Cliente Python simples	`pip install optionsahoy`	`from optionsahoy import OptionsAhoyClient`	`basic_client.py`

Os três adaptadores de framework puxam o cliente sem chave optionsahoy automaticamente. Há também um agente OpenBB Workspace (um aplicativo FastAPI construído sobre o cliente OptionsAhoy) para uso dentro do OpenBB Workspace. Código-fonte e exemplos executáveis de tudo acima estão em integrations/python.

Mais formas de construir

Independentemente de como seu agente é construído, há uma peça pronta para uso. Todos são públicos e sem chave.

Bloco de construção	O que é
Ferramentas Vercel AI SDK	Um pacote TypeScript (`optionsahoy-ai-sdk`) expondo todas as oito calculadoras como definições de ferramentas `tool()` do Vercel AI SDK, prontas para espalhar em `generateText` / `streamText`.
Kits de instrução	Regras de editor e habilidades para Cursor, Windsurf, Claude Skills e subagentes Claude Code, para que seu agente de codificação chame as ferramentas OptionsAhoy para perguntas de remuneração em ações.
Receitas de codificação	Receitas Python de copiar e colar, um arquivo autocontido por pergunta, chamando a API sem chave apenas com `requests`. Também em `integrations/recipes`.
Modelos de construtor	Um fluxo de trabalho n8n importável mais receitas de construção para Flowise, Langflow e Dify.
Avaliação de uso de ferramenta	Uma avaliação inspect_ai medindo se um agente atinge o ótimo comprovável em um problema de ISO plurianual, com e sem a ferramenta.
Descoberta A2A	Um Agent Card Agent2Agent (A2A) para que outros agentes possam descobrir e delegar perguntas de remuneração em ações ao planejador.
Extensão Zed	Uma extensão de servidor de contexto de editor Zed que conecta o agente do editor ao servidor MCP OptionsAhoy.
Aplicativo ACI.dev	A definição do aplicativo OptionsAhoy para a plataforma de ferramentas de agente de código aberto ACI.dev.
Ponte OpenRouter	Uma receita para anexar o servidor MCP OptionsAhoy sem chave a qualquer modelo roteado pelo endpoint compatível com OpenAI do OpenRouter.

Experimente sem instalar

O widget ao vivo em optionsahoy.com/for-agents chama este mesmo endpoint do seu navegador. Sem cliente, sem configuração.

Prefere uma interface de chat? As mesmas calculadoras respondem perguntas em linguagem natural em poe.com/OptionsAhoy.

Ou assista a uma sessão real:

Sessão real do Claude Code, sem edição. Uma pergunta multi-carteira META (10K ISOs + 6K RSUs com vesting + 2K RSUs novas + casa de $400K em 2027) dispara 4 ferramentas MCP OptionsAhoy em paralelo: risco de concentração, plano de financiamento com ações, otimização AMT/ISO, precificação de put protetora. O Claude sintetiza as saídas em um plano que substitui a escolha individual de cada ferramenta porque o usuário está 86% concentrado em META. 2:13. Clique no pôster para reproduzir em optionsahoy.com.

Endpoints e descoberta

Endpoint MCP ao vivo: https://optionsahoy.com/mcp API REST ao vivo: https://optionsahoy.com/api/v1 Especificação OpenAPI 3.1: /openapi.json Manifestos de descoberta: /.well-known/mcp.json · /.well-known/openapi.json Documentação de integração de agentes: optionsahoy.com/for-agents

Recursos MCP (briefings temáticos)

Oito recursos markdown sob resources/list dão a um LLM fundamentação suficiente para discutir o tópico antes de escolher uma ferramenta. A maioria mapeia 1:1 com um artigo fundamental em optionsahoy.com/learn e a calculadora correspondente; o briefing de financiamento com ações mapeia para sua calculadora, e o briefing de tickers cobertos enumera os símbolos que o atalho opcional ticker resolve.

URI do recurso	Tópico	Combinar com
`https://optionsahoy.com/learn/amt-crossover`	Cruzamento ISO/AMT e quatro erros caros	`amt_iso_optimize`
`https://optionsahoy.com/learn/nso-sell-vs-hold`	NSO vender no exercício vs. manter para LTCG	`nso_calculate`
`https://optionsahoy.com/learn/rsu-withholding-gap`	Lacuna de retenção de 22% do RSU e cinco surpresas de abril	`rsu_sell_vs_hold`
`https://optionsahoy.com/learn/single-stock-concentration-risk`	Risco de concentração e trade-off de diversificação	`concentration_analyze`
`https://optionsahoy.com/learn/zero-cost-collars`	Puts protetoras, collars de custo zero e spreads de put	`protective_put_price`
`https://optionsahoy.com/learn/qsbs`	Qualificação QSBS e cinco formas de perder a exclusão	`qsbs_check`
`https://optionsahoy.com/tools/equity-funding`	Vender ações para financiar uma meta de caixa até um prazo	`equity_funding_plan`

Prompts MCP (estruturas de fluxo de trabalho)

Oito prompts sob prompts/list estruturam perguntas típicas de usuários e roteiam para a ferramenta certa. No Claude Desktop, eles aparecem como comandos de barra nomeados; em qualquer cliente MCP, prompts/get { name, arguments } retorna uma mensagem de usuário totalmente modelada.

Nome do prompt	Rotas para
`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`

Detalhes de instalação

Extensão Claude Desktop (um clique)

O pacote optionsahoy.mcpb instala com duplo clique (ou arrastando para Claude Desktop → Configurações → Extensões), sem precisar de terminal ou edição de arquivo de configuração, usando o runtime Node.js integrado do Claude Desktop.

Para compilar o pacote a partir do código-fonte:

npm install && npm run build:mcpb

CLI Smithery (19 clientes, um comando)

npx @smithery/cli install alphalatitude/optionsahoy --client claude

Troque claude por qualquer cliente que o Smithery suporte: claude-code, cursor, vscode, gemini-cli, codex, windsurf, cline, goose, opencode e mais 10. Lista: smithery.ai/servers/alphalatitude/optionsahoy.

Extensão Gemini CLI

gemini extensions install https://github.com/AlvisoOculus/optionsahoy-mcp

Este repositório também funciona como uma extensão Gemini CLI: gemini-extension.json conecta o endpoint MCP hospedado e GEMINI.md fornece contexto de uso ao modelo.

stdio local (npm)

Para clientes que suportam apenas servidores stdio locais (Claude Desktop sem mcp-remote, algumas integrações de IDE):

npx -y optionsahoy-mcp

Ou adicione a um arquivo de configuração do Claude Desktop / Cline / Goose:

{
  "mcpServers": {
    "optionsahoy": {
      "command": "npx",
      "args": ["-y", "optionsahoy-mcp"]
    }
  }
}

O servidor local retorna os mesmos valores calculados que o endpoint hospedado em https://optionsahoy.com/mcp. O código-fonte de ambos está em functions/_lib/mcp-tools.ts; o ponto de entrada stdio é src/stdio-server.ts.

Use a API REST diretamente

# List endpoints
curl https://optionsahoy.com/api/v1

# Run an optimization
curl -X POST https://optionsahoy.com/api/v1/amt-iso \
  -H "content-type: application/json" \
  -d @input.json

Os formatos do corpo das requisições estão documentados em public/openapi.json.

Estrutura do repositório

functions/         Cloudflare Pages Functions (MCP server + REST API endpoints)
  mcp.ts           HTTP MCP server
  api/v1/*.ts      Eight tool endpoints + stats + GET /api/v1 discovery
  _lib/*.ts        Shared helpers, calc-input parsers, MCP tool descriptors
lib/               Optimizer + tax-code logic
  calc/            Per-tool optimizer functions (computeAmtIso, etc.)
  tax/             Federal + 50-state + DC bracket data, AMT, FICA, NIIT
  markets/         Sector statistics
  options/         Black-Scholes, risk-free rates
  data/            Type definitions for option-chain data
public/            Static assets: OpenAPI spec, llms.txt, discovery manifests
tests/             Vitest suites (an extensive test suite including byte-identity assertions)

Execute os testes

npm install
npm test         # an extensive test suite, ~3s on a laptop
npm run typecheck

Listagens de registros

Official MCP Registry — io.github.AlvisoOculus/optionsahoy-mcp, status ativo
Smithery — alphalatitude/optionsahoy (além da habilidade equity-plan)
Galeria de extensões Gemini CLI — @AlvisoOculus/optionsahoy-mcp
Registro curado add-mcp
PulseMCP (cascateia do Official Registry)
Hub do Continue.dev — o bloco YAML está em .continue/mcpServers/optionsahoy.yaml

Uso no Google Cloud (agentes Gemini)

O Google Cloud Agent Registry permite que cada projeto GCP registre servidores MCP externos para uso por agentes Gemini. O registro é por projeto (sem submissão central). Dois caminhos:

# Path A: let the Agent Registry introspect our MCP endpoint
gcloud alpha agent-registry mcp-servers register \
  --uri=https://optionsahoy.com/mcp \
  --display-name="OptionsAhoy" \
  --location=us-central1 \
  --import-tools

# Path B: pass our published toolspec.json directly (faster, no introspection)
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)

O toolspec.json espelha a resposta tools/list do MCP com anotações readOnlyHint e idempotentHint em todas as oito ferramentas (todas são calculadoras determinísticas puras, sem efeitos colaterais). Para regenerar após uma alteração no formato das ferramentas:

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

Solução de problemas

Conexão recusada / 404 do endpoint MCP https://optionsahoy.com/mcp exige POST com content-type: application/json e um corpo JSON-RPC. Um GET retorna uma descrição JSON do servidor; qualquer outro verbo retorna 405. Verifique com:

curl -X POST https://optionsahoy.com/mcp -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","method":"initialize","id":1,"params":{}}'

Chamadas de ferramenta falham com texto Error: ... na resposta O servidor MCP retorna isError: true com uma mensagem legível quando a validação de entrada falha. O mais comum: um campo obrigatório ausente ou um número passado como string. Confira a entrada contra o inputSchema retornado por tools/list ou contra /openapi.json.

Ferramenta não aparece no Claude.ai ou Claude Desktop

Confirme se a URL do conector é exatamente https://optionsahoy.com/mcp (sem barra no final, sem /v1).
No Claude Desktop, reinicie o aplicativo após editar claude_desktop_config.json.
No Claude.ai, o interruptor do conector é por conversa: ative-o no menu de anexos.
Verifique a resposta tools/list ao vivo (oito ferramentas esperadas): curl -X POST https://optionsahoy.com/mcp -H 'content-type: application/json' -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

Erros de CORS em um cliente baseado em navegador O servidor retorna access-control-allow-origin: * em todas as respostas, incluindo preflight, e aceita os cabeçalhos MCP padrão (content-type, mcp-session-id, mcp-protocol-version). Se o navegador ainda bloquear, o cliente provavelmente está enviando um cabeçalho não permitido — verifique os cabeçalhos da requisição contra a resposta access-control-allow-headers.

Recurso / prompt não encontrado URIs de recursos e nomes de prompts diferenciam maiúsculas de minúsculas. Obtenha a lista canônica com resources/list e prompts/list em vez de digitar manualmente.

Matemática fiscal desatualizada O mecanismo fiscal acompanha faixas de imposto ajustadas pela inflação de 2026, regras QSBS da OBBBA 2026 e tabelas atuais de conformidade estadual. Se os resultados parecerem incorretos para um horizonte de vários anos, verifique se o grantDate, o acquisitionDate ou o saleDate de entrada está no ano esperado — o mecanismo resolve as faixas por ano fiscal.

Relatando um bug de cálculo ou saída inesperada Envie um e-mail para andrew@alphalatitude.com com: o corpo exato da requisição JSON-RPC, a resposta, o valor esperado e (se souber) a publicação do IRS ou o estatuto estadual do qual o valor esperado deriva.

Política de privacidade

Política completa: optionsahoy.com/privacy.

Em resumo: nenhuma conta é necessária e nenhuma informação pessoalmente identificável é armazenada — sem nome, e-mail, endereço IP ou login. As entradas e saídas das ferramentas são retidas brevemente (cerca de sete dias) para depuração e melhoria do produto, juntamente com metadados agregados de uso (ferramenta, timestamp, localização aproximada, tipo de cliente) usados para entender o uso e detectar abuso. O servidor stdio local e a extensão Claude Desktop calculam tudo na sua máquina; a única requisição de rede é uma consulta de cadeia de opções (somente símbolo do ticker) para protective_put_price.

Licença

MIT. Consulte LICENSE. O serviço implantado em https://optionsahoy.com/mcp e https://optionsahoy.com/api/v1 é gratuito durante o beta sob os termos.

Contato

Para parcerias, acesso antecipado à API, suporte de integração MCP: andrew@alphalatitude.com