options-chain-mcp

Claude MCP server for Tradier Sandbox API options chain endpoint and historical prices endpoint.

An MCP server implementation for providing access to the Tradier Sandbox API within Claude Desktop.

Overview

This Model Context Protocol (MCP) server enables AI assistants and applications to:

• Get options chain data for a specific stock and expiration date
• Filter for only call or put options, or both as default
• Filter for a percentage range around the current price
• Automatically filters for significant strikes to limit context size
• Get historical prices for a specific stock or option contract in a given time range
• Look up valid option expiration dates for a given symbol

The server can run two ways:

• Locally over stdio for Claude Desktop (the original setup)
• Remotely on Cloudflare Workers for Claude.ai web / desktop via the custom connector UI

Please note:

• Requires Tradier account and sandbox API access token
• Sandbox API market data is delayed by 15 minutes
• Intended for informational purposes only

Users can run queries using natural language.

Sample Output

Q: What are the highlights of the SPY options chain for two weeks out?

A: I'll check the current SPY options chain for two weeks out from today.

View Result from find-options-chain from options-chain (local)

{
  "symbol": "SPY",
  "expiration": "2025-03-28"
}

Now that I have the SPY options chain for March 28, 2025 (two weeks out), I'll highlight the key information:

SPY Options Chain Highlights (March 28, 2025 Expiration)

Current Market Context

Current SPY price appears to be around $565-566 based on the at-the-money options

Call Options Highlights

1. Highest Volume:

• $590 calls with 217 contracts traded
• $600 calls with 174 contracts traded
• $571 calls with 130 contracts traded

1. Highest Open Interest:

• $600 calls: 8,299 contracts
• $590 calls: 6,591 contracts
• $605 calls: 4,676 contracts
• $580 calls: 4,596 contracts

1. Notable Activity:

• Far out-of-the-money calls ($590-$600) showing significant volume, suggesting some traders are positioning for potential upside movement
• The $590 calls (priced at $1.07-$1.09) have high volume and open interest

Put Options Highlights

1. Highest Volume:

• $500 puts with 217 contracts traded
• $460 puts with 160 contracts traded
• $510 puts with 163 contracts traded

1. Highest Open Interest:

• $525 puts: 79,196 contracts (extremely high)
• $530 puts: 7,060 contracts
• $550 puts: 4,883 contracts
• $570 puts: 4,337 contracts

1. Notable Activity:

• The massive open interest in $525 puts is striking, suggesting a significant hedging position
• Overall put activity shows traders protecting against downside risk

Implied Volatility Indicators

• Looking at the pricing, implied volatility appears moderate
• The put-call ratio based on open interest is skewed toward puts, suggesting market participants are hedging against downside risk

Options Skew

• There's higher open interest in OTM puts than OTM calls, indicating traders are more concerned about downside protection than upside speculation

Installation

Installing this might be tricky if you're not familiar with Node.js and the MCP protocol.

1. Install Node.js
2. Clone this repository to a folder on your local machine
3. The server is already built so you can skip the build step.

Extra Steps

If you want to make changes to the server you can do so by editing the src/index.ts file.

• Run npm install to install dependencies
• Run npm run build to build the server
• Quit and restart Claude Desktop after making changes

Connecting with Claude Desktop

1. Open your Claude Desktop configuration at:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Add the server configuration:

{
    "mcpServers": {
        "options-chain": {
            "command": "node",
            "args": [
                "/Full/Route/to/Folder/options-chain/build/index.js"
            ],
            "env": {
                "token": "your_sandbox_api_token_here"
            }
        }
    }
}

1. Close/Quit then restart Claude Desktop

Once you restart you should see a small hammer icon in the lower right corner of the textbox. If you hover over the icon you'll see the number of MCP tools available.

The token env var is still accepted for backward compatibility. New installs should prefer TRADIER_TOKEN.

Running on Cloudflare Workers

The Worker entrypoint (src/worker.ts) exposes the same tools over MCP's Streamable HTTP / SSE transports, so Claude.ai (web and desktop) can connect to it as a custom remote connector.

Requirements

• A Cloudflare account on any paid Workers plan (the Durable Object that backs MCP session state requires paid)
• Wrangler authenticated: npx wrangler login

Configure secrets

npx wrangler secret put TRADIER_TOKEN     # your Tradier sandbox token
npx wrangler secret put MCP_AUTH_TOKEN    # any long random string, e.g. `openssl rand -hex 32`

For local dev, put the same two keys in a .dev.vars file at the repo root (gitignored).

Deploy

npm run dev       # local dev server with hot reload
npm run deploy    # publish to <name>.<account>.workers.dev

Connect Claude to the deployed server

In Claude.ai → Settings → Connectors → Add custom connector:

• URL: https://<your-worker>.workers.dev/sse (use /mcp if your client uses Streamable HTTP instead of SSE)
• Custom header: Authorization: Bearer <the MCP_AUTH_TOKEN you set above>

Any request without that header is rejected with a 401, so the Worker is safe to leave public.

Auth upgrade path

For multi-user access or SSO, put Cloudflare Access in front of the Worker route — no code changes needed. The existing bearer check becomes a harmless second layer.

Troubleshooting

If you get errors when running the server you may need to provide the full path to the node command. For example, on macOS: /usr/local/bin/node