MCP Trader Server

A Model Context Protocol (MCP) server for stock traders.

Features

Tools

The server provides the following tools for stock analysis and trading:

• analyze-stock: Performs technical analysis on a given stock symbol

  • Required argument: symbol (string, e.g. "NVDA")

  • Returns comprehensive technical analysis including:

    • Moving average trends (20, 50, 200 SMA)

    • Momentum indicators (RSI, MACD)

    • Volatility metrics (ATR, ADRP)

    • Volume analysis

• relative-strength: Calculates a stock's relative strength compared to a benchmark

  • Required argument: symbol (string, e.g. "AAPL")

  • Optional argument: benchmark (string, default: "SPY")

  • Returns relative strength metrics across multiple timeframes (21, 63, 126, 252 days)

  • Includes performance comparison between the stock and benchmark

• volume-profile: Analyzes volume distribution by price

  • Required argument: symbol (string, e.g. "MSFT")

  • Optional argument: lookback_days (integer, default: 60)

  • Returns volume profile analysis including:

    • Point of Control (POC) - price level with highest volume

    • Value Area (70% of volume range)

    • Top volume price levels

• detect-patterns: Identifies chart patterns in price data

  • Required argument: symbol (string, e.g. "AMZN")

  • Returns detected chart patterns with confidence levels and price targets

• position-size: Calculates optimal position size based on risk parameters

  • Required arguments:

    • symbol (string, e.g. "TSLA")

    • stop_price (number)

    • risk_amount (number)

    • account_size (number)

  • Optional argument: price (number, default: current price)

  • Returns recommended position size, dollar risk, and potential profit targets

• suggest-stops: Suggests stop loss levels based on technical analysis

  • Required argument: symbol (string, e.g. "META")

  • Returns multiple stop loss suggestions based on:

    • ATR-based stops (1x, 2x, 3x ATR)

    • Percentage-based stops (2%, 5%, 8%)

    • Technical levels (moving averages, recent swing lows)

Technical Analysis Capabilities

The server leverages several specialized analysis modules:

• TechnicalAnalysis: Core technical indicators and trend analysis

  • Moving averages (SMA 20, 50, 200)

  • Momentum indicators (RSI, MACD)

  • Volatility metrics (ATR, Average Daily Range Percentage)

  • Volume analysis (20-day average volume)

• RelativeStrength: Comparative performance analysis

  • Multi-timeframe relative strength scoring (21, 63, 126, 252 days)

  • Performance comparison against benchmark indices

  • Outperformance/underperformance classification

• VolumeProfile: Advanced volume analysis

  • Price level volume distribution

  • Point of Control (POC) identification

  • Value Area calculation (70% of volume)

• PatternRecognition: Chart pattern detection

  • Support/resistance levels

  • Common chart patterns (head and shoulders, double tops/bottoms, etc.)

  • Confidence scoring for detected patterns

• RiskAnalysis: Position sizing and risk management

  • Risk-based position sizing

  • Multiple stop loss strategies

  • R-multiple profit target calculation

Data Sources

The server uses the Tiingo API for market data:

• Historical daily OHLCV data

• Adjusted prices for accurate backtesting

• Up to 1 year of historical data by default

Setup

Prerequisites

• Python 3.11+

• uv

• ta-lib

• Tiingo API Key

Environment Variables

Create a .env file:

Installing via Smithery

To install Trader for Claude Desktop automatically via Smithery:

This will:

1. Install the MCP Trader server

2. Configure it with your Tiingo API key

3. Set up the Claude Desktop integration

Smithery Configuration

The server includes a smithery.yaml configuration file that defines:

• Required configuration parameters (Tiingo API key)

• Command function to start the MCP server

• Integration with Claude Desktop

You can customize the Smithery configuration by editing the smithery.yaml file.

Installation

Docker Deployment

The project includes a Dockerfile for containerized deployment:

To run the container in HTTP server mode:

Configuration

Claude Desktop App

On MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json

On Windows: %APPDATA%/Claude/claude_desktop_config.json

Development Configuration:

Development

Build and Run

HTTP Server Mode

The server can also run as a standalone HTTP server for testing or integration with other applications:

This starts an HTTP server on http://localhost:8000 with the following endpoints:

• GET /list-tools: Returns a list of available tools and their schemas

• POST /call-tool: Executes a tool with the provided arguments

  • Request body format:

    { "name": "analyze-stock", "arguments": { "symbol": "AAPL" } }

  • Returns an array of content items (text, images, etc.)

Debugging

Use the MCP Inspector for debugging:

Example Usage

In Claude Desktop:

The server will return a technical analysis summary including trend status, momentum indicators, and key metrics.

Dependencies

See pyproject.toml for full dependency list:

Contributing

Contributions to MCP Trader are welcome! Here are some ways you can contribute:

• Add new tools: Implement additional technical analysis tools or trading strategies

• Improve existing tools: Enhance the accuracy or performance of current tools

• Add data sources: Integrate additional market data providers

• Documentation: Improve the documentation or add examples

• Bug fixes: Fix issues or improve error handling

Development Workflow

1. Fork the repository

2. Create a feature branch (git checkout -b feature/amazing-feature)

3. Commit your changes (git commit -m 'Add some amazing feature')

4. Push to the branch (git push origin feature/amazing-feature)

5. Open a Pull Request

Future Plans

The MCP Trader project has several planned enhancements:

• Portfolio Analysis: Tools for analyzing and optimizing portfolios

• Backtesting: Capabilities to test trading strategies on historical data

• Sentiment Analysis: Integration with news and social media sentiment data

• Options Analysis: Tools for analyzing options strategies and pricing

• Real-time Data: Support for real-time market data feeds

• Custom Strategies: Framework for implementing and testing custom trading strategies

• Alerts: Notification system for price and technical indicator alerts

Further Reading

Learn more about this project through these detailed blog posts:

• Building a Stock Analysis Server with MCP, Part 1 - Initial setup, architecture, and core technical analysis features

• Building a Stock Analysis Server with MCP, Part 2 - Relative Strength, Volume, Pattern Recognition, Risk analysis