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
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
- Highest Volume:
- $590 calls with 217 contracts traded
- $600 calls with 174 contracts traded
- $571 calls with 130 contracts traded
- Highest Open Interest:
- $600 calls: 8,299 contracts
- $590 calls: 6,591 contracts
- $605 calls: 4,676 contracts
- $580 calls: 4,596 contracts
- 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
- Highest Volume:
- $500 puts with 217 contracts traded
- $460 puts with 160 contracts traded
- $510 puts with 163 contracts traded
- 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
- 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.
- Install Node.js
- Clone this repository to a folder on your local machine
- 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
- Open your Claude Desktop configuration at:
* macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
* Windows: `%APPDATA%\Claude\claude_desktop_config.json`
- 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"
}
}
}
}
- 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.
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
