Content
# 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](https://documentation.tradier.com/brokerage-api) within [Claude Desktop](https://claude.ai/download).
## 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)
```json
{
"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
2. Highest Open Interest:
- $600 calls: 8,299 contracts
- $590 calls: 6,591 contracts
- $605 calls: 4,676 contracts
- $580 calls: 4,596 contracts
3. 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
2. 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
3. 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](https://nodejs.org/en/download)
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:
```json
{
"mcpServers": {
"options-chain": {
"command": "node",
"args": [
"/Full/Route/to/Folder/options-chain/build/index.js"
],
"env": {
"token": "your_sandbox_api_token_here"
}
}
}
}
```
3. 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`
Connection Info
You Might Also Like
valuecell
ValueCell is a community-driven, multi-agent platform for financial applications.
hexstrike-ai
HexStrike AI MCP Agents is an advanced MCP server that lets AI agents...
YC-Killer
A library of enterprise-grade AI agents designed to democratize artificial...
toon-java
☕ Community-driven Java implementation of TOON
beyond-mcp
It's time to push beyond MCP Servers... Right?
JToon
JToon is a compact format for structured data, optimizing token usage for...