home / mcp / options chain mcp server

Options Chain MCP Server

Provides access to Tradier Sandbox options chain data and historical prices via MCP for stocks and contracts.

Installation
Add the following to your MCP client configuration file.

Configuration

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

This MCP server provides access to Tradier Sandbox API data for options chains and historical prices. It enables you to query options data for a specific stock and expiration, filter for calls or puts, focus on meaningful strike levels, and retrieve historical price information, all through an MCP client like Claude Desktop.

How to use

You use this MCP server by connecting it to your MCP client and issuing queries to retrieve options chains and historical prices. The server filters data to keep the context focused, highlights key strikes, and returns results that help you analyze potential price movement and hedging activity. You can query for both calls and puts, specify an expiration, and request historical price ranges for stocks or option contracts.

Typical usage patterns include asking for the options chain two weeks out for a given symbol, requesting only calls or only puts, and requesting historical prices over a chosen date range. The server is designed to run with a Tradier sandbox API token and will return relevant data that you can inspect and use in your analysis.

How to install

Prerequisites you need before installing this MCP server:

- Node.js installed on your machine

Installation steps you should follow step by step:

# 1. Install Node.js (if not already installed)
# 2. Clone the project to a folder on your machine
# 3. Install dependencies
npm install
# 4. Build the server (if you plan to modify the source)
npm run build
# 5. Start the server (the final command you will run in Claude Desktop)
#    or configure Claude Desktop to run the provided stdio command

Configuration and running notes

This MCP server uses a local stdio-based runtime. You run it by starting Node and pointing to the built entry file. The following configuration snippet shows how Claude Desktop can launch the server.

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

Notes on usage and data sources

- The server relies on Tradier Sandbox API access; you must provide a sandbox token to retrieve data.

- Sandbox market data is delayed by 15 minutes, and results are intended for informational analysis.

Troubleshooting and tips

If you encounter startup issues, ensure the full path to the Node binary is used in the command. For example, on macOS you might specify "/usr/local/bin/node" in your startup configuration.

If you need to modify the server, you can change the source in the project and rebuild before starting again. After making changes, restart the MCP client (Claude Desktop) to reload the server.

Connecting with Claude Desktop

Use the following example to configure Claude Desktop to run the MCP server. Add a configuration block for the server under mcpServers in your client settings.

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

Security and data handling

Keep your sandbox API token secure and do not share it in unsecured channels. The MCP server will use this token to access the Tradier Sandbox API for data retrieval.

Available tools

find-options-chain

Retrieves the options chain for a specific stock symbol and expiration, with filters for calls/puts and strike ranges.

find-historical-prices

Fetches historical price data for a stock or option contract within a given time range.