OptionsAhoy

Planificación fiscal de compensación en acciones y de ejercicio/venta/cobertura para empleados en EE. UU.: calendarios de ejercicio de ISO con AMT, calculadoras de NSO y RSU, ordenamiento de lotes de RSU, verificaciones de QSBS, análisis de concentración y precios de cobertura. Cálculo fiscal federal más los 50 estados más DC. Servidor remoto alojado (HTTP transmisible), gratuito, sin clave de API.

GitHub

Prueba este MCPPatrocinado

Documentación

Servidor MCP OptionsAhoy

_{Verificado de forma independiente por terceros. Glama: puntuación de calidad de terceros en el directorio MCP (documentación de herramientas, comportamiento, integridad). · npm: publicado con procedencia de compilación, una atestación firmada SLSA de que este paquete se compiló desde este repositorio mediante GitHub Actions (verificar con npm audit signatures). · MCPSafe: escaneo de seguridad independiente con consenso de 5 modelos (AIVSS), Grado A con cero hallazgos.}

_{Validado contra fuentes confiables (verificaciones que ejecutamos nosotros mismos, contra referencias que no controlamos y que usted puede reproducir). Cálculo: cada constante fiscal federal de 2026 coincide con su valor en la Rev. Proc. 2025-32 del IRS / Código de Rentas Internas, y 14 casos federales resueltos (ingreso ordinario, ganancias de capital a largo plazo y el Impuesto Mínimo Alternativo, incluido el elemento de ventaja de las opciones de acciones de incentivo) se reproducen al centavo contra el PSL Tax-Calculator mantenido de forma independiente, un modelo fiscal que no escribimos. El impuesto estatal sobre la renta se verifica de la misma manera: 16 casos en California, Nueva York, Nueva Jersey, Pensilvania y Massachusetts se reproducen al centavo contra OpenTaxSolver, un motor fiscal estatal independiente que tampoco escribimos. La respuesta principal se recalcula en vivo en su navegador.}

_{Probado y endurecido. Seguridad de entrada: las solicitudes se validan contra el esquema publicado; las entradas incorrectas devuelven un 400 claro con el campo infractor nombrado, nunca un bloqueo o un número incorrecto, y la API en vivo se vuelve a verificar con una suite de robustez después de cada implementación. · Suite de pruebas: el motor de cálculo está cubierto por más de mil pruebas automatizadas en la lógica fiscal federal y de los 50 estados, la recuperación del crédito AMT y la fijación de precios de opciones; una prueba fallida bloquea el lanzamiento.}

_{Uso en vivo: llamadas MCP en los últimos 30 días, servidas directamente desde la telemetría del propio servidor (/api/v1/stats, solo conteos agregados, sin PII).}

Matemática fiscal determinista para compensación de capital que cualquier cliente del Protocolo de Contexto de Modelo (MCP) puede llamar: cronogramas de ejercicio de opciones de acciones de incentivo (ISO) bajo el Impuesto Mínimo Alternativo (AMT), decisiones sobre opciones de acciones no calificadas (NSO) y unidades de acciones restringidas (RSU), calificación de acciones calificadas de pequeñas empresas (QSBS), concentración de una sola acción, cobertura con opciones de venta protectoras y objetivos de financiamiento de capital. Código fiscal federal relevante más los 50 estados y DC, tramos de 2026. Construido por AlphaLatitude Inc., la empresa detrás de OptionsAhoy.

¿Por qué no simplemente preguntarle al modelo? Evaluamos cinco modelos de lenguaje de gran escala (LLM) de frontera, 3 ejecuciones cada uno, 15 pruebas en total, sobre el mismo problema de ejercicio de ISO multianual. Cada prueba sobrestimó el resultado después de impuestos de su propio cronograma propuesto, entre 2x y 20x. La programación multianual tiene un espacio de búsqueda más grande de lo práctico para trabajar en contexto; estas herramientas devuelven la respuesta verificable en su lugar. Evaluación comparativa en vivo, actualizada para los modelos más recientes: optionsahoy.com/benchmark. Respuestas crudas y puntuación: llm-iso-benchmark. Informe completo: ¿Pero puede hacer impuestos?

