OptionsAhoy

Tested and hardened.Input safety:requests are validated against the published schema; bad inputs return a clear 400 with the offending field named, never a crash or a wrong number, and the live API is re-checked by a robustness suite after every deploy. ·Test suite:the calculation engine is covered by more than a thousand automated tests across the federal and 50-state tax logic, AMT credit recovery, and option pricing; a failing test blocks the release.

The hosted endpoint ishttps://optionsahoy.com/mcp(HTTP, no auth, no account). Quickest paths:

If you build agents in Python rather than calling the MCP endpoint directly, OptionsAhoy ships installable tool packages for the major agent frameworks. Each one wraps the same calculators behind the framework's native tool interface. All are published on PyPI and all are keyless: no OptionsAhoy account, no API key.

However your agent is built, there is a drop-in piece. All are public and keyless.

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.

Eight prompts underprompts/listscaffold typical user questions and route to the right tool. In Claude Desktop they appear as named slash-commands; in any MCP client,prompts/get { name, arguments }returns a fully-templated user message.

npm install && npm run build:mcpb

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

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

For clients that only support local stdio servers (Claude Desktop withoutmcp-remote, some IDE integrations):

Or add to a Claude Desktop / Cline / Goose config file:

# 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

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)

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

Google Cloud Agent Registry lets each GCP project register external MCP servers for use by Gemini agents. Registration is per-project (no central submission). Two paths:

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

The toolspec.json mirrors the MCPtools/listresponse withreadOnlyHintandidempotentHintannotations on all eight tools (all are pure deterministic calculators with no side effects). To regenerate after a tool-shape change:

Tool not appearing in Claude.ai or Claude Desktop

- Confirm the connector URL is exactlyhttps://optionsahoy.com/mcp(no trailing slash, no/v1).
- In Claude Desktop, restart the app after editingclaude_desktop_config.json.
- In Claude.ai, the connector toggle is per-chat: enable it in the attachments menu.
- Check the livetools/listresponse (eight tools expected):curl -X POST https://optionsahoy.com/mcp -H 'content-type: application/json' -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

CORS errors from a browser-based clientThe server returnsaccess-control-allow-origin: *on all responses including preflight, and accepts the standard MCP headers (content-type,mcp-session-id,mcp-protocol-version). If a browser still blocks, the client is likely sending a non-allowed header — verify the request headers against theaccess-control-allow-headersresponse.

Resource / prompt not foundResource URIs and prompt names are case-sensitive. Pull the canonical list withresources/listandprompts/listrather than hand-typing.

Stale tax-year mathThe tax engine ships with 2026 inflation-adjusted brackets, OBBBA 2026 QSBS rules, and current state-conformity tables. If results look off for a multi-year horizon, verify the inputgrantDate,acquisitionDate, orsaleDatefalls in the year you expect — the engine resolves brackets per tax year.

In short: no account is required and no personally identifiable information is stored — no name, email, IP address, or login. Tool inputs and outputs are retained briefly (about seven days) for debugging and product improvement, alongside aggregate usage metadata (tool, timestamp, coarse location, client type) used to understand usage and detect abuse. The local stdio server and the Claude Desktop extension compute everything on your machine; the only network request is an option-chain lookup (ticker symbol only) forprotective_put_price.

Bridge Town is an MCP-native, git-versioned financial modeling platform for FP&A teams and finance leaders. AI agents use Bridge Town tools to create projects, write Python model files, run models in isolated cloud sandboxes, query data, write outputs to Google Sheets, create dashboards, branch scenarios, and collaborate with teammates.

The Capital.com MCP Server lets your AI assistant talk to your trading account directly. Market data, position checks, trade previews – all in plain language, without leaving your AI tool.

Coinrule Agentic Trading MCP enables investors to create, backtest, execute, and manage trading agents through natural language across stocks, crypto and ETFs

Invest with Claude and other AI assistants

Australian Consumer Data Right Product Data

Remote MCP server for historical crypto & prediction-market data: search ~500K instruments, live market stats (OHLC, turnover, spreads, depth, slippage) and tick-data purchase. Keyless for catalog & stats; optional OAuth for account tools. Endpoint: https://cryptostruct.com/mcp

Cross-border debt collection from your AI assistant: check cases, get pricing, submit new cases.

Read-only MCP server for your Evibe investment portfolio + live market data (holdings, performance, dividends, benchmarks, screeners). Works with Claude & ChatGPT.