[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_121":122},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module '@alvisooculus/optionsahoy-mcp' is not configured","tools","module",{"_20":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":26,"_34":-5,"_35":36,"_37":-5,"_38":-5,"_39":40,"_41":42,"_43":44,"_45":46,"_47":48,"_49":50,"_51":52,"_53":54,"_55":48,"_56":57,"_58":59,"_60":61,"_62":63,"_64":65,"_66":67,"_68":69,"_70":71,"_72":73,"_74":75,"_76":77,"_78":-5,"_79":-5,"_80":-5,"_81":48,"_82":-5,"_83":84,"_85":86,"_87":88,"_89":90,"_91":92,"_93":94,"_95":96},"apiUrl","https://odel.app/api","creator","alvisooculus","moduleId","optionsahoy-mcp","@alvisooculus/optionsahoy-mcp","displayName","optionsahoy mcp","tagline","Equity comp tax/trade optimizer: ISO/AMT exercise, NSO, RSU, QSBS, concentration, hedging. 50-state.","iconKey","https://avatars.githubusercontent.com/u/152841708?v=4","category","dev-tools","status","published","metaDescription","metaKeywords","deploymentType","external","workerName","bindingName","mcpConfig","{\"url\":\"https://optionsahoy.com/mcp\",\"transport\":\"streamable-http\",\"authType\":\"none\"}","pricingModel","free","creatorUserId","system:external-import","createdAt",1781363307000,"updatedAt",1781756423000,"sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=io.github.AlvisoOculus%2Foptionsahoy-mcp","sourceVerified",true,"importedAt","upstreamStars",3,"upstreamUpdatedAt",1781695707000,"detectedTransport","streamable-http","detectedAuthType","none","probeStatus","ok","lastProbedAt",1781670022000,"githubRepoUrl","https://github.com/AlvisoOculus/optionsahoy-mcp","githubRepoFullName","AlvisoOculus/optionsahoy-mcp","releaseId","ext-alvisooculus-optionsahoy-mcp","version","1.9.5","descriptionMarkdown","# OptionsAhoy MCP Server\n\n[![Glama quality score](https://glama.ai/mcp/servers/AlvisoOculus/optionsahoy-mcp/badges/score.svg)](https://glama.ai/mcp/servers/AlvisoOculus/optionsahoy-mcp)\n[![npm version](https://img.shields.io/npm/v/optionsahoy-mcp?logo=npm&label=npm)](https://www.npmjs.com/package/optionsahoy-mcp)\n[![MCPSafe security grade](https://api.mcpsafe.io/api/badge/pubfast497de7f7a5466f2a414a)](https://mcpsafe.io/scan/pubfast497de7f7a5466f2a414a)\n[![MCP calls in the last 30 days](https://img.shields.io/endpoint?url=https%3A%2F%2Foptionsahoy.com%2Fapi%2Fv1%2Fbadge%3Fmetric%3Dcalls30d&style=flat)](https://optionsahoy.com/for-agents)\n\n_{**Independently verified by third parties.** **[Glama](https://glama.ai/mcp/servers/AlvisoOculus/optionsahoy-mcp):** third-party MCP-directory quality score (tool docs, behavior, completeness). · **[npm](https://www.npmjs.com/package/optionsahoy-mcp):** published with build provenance, a signed [SLSA](https://slsa.dev) attestation that this package was built from this repo by GitHub Actions (verify with `npm audit signatures`). · **[MCPSafe](https://mcpsafe.io/scan/pubfast497de7f7a5466f2a414a):** independent 5-model-consensus security scan (AIVSS), Grade A with zero findings.}\n\n_{**Validated against trusted sources** (checks we run ourselves, against references we do not control, and that you can reproduce). **[Computation](https://optionsahoy.com/verification):** every 2026 federal tax constant matches its IRS Rev. Proc. 2025-32 / Internal Revenue Code value, and 14 worked federal cases (ordinary income, long-term capital gains, and the Alternative Minimum Tax including the incentive stock option bargain element) reproduce to the cent against the independently-maintained [PSL Tax-Calculator](https://github.com/PSLmodels/Tax-Calculator), a tax model we did not write. State income tax is cross-checked the same way: 16 cases across California, New York, New Jersey, Pennsylvania, and Massachusetts reproduce to the cent against [OpenTaxSolver](https://opentaxsolver.sourceforge.net/), an independent state tax engine we also did not write. The headline answer is recomputed live in your browser.}\n\n_{**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.}\n\n_{**Live usage:** MCP calls over the last 30 days, served straight from the server's own telemetry ([/api/v1/stats](https://optionsahoy.com/api/v1/stats), aggregate counts only, no PII).}\n\nDeterministic equity-compensation tax math that any Model Context Protocol (MCP) client can call: incentive stock option (ISO) exercise schedules under the alternative minimum tax (AMT), non-qualified stock option (NSO) and restricted stock unit (RSU) decisions, qualified small business stock (QSBS) qualification, single-stock concentration, protective-put hedging, and equity-funding goals. Full federal tax code plus all 50 states and DC, 2026 brackets. Built by [AlphaLatitude Inc.](https://alphalatitude.com), the company behind [OptionsAhoy](https://optionsahoy.com).\n\n**Why not just ask the model?** We benchmarked five frontier large language models (LLMs), 3 runs each, 15 trials total, on the same multi-year ISO exercise problem. Every trial overshot the true after-tax outcome, by 2x to 20x. Multi-year scheduling has a search space larger than an LLM can reason through in-context; these tools return the verifiable answer instead. Live benchmark, updated for the latest models: [optionsahoy.com/benchmark](https://optionsahoy.com/benchmark). Raw responses and scoring: [llm-iso-benchmark](https://github.com/AlvisoOculus/llm-iso-benchmark). Full write-up: [But can it do taxes though?](https://hackernoon.com/but-can-it-do-taxes-though-why-you-shouldnt-trust-chatbots-with-tax-optimization-math)\n\n## Install in one line\n\nThe hosted endpoint is `https://optionsahoy.com/mcp` (HTTP, no auth, no account). Quickest paths:\n\n| Client | Install |\n|---|---|\n| Any MCP client | Add `https://optionsahoy.com/mcp` as a remote HTTP server, or `npx add-mcp https://optionsahoy.com/mcp` |\n| Claude Desktop | Download [`optionsahoy.mcpb`](https://github.com/AlvisoOculus/optionsahoy-mcp/releases/latest/download/optionsahoy.mcpb) and double-click it |\n| 19 clients via Smithery | `npx @smithery/cli install alphalatitude/optionsahoy --client claude` |\n| Local stdio (npm) | `npx -y optionsahoy-mcp` |\n\nFull install matrix (Gemini CLI extension, config-file JSON, REST API, Google Cloud Agent Registry): [optionsahoy.com/for-agents](https://optionsahoy.com/for-agents).\n\n## The seven tools\n\n| Tool name | What it computes |\n|---|---|\n| `amt_iso_optimize` | Multi-year ISO exercise schedule that maximizes after-tax net final value at the planning horizon, modeling AMT credit recovery, grant expiration, and the post-termination exercise window |\n| `nso_calculate` | After-tax payout on an NSO exercise (federal, state, FICA), comparing sell-at-exercise vs hold for long-term capital gains |\n| `rsu_sell_vs_hold` | RSU vest decision: sell at vest vs hold for long-term capital gains, including the gap between 22% supplemental withholding and your marginal bracket |\n| `concentration_analyze` | Single-stock concentration risk (drawdown exposure at 30/50/70% downside), comparing after-tax sell-down, hold, and hedge strategies |\n| `protective_put_price` | Protective put and zero-cost collar pricing via Black-Scholes: annualized hedge cost, maximum loss, upside cap, floor-hit probability |\n| `qsbs_check` | Section 1202 QSBS qualification across the eight statutory tests, with the OBBBA 2026 tiered exclusion and per-state conformity |\n| `equity_funding_plan` | Multi-year, multi-stack sell schedule to hit a target after-tax amount by a deadline; returns four named plans plus the full risk/wealth frontier |\n\nThe optimizers return the best schedule across the candidate space; the calculators return exact deterministic results. Deterministic computation, not a language-model guess, validated against brute-force ground truth on tractable cases ([see the proof](https://optionsahoy.com/verification)). Coverage spans the full federal tax code (ordinary brackets, long-term capital gains, AMT with credit recovery, FICA, NIIT) plus all 50 states and DC (state ordinary brackets, LTCG treatment, state AMT for CA, CO, CT, MN). Same engine as the in-browser calculators at [optionsahoy.com/tools](https://optionsahoy.com/tools); the API response is byte-identical to clicking through the tool.\n\n## Use it in your agent framework (Python)\n\nIf 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.\n\n| Framework | Install | Import | Example |\n|---|---|---|---|\n| LangChain | `pip install optionsahoy-langchain` | `from langchain_optionsahoy import get_optionsahoy_tools` | [`equity_agent.py`](https://github.com/AlvisoOculus/optionsahoy-mcp/blob/main/integrations/python/optionsahoy-langchain/examples/equity_agent.py) |\n| LlamaIndex | `pip install llama-index-tools-optionsahoy` | `from llama_index.tools.optionsahoy import OptionsAhoyToolSpec` | [`equity_agent.py`](https://github.com/AlvisoOculus/optionsahoy-mcp/blob/main/integrations/python/llama-index-tools-optionsahoy/examples/equity_agent.py) |\n| CrewAI | `pip install crewai-optionsahoy` | `from crewai_optionsahoy import get_optionsahoy_tools` | [`equity_crew.py`](https://github.com/AlvisoOculus/optionsahoy-mcp/blob/main/integrations/python/crewai-optionsahoy/examples/equity_crew.py) |\n| Plain Python client | `pip install optionsahoy` | `from optionsahoy import OptionsAhoyClient` | [`basic_client.py`](https://github.com/AlvisoOculus/optionsahoy-mcp/blob/main/integrations/python/optionsahoy/examples/basic_client.py) |\n\nThe three framework adapters pull in the keyless `optionsahoy` client automatically. There is also an [OpenBB Workspace agent](https://github.com/AlvisoOculus/optionsahoy-mcp/blob/main/integrations/openbb-agent) (a FastAPI application built on the OptionsAhoy client) for use inside OpenBB Workspace. Source and runnable examples for all of the above live under [`integrations/python`](https://github.com/AlvisoOculus/optionsahoy-mcp/tree/main/integrations/python).\n\n## More ways to build\n\nHowever your agent is built, there is a drop-in piece. All are public and keyless.\n\n| Building block | What it is |\n|---|---|\n| [Instruction kits](https://github.com/AlvisoOculus/optionsahoy-mcp/blob/main/integrations/agent-kits) | Editor rules and skills for Cursor, Windsurf, Claude Skills, and Claude Code subagents, so your coding agent calls the OptionsAhoy tools for equity-compensation questions. |\n| [Coding recipes](https://github.com/AlvisoOculus/equity-comp-tax-python) | Copy-paste Python recipes, one self-contained file per question, calling the keyless API with only `requests`. Also in [`integrations/recipes`](https://github.com/AlvisoOculus/optionsahoy-mcp/blob/main/integrations/recipes). |\n| [Builder templates](https://github.com/AlvisoOculus/optionsahoy-mcp/blob/main/integrations/agent-builder-templates) | An importable n8n workflow plus build recipes for Flowise, Langflow, and Dify. |\n| [Tool-use eval](https://github.com/AlvisoOculus/optionsahoy-mcp/blob/main/integrations/eval) | An inspect_ai evaluation measuring whether an agent reaches the provable optimum on a multi-year ISO problem, with and without the tool. |\n| [A2A discovery](https://github.com/AlvisoOculus/optionsahoy-mcp/blob/main/integrations/openbb-agent) | An Agent2Agent (A2A) Agent Card so other agents can discover and delegate equity-compensation questions to the planner. |\n\n## Try it without installing\n\nThe live widget on [optionsahoy.com/for-agents](https://optionsahoy.com/for-agents) calls this same endpoint from your browser. No client, no config.\n\nOr watch a real session:\n\n[![Demo: Claude Code installing and using the OptionsAhoy MCP](https://raw.githubusercontent.com/AlvisoOculus/optionsahoy-mcp/main/docs/demo-claude-code-poster.jpg)](https://optionsahoy.com/for-agents#demo)\n\n*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.*\n\n## Endpoints and discovery\n\n**Live MCP endpoint:** `https://optionsahoy.com/mcp`\n**Live REST API:** `https://optionsahoy.com/api/v1`\n**OpenAPI 3.1 spec:** [`/openapi.json`](https://optionsahoy.com/openapi.json)\n**Discovery manifests:** [`/.well-known/mcp.json`](https://optionsahoy.com/.well-known/mcp.json) · [`/.well-known/openapi.json`](https://optionsahoy.com/.well-known/openapi.json)\n**Agent integration docs:** [optionsahoy.com/for-agents](https://optionsahoy.com/for-agents)\n\n## MCP resources (topical briefings)\n\nSix markdown resources under `resources/list` give an LLM enough grounding to discuss the topic before picking a tool. Each maps 1:1 with a cornerstone article on [optionsahoy.com/learn](https://optionsahoy.com/learn) and the matching calculator.\n\n| Resource URI | Topic | Pair with |\n|---|---|---|\n| `https://optionsahoy.com/learn/amt-crossover` | ISO/AMT crossover and four expensive mistakes | `amt_iso_optimize` |\n| `https://optionsahoy.com/learn/nso-sell-vs-hold` | NSO sell-at-exercise vs hold-for-LTCG | `nso_calculate` |\n| `https://optionsahoy.com/learn/rsu-withholding-gap` | RSU 22% withholding gap and five April surprises | `rsu_sell_vs_hold` |\n| `https://optionsahoy.com/learn/single-stock-concentration-risk` | Concentration risk and diversification trade-off | `concentration_analyze` |\n| `https://optionsahoy.com/learn/zero-cost-collars` | Protective puts and zero-cost collars | `protective_put_price` |\n| `https://optionsahoy.com/learn/qsbs` | QSBS qualification and five ways to lose the exclusion | `qsbs_check` |\n\n## MCP prompts (workflow scaffolds)\n\nSeven prompts under `prompts/list` scaffold 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.\n\n| Prompt name | Routes to |\n|---|---|\n| `optimize-iso-exercise` | `amt_iso_optimize` |\n| `analyze-nso-decision` | `nso_calculate` |\n| `analyze-rsu-vest` | `rsu_sell_vs_hold` |\n| `analyze-concentration` | `concentration_analyze` |\n| `price-protective-put` | `protective_put_price` |\n| `check-qsbs-eligibility` | `qsbs_check` |\n| `plan-equity-funding` | `equity_funding_plan` |\n\n## Install details\n\n### Claude Desktop extension (one-click)\n\nThe [`optionsahoy.mcpb`](https://github.com/AlvisoOculus/optionsahoy-mcp/releases/latest/download/optionsahoy.mcpb) bundle installs by double-click (or drag onto Claude Desktop → Settings → Extensions), with no terminal or config-file editing, using Claude Desktop's built-in Node.js runtime.\n\nTo build the bundle from source:\n\n```bash\nnpm install && npm run build:mcpb\n```\n\n### Smithery CLI (19 clients, one command)\n\n```bash\nnpx @smithery/cli install alphalatitude/optionsahoy --client claude\n```\n\nSwap `claude` for any client Smithery supports: `claude-code`, `cursor`, `vscode`, `gemini-cli`, `codex`, `windsurf`, `cline`, `goose`, `opencode`, and 10 more. Listing: [smithery.ai/servers/alphalatitude/optionsahoy](https://smithery.ai/servers/alphalatitude/optionsahoy).\n\n### Gemini CLI extension\n\n```bash\ngemini extensions install https://github.com/AlvisoOculus/optionsahoy-mcp\n```\n\nThis repo doubles as a [Gemini CLI extension](https://geminicli.com/docs/extensions/): `gemini-extension.json` wires the hosted MCP endpoint and `GEMINI.md` provides usage context to the model.\n\n### Local stdio (npm)\n\nFor clients that only support local stdio servers (Claude Desktop without `mcp-remote`, some IDE integrations):\n\n```bash\nnpx -y optionsahoy-mcp\n```\n\nOr add to a Claude Desktop / Cline / Goose config file:\n\n```json\n{\n \"mcpServers\": {\n \"optionsahoy\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"optionsahoy-mcp\"]\n }\n }\n}\n```\n\nThe local server returns byte-identical responses to the hosted endpoint at `https://optionsahoy.com/mcp`. Source for both lives in [`functions/_lib/mcp-tools.ts`](https://github.com/AlvisoOculus/optionsahoy-mcp/blob/main/functions/_lib/mcp-tools.ts); the stdio entry point is [`src/stdio-server.ts`](https://github.com/AlvisoOculus/optionsahoy-mcp/blob/main/src/stdio-server.ts).\n\n## Use the REST API directly\n\n```bash\n# List endpoints\ncurl https://optionsahoy.com/api/v1\n\n# Run an optimization\ncurl -X POST https://optionsahoy.com/api/v1/amt-iso \\\n -H \"content-type: application/json\" \\\n -d @input.json\n```\n\nRequest body shapes are documented in [`public/openapi.json`](https://github.com/AlvisoOculus/optionsahoy-mcp/blob/main/public/openapi.json).\n\n## Repository layout\n\n```\nfunctions/ Cloudflare Pages Functions (MCP server + REST API endpoints)\n mcp.ts HTTP MCP server\n api/v1/*.ts Seven tool endpoints + stats + GET /api/v1 discovery\n _lib/*.ts Shared helpers, calc-input parsers, MCP tool descriptors\nlib/ Optimizer + tax-code logic\n calc/ Per-tool optimizer functions (computeAmtIso, etc.)\n tax/ Federal + 50-state + DC bracket data, AMT, FICA, NIIT\n markets/ Sector statistics\n options/ Black-Scholes, risk-free rates\n data/ Type definitions for option-chain data\npublic/ Static assets: OpenAPI spec, llms.txt, discovery manifests\ntests/ Vitest suites (172 tests including byte-identity assertions)\n```\n\n## Run tests\n\n```bash\nnpm install\nnpm test # 172 tests, ~3s on a laptop\nnpm run typecheck\n```\n\n## Registry listings\n\n- [Official MCP Registry](https://registry.modelcontextprotocol.io/v0/servers?search=optionsahoy) — `io.github.AlvisoOculus/optionsahoy-mcp` v1.0.0, status active\n- [Smithery](https://smithery.ai/servers/alphalatitude/optionsahoy) — `alphalatitude/optionsahoy` (plus the [equity-plan skill](https://smithery.ai/skills/alphalatitude/equity-plan))\n- [Gemini CLI extensions gallery](https://geminicli.com/extensions/) — `@AlvisoOculus/optionsahoy-mcp`\n- [add-mcp curated registry](https://github.com/neon-solutions/add-mcp)\n- [PulseMCP](https://www.pulsemcp.com) (cascades from Official Registry)\n- [Continue.dev hub](https://hub.continue.dev/andrews-workspace-73/optionsahoy-mcp) — block YAML lives at [`.continue/mcpServers/optionsahoy.yaml`](https://github.com/AlvisoOculus/optionsahoy-mcp/blob/main/.continue/mcpServers/optionsahoy.yaml)\n\n## Use from Google Cloud (Gemini agents)\n\nGoogle 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:\n\n```bash\n# Path A: let the Agent Registry introspect our MCP endpoint\ngcloud alpha agent-registry mcp-servers register \\\n --uri=https://optionsahoy.com/mcp \\\n --display-name=\"OptionsAhoy\" \\\n --location=us-central1 \\\n --import-tools\n\n# Path B: pass our published toolspec.json directly (faster, no introspection)\ngcloud alpha agent-registry mcp-servers register \\\n --uri=https://optionsahoy.com/mcp \\\n --display-name=\"OptionsAhoy\" \\\n --location=us-central1 \\\n --tool-spec=<(curl -sSL https://optionsahoy.com/toolspec.json)\n```\n\nThe toolspec.json mirrors the MCP `tools/list` response with `readOnlyHint` and `idempotentHint` annotations on all seven tools (all are pure deterministic calculators with no side effects). To regenerate after a tool-shape change:\n\n```bash\ncurl -sS -X POST https://optionsahoy.com/mcp \\\n -H 'content-type: application/json' \\\n -d '{\"jsonrpc\":\"2.0\",\"method\":\"tools/list\",\"id\":1}' \\\n | jq -c '{tools: [.result.tools[] | . + {annotations: {readOnlyHint:true, idempotentHint:true, destructiveHint:false, openWorldHint:false}}]}' \\\n > public/toolspec.json\n```\n\n## Troubleshooting\n\n**Connection refused / 404 from the MCP endpoint**\n`https://optionsahoy.com/mcp` requires `POST` with `content-type: application/json` and a JSON-RPC body. A `GET` returns a JSON server description; any other verb returns 405. Verify with:\n```bash\ncurl -X POST https://optionsahoy.com/mcp -H 'content-type: application/json' \\\n -d '{\"jsonrpc\":\"2.0\",\"method\":\"initialize\",\"id\":1,\"params\":{}}'\n```\n\n**Tool calls fail with `Error: ...` text in the response**\nThe MCP server returns `isError: true` with a human-readable message when input validation fails. Most common: a required field missing, or a number passed as a string. Check the input against the `inputSchema` returned by `tools/list`, or against [`/openapi.json`](https://optionsahoy.com/openapi.json).\n\n**Tool not appearing in Claude.ai or Claude Desktop**\n- Confirm the connector URL is exactly `https://optionsahoy.com/mcp` (no trailing slash, no `/v1`).\n- In Claude Desktop, restart the app after editing `claude_desktop_config.json`.\n- In Claude.ai, the connector toggle is per-chat: enable it in the attachments menu.\n- Check the live `tools/list` response (seven tools expected): `curl -X POST https://optionsahoy.com/mcp -H 'content-type: application/json' -d '{\"jsonrpc\":\"2.0\",\"method\":\"tools/list\",\"id\":1}'`\n\n**CORS errors from a browser-based client**\nThe server returns `access-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 the `access-control-allow-headers` response.\n\n**Resource / prompt not found**\nResource URIs and prompt names are case-sensitive. Pull the canonical list with `resources/list` and `prompts/list` rather than hand-typing.\n\n**Stale tax-year math**\nThe 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 input `grantDate`, `acquisitionDate`, or `saleDate` falls in the year you expect — the engine resolves brackets per tax year.\n\n**Reporting a calculation bug or unexpected output**\nEmail andrew@alphalatitude.com with: the exact JSON-RPC request body, the response, the expected value, and (if known) the IRS publication or state statute the expected value derives from.\n\n## Privacy Policy\n\nFull policy: [optionsahoy.com/privacy](https://optionsahoy.com/privacy).\n\nIn short: tool inputs are processed to compute the result and are not stored. The hosted endpoint logs aggregate call counts per tool (no inputs, no outputs, no identifiers beyond an opaque session ID used to de-duplicate). 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) for `protective_put_price`. No account is required and no PII is collected.\n\n## License\n\nMIT. See [LICENSE](https://github.com/AlvisoOculus/optionsahoy-mcp/blob/main/LICENSE). The deployed service at https://optionsahoy.com/mcp and https://optionsahoy.com/api/v1 is free during beta under [terms](https://optionsahoy.com/terms).\n\n## Contact\n\nFor partnerships, early API access, MCP integration support: andrew@alphalatitude.com\n\n## Deployment topology\n\nTwo pieces serve the live endpoint:\n\n1. **Cloudflare Pages project** (GitHub-connected to this repo) auto-deploys\n `functions/` + `public/` on every push to main → `optionsahoy-mcp.pages.dev`.\n2. **Cloudflare Worker** in [`worker-proxy/`](https://github.com/AlvisoOculus/optionsahoy-mcp/blob/main/worker-proxy/) forwards\n `optionsahoy.com/mcp*` + `/api/v1/*` to that Pages deployment, so the\n public URL stays stable. One-time `wrangler deploy` — see\n [`worker-proxy/README.md`](https://github.com/AlvisoOculus/optionsahoy-mcp/blob/main/worker-proxy/README.md).\n\n## Call stats (D1)\n\nEvery inbound MCP and REST call writes one row to a D1 table via\n`ctx.waitUntil` (fire-and-forget — never blocks the response). View\naggregates at `https://optionsahoy-mcp.pages.dev/admin/mcp-stats?token=`.\n\n**One-time setup (Andrew):**\n\n```bash\n# 1. Create the database. Outputs a database_id.\ncd /Users/andrewk/Projects/optionsahoy-mcp\nnpx wrangler d1 create optionsahoy-mcp-stats\n\n# 2. Apply the schema.\nnpx wrangler d1 execute optionsahoy-mcp-stats --remote \\\n --file=db/migrations/0001_init.sql\n\n# 3. Generate a token.\nopenssl rand -hex 32\n```\n\nThen in the Cloudflare dashboard for the `optionsahoy-mcp` Pages project:\n\n- **Settings → Functions → D1 database bindings** — add variable name\n `MCP_STATS`, point at the database created in step 1.\n- **Settings → Environment variables → Production** — add `ADMIN_TOKEN`\n with the value from step 3 (mark as encrypted).\n\nAfter the next deploy, `/admin/mcp-stats?token=...&days=30` renders the\ndashboard. Without the bindings, `logCall` silently no-ops and the admin\npage returns 503 (the rest of the server is unaffected).\n\nWhat's logged: `ts, endpoint, tool, is_error, error_msg (truncated 500),\nclient_name, ua (truncated 200), country`. Tool arguments are **never**\nlogged (PII + table-size).\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays",0,"categoryDisplayName","Developer Tools","upstream",{"_99":100,"_101":102,"_103":104,"_105":106,"_107":-5},"requiredSecrets",[],"tags",[],"assets",[],"stats",{"_97":84,"_98":84},"ratingAvg","reviewCount","topics",[108,109,110,111,112,113,114,115,116,117,118,119,120],"license","MIT","language","TypeScript","registryName","io.github.AlvisoOculus/optionsahoy-mcp","homepage","ai-agents","anthropic","claude","cloudflare-pages-functions","equity-compensation","finance","gemini-cli-extension","mcp","mcp-server","model-context-protocol","openapi","optimization","tax-optimization","ENV",{"_123":124,"_125":126,"_127":128},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]