Instalar en una línea

El endpoint alojado es https://optionsahoy.com/mcp (HTTP, sin autenticación, sin cuenta). Rutas más rápidas:

Cliente	Instalación
Cualquier cliente MCP	Agregue `https://optionsahoy.com/mcp` como servidor HTTP remoto, o `npx add-mcp https://optionsahoy.com/mcp`
Claude Desktop	Descargue `optionsahoy.mcpb` y haga doble clic
19 clientes vía Smithery	`npx @smithery/cli install alphalatitude/optionsahoy --client claude`
stdio local (npm)	`npx -y optionsahoy-mcp`

Matriz de instalación completa (extensión de CLI de Gemini, JSON de archivo de configuración, API REST, Registro de Agentes de Google Cloud): optionsahoy.com/for-agents.

Las ocho herramientas

Nombre de la herramienta	Qué calcula
`amt_iso_optimize`	Cronograma de ejercicio de ISO multianual que maximiza el valor final neto después de impuestos en el horizonte de planificación, modelando la recuperación del crédito AMT, la expiración de la subvención y la ventana de ejercicio posterior a la terminación
`nso_calculate`	Pago después de impuestos por un ejercicio de NSO (federal, estatal, FICA), comparando vender en el ejercicio vs. mantener para ganancias de capital a largo plazo
`rsu_sell_vs_hold`	Decisión de adjudicación de RSU: vender en la adjudicación vs. mantener para ganancias de capital a largo plazo, incluida la brecha entre la retención suplementaria del 22% y su tramo marginal
`concentration_analyze`	Riesgo de concentración de una sola acción (exposición a caídas en descensos del 30/50/70%), comparando venta después de impuestos, mantener y estrategias de cobertura
`protective_put_price`	Opción de venta protectora, collar de costo cero y fijación de precios de diferencial de venta mediante Black-Scholes: costo de cobertura anualizado, pérdida máxima, tope de ganancia, banda protegida, probabilidad de tocar el piso y qué estructura recomienda
`qsbs_check`	Calificación QSBS de la Sección 1202 en las seis pruebas legales, con la exclusión escalonada OBBBA 2026 y la conformidad por estado
`equity_funding_plan`	Cronograma de venta multianual y de múltiples bloques para alcanzar un monto objetivo después de impuestos para una fecha límite; devuelve cuatro planes nombrados más la frontera completa de riesgo/riqueza
`rsu_lot_optimize`	Qué lotes de RSU adjudicados vender, y en qué fechas, para desinvertir una fracción objetivo de acciones al impuesto calculado más bajo: identificación de lotes específicos, diferimiento a largo plazo y distribución de tramos multianual con arrastre de pérdidas dentro del plan, versus una orden de venta FIFO

El optimizador de ISO busca su espacio de candidatos discretizado completo y refina acción por acción, igualando un máximo de fuerza bruta al centavo en un caso publicable y manejable (ver la prueba); los planificadores ejecutan búsquedas deterministas conscientes de tramos y las calculadoras devuelven resultados exactos. Cálculo determinista, no una suposición de modelo de lenguaje. La cobertura abarca el código fiscal federal relevante (tramos ordinarios, ganancias de capital a largo plazo, AMT con recuperación de crédito, FICA, NIIT) más los 50 estados y DC (tramos ordinarios estatales, tratamiento de GCLP, AMT estatal para CA, CO, CT, MN). El mismo motor que las calculadoras en el navegador en optionsahoy.com/tools; la respuesta de la API lleva las mismas cifras calculadas que al hacer clic en la herramienta.

Úselo en su marco de agentes (Python)

Si construye agentes en Python en lugar de llamar al endpoint MCP directamente, OptionsAhoy ofrece paquetes de herramientas instalables para los principales marcos de agentes. Cada uno envuelve las mismas calculadoras detrás de la interfaz de herramientas nativa del marco. Todos están publicados en PyPI y todos son sin clave: sin cuenta de OptionsAhoy, sin clave de API.

Marco	Instalación	Importación	Ejemplo
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 simple	`pip install optionsahoy`	`from optionsahoy import OptionsAhoyClient`	`basic_client.py`

Los tres adaptadores de marco incorporan automáticamente el cliente sin clave optionsahoy. También hay un agente de OpenBB Workspace (una aplicación FastAPI construida sobre el cliente de OptionsAhoy) para usar dentro de OpenBB Workspace. El código fuente y los ejemplos ejecutables de todo lo anterior viven bajo integrations/python.

Más formas de construir

Sin importar cómo esté construido su agente, hay una pieza lista para usar. Todos son públicos y sin clave.

Bloque de construcción	Qué es
Herramientas del SDK de Vercel AI	Un paquete de TypeScript (`optionsahoy-ai-sdk`) que expone las ocho calculadoras como definiciones de `tool()` del SDK de Vercel AI, listas para distribuir en `generateText` / `streamText`.
Kits de instrucciones	Reglas y habilidades de editor para Cursor, Windsurf, Claude Skills y subagentes de Claude Code, para que su agente de codificación llame a las herramientas de OptionsAhoy para preguntas de compensación de capital.
Recetas de codificación	Recetas de Python para copiar y pegar, un archivo autocontenido por pregunta, que llaman a la API sin clave solo con `requests`. También en `integrations/recipes`.
Plantillas para constructores	Un flujo de trabajo n8n importable más recetas de construcción para Flowise, Langflow y Dify.
Evaluación de uso de herramientas	Una evaluación de inspect_ai que mide si un agente alcanza el óptimo demostrable en un problema de ISO multianual, con y sin la herramienta.
Descubrimiento A2A	Una Tarjeta de Agente Agent2Agent (A2A) para que otros agentes puedan descubrir y delegar preguntas de compensación de capital al planificador.
Extensión de Zed	Una extensión de servidor de contexto del editor Zed que conecta el agente del editor al servidor MCP de OptionsAhoy.
Aplicación ACI.dev	La definición de la aplicación OptionsAhoy para la plataforma de herramientas de agentes de código abierto ACI.dev.
Puente de OpenRouter	Una receta para adjuntar el servidor MCP de OptionsAhoy sin clave a cualquier modelo enrutado a través del endpoint compatible con OpenAI de OpenRouter.

Pruébelo sin instalar

El widget en vivo en optionsahoy.com/for-agents llama a este mismo endpoint desde su navegador. Sin cliente, sin configuración.

¿Prefiere una interfaz de chat? Las mismas calculadoras responden preguntas en lenguaje natural en poe.com/OptionsAhoy.

O vea una sesión real:

Sesión real de Claude Code, sin editar. Una pregunta de múltiples bloques de META (10K ISO + 6K RSU adjudicadas + 2K RSU nuevas + casa de $400K en 2027) dispara 4 herramientas MCP de OptionsAhoy en paralelo: riesgo de concentración, plan de financiamiento de capital, optimización AMT/ISO, fijación de precios de opción de venta protectora. Claude sintetiza las salidas en un plan que anula la selección independiente de cada herramienta porque el usuario está concentrado al 86% en META. 2:13. Haga clic en el póster para reproducirlo en optionsahoy.com.

Endpoints y descubrimiento

Endpoint MCP en vivo: https://optionsahoy.com/mcp API REST en vivo: https://optionsahoy.com/api/v1 Especificación OpenAPI 3.1: /openapi.json Manifiestos de descubrimiento: /.well-known/mcp.json · /.well-known/openapi.json Documentación de integración de agentes: optionsahoy.com/for-agents

Recursos MCP (informes temáticos)

Ocho recursos de markdown bajo resources/list dan a un LLM suficiente base para discutir el tema antes de elegir una herramienta. La mayoría se corresponde 1:1 con un artículo fundamental en optionsahoy.com/learn y la calculadora correspondiente; el informe de financiamiento de capital se corresponde con su calculadora, y el informe de tickers cubiertos enumera los símbolos que resuelve el atajo opcional ticker.

URI del recurso	Tema	Combinar con
`https://optionsahoy.com/learn/amt-crossover`	Cruce ISO/AMT y cuatro errores costosos	`amt_iso_optimize`
`https://optionsahoy.com/learn/nso-sell-vs-hold`	NSO vender en el ejercicio vs. mantener para GCLP	`nso_calculate`
`https://optionsahoy.com/learn/rsu-withholding-gap`	Brecha de retención del 22% de RSU y cinco sorpresas de abril	`rsu_sell_vs_hold`
`https://optionsahoy.com/learn/single-stock-concentration-risk`	Riesgo de concentración y compensación de diversificación	`concentration_analyze`
`https://optionsahoy.com/learn/zero-cost-collars`	Opciones de venta protectoras, collares de costo cero y diferenciales de venta	`protective_put_price`
`https://optionsahoy.com/learn/qsbs`	Calificación QSBS y cinco formas de perder la exclusión	`qsbs_check`
`https://optionsahoy.com/tools/equity-funding`	Vender capital para financiar un objetivo de efectivo para una fecha límite	`equity_funding_plan`

Prompts MCP (andamios de flujo de trabajo)

Ocho prompts bajo prompts/list estructuran preguntas típicas de usuarios y enrutan a la herramienta correcta. En Claude Desktop aparecen como comandos de barra con nombre; en cualquier cliente MCP, prompts/get { name, arguments } devuelve un mensaje de usuario completamente plantillado.

Nombre del prompt	Rutas hacia
`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`

Detalles de instalación

Extensión de Claude Desktop (un clic)

El paquete optionsahoy.mcpb se instala con doble clic (o arrastrándolo a Claude Desktop → Configuración → Extensiones), sin necesidad de terminal ni edición de archivos de configuración, usando el tiempo de ejecución de Node.js integrado de Claude Desktop.

Para compilar el paquete desde el código fuente:

npm install && npm run build:mcpb

CLI de Smithery (19 clientes, un comando)

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

Cambia claude por cualquier cliente que Smithery admita: claude-code, cursor, vscode, gemini-cli, codex, windsurf, cline, goose, opencode y 10 más. Listado: smithery.ai/servers/alphalatitude/optionsahoy.

Extensión de CLI de Gemini

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

Este repositorio también funciona como extensión de CLI de Gemini: gemini-extension.json conecta el endpoint MCP alojado y GEMINI.md proporciona contexto de uso al modelo.

stdio local (npm)

Para clientes que solo admiten servidores stdio locales (Claude Desktop sin mcp-remote, algunas integraciones de IDE):

npx -y optionsahoy-mcp

O añade a un archivo de configuración de Claude Desktop / Cline / Goose:

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

El servidor local devuelve las mismas cifras calculadas que el endpoint alojado en https://optionsahoy.com/mcp. El código fuente de ambos se encuentra en functions/_lib/mcp-tools.ts; el punto de entrada stdio es src/stdio-server.ts.

Usa la API REST directamente

# 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

Las formas de los cuerpos de solicitud están documentadas en public/openapi.json.

Estructura del repositorio

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)

Ejecutar pruebas

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

Listados de registros

Official MCP Registry — io.github.AlvisoOculus/optionsahoy-mcp, estado activo
Smithery — alphalatitude/optionsahoy (además de la habilidad de plan de equidad)
Gemini CLI extensions gallery — @AlvisoOculus/optionsahoy-mcp
add-mcp curated registry
PulseMCP (se propaga desde el Official Registry)
Continue.dev hub — el bloque YAML se encuentra en .continue/mcpServers/optionsahoy.yaml

Uso desde Google Cloud (agentes de Gemini)

El Registro de Agentes de Google Cloud permite que cada proyecto de GCP registre servidores MCP externos para que los usen los agentes de Gemini. El registro es por proyecto (sin envío central). Dos vías:

# 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)

El toolspec.json refleja la respuesta tools/list de MCP con anotaciones readOnlyHint y idempotentHint en las ocho herramientas (todas son calculadoras deterministas puras sin efectos secundarios). Para regenerar tras un cambio en la forma de las herramientas:

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

Solución de problemas

Conexión rechazada / 404 desde el endpoint MCP https://optionsahoy.com/mcp requiere POST con content-type: application/json y un cuerpo JSON-RPC. Un GET devuelve una descripción JSON del servidor; cualquier otro verbo devuelve 405. Verifica con:

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

Las llamadas a herramientas fallan con texto Error: ... en la respuesta El servidor MCP devuelve isError: true con un mensaje legible cuando falla la validación de entrada. Lo más común: falta un campo obligatorio o se pasa un número como cadena. Comprueba la entrada contra el inputSchema devuelto por tools/list, o contra /openapi.json.

La herramienta no aparece en Claude.ai o Claude Desktop

Confirma que la URL del conector es exactamente https://optionsahoy.com/mcp (sin barra final, sin /v1).
En Claude Desktop, reinicia la aplicación después de editar claude_desktop_config.json.
En Claude.ai, el interruptor del conector es por chat: actívalo en el menú de adjuntos.
Comprueba la respuesta tools/list en vivo (se esperan ocho herramientas): curl -X POST https://optionsahoy.com/mcp -H 'content-type: application/json' -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

Errores CORS desde un cliente basado en navegador El servidor devuelve access-control-allow-origin: * en todas las respuestas, incluida la preflight, y acepta los encabezados MCP estándar (content-type, mcp-session-id, mcp-protocol-version). Si el navegador aún bloquea, es probable que el cliente esté enviando un encabezado no permitido: verifica los encabezados de la solicitud contra la respuesta access-control-allow-headers.

Recurso / prompt no encontrado Los URI de recursos y los nombres de prompts distinguen entre mayúsculas y minúsculas. Obtén la lista canónica con resources/list y prompts/list en lugar de escribirla a mano.

Cálculos fiscales desactualizados El motor fiscal incluye tramos ajustados por inflación de 2026, reglas QSBS de OBBBA 2026 y tablas actuales de conformidad estatal. Si los resultados parecen incorrectos para un horizonte de varios años, verifica que la entrada grantDate, acquisitionDate o saleDate corresponda al año que esperas: el motor resuelve los tramos por año fiscal.

Informar de un error de cálculo o salida inesperada Envía un correo a andrew@alphalatitude.com con: el cuerpo exacto de la solicitud JSON-RPC, la respuesta, el valor esperado y (si se conoce) la publicación del IRS o el estatuto estatal del que se deriva el valor esperado.

Política de privacidad

Política completa: optionsahoy.com/privacy.

En resumen: no se requiere cuenta y no se almacena información personal identificable: ni nombre, correo electrónico, dirección IP ni inicio de sesión. Las entradas y salidas de las herramientas se conservan brevemente (unos siete días) para depuración y mejora del producto, junto con metadatos de uso agregados (herramienta, marca de tiempo, ubicación aproximada, tipo de cliente) que se usan para comprender el uso y detectar abusos. El servidor stdio local y la extensión de Claude Desktop calculan todo en tu máquina; la única solicitud de red es una consulta de cadena de opciones (solo símbolo de ticker) para protective_put_price.

Licencia

MIT. Consulta LICENSE. El servicio desplegado en https://optionsahoy.com/mcp y https://optionsahoy.com/api/v1 es gratuito durante la beta según los términos.

Contacto

Para alianzas, acceso temprano a la API, soporte de integración MCP: andrew@alphalatitude.com