Tastytrade MCP Server

A server that provides access to Tastytrade historical price data via the Model Context Protocol (MCP).

Prerequisites

• Tastytrade credentials (Client Secret, Refresh Token)
• uv (Python package manager)

Installation

This project uses uv to manage dependencies and ensure a consistent environment for all users.

1. Clone the repository and navigate to the directory.

2. Install the dependencies:

   uv sync
   

   This will create a .venv directory with the exact versions specified in uv.lock.

Configuration

It is not recommended to store credentials directly in your MCP client configuration file. Instead, this server is configured to load them automatically from the .env file located in the same directory as the script.

1. Ensure you have created your .env file with your credentials:

   cp .env.example .env
   # Edit .env with your actual details
   

2. Configure your MCP client (e.g., claude_desktop_config.json) with the command to run the server.

{
  "mcpServers": {
    "tastytrade": {
      "command": "/home/username/.pyenv/versions/data/bin/python",
      "args": [
        "/home/username/Desktop/projects/mcp_tasty/tastytrade_server.py"
      ]
    }
  }
}

Note: Since dependencies are now managed by the project, point the command to the .venv python if you want to use the lockfile environment, or just use uv as the command.

Recommended Configuration (using uv):

{
  "mcpServers": {
    "tastytrade": {
      "command": "uv",
      "args": [
        "run",
        "/home/username/Desktop/projects/mcp_tasty/tastytrade_server.py"
      ]
    }
  }
}

Available Tools

• get_price_history(symbol, days=7, interval='1d'): Get historical candle data for a symbol (e.g., "SPY").

Testing

To run the test client using the project environment:

uv run test_client.py