StockFlow MCP Server

A Model Context Protocol (MCP) server providing real-time stock data and options analysis through Yahoo Finance. Enables LLMs to access market data, analyze stocks, and evaluate options strategies.

Features

Stock Data

• Real-time stock prices and key metrics
• Historical price data with OHLC values
• Company fundamentals and financial statements
• Market indicators and ratios

Options Analysis

• Complete options chain data
• Greeks (delta, gamma, theta, vega)
• Volume and open interest tracking
• Options strategy analysis

Installation

# Install dependencies
pip install mcp yfinance

# Clone the repository
git clone https://github.com/twolven/stockflow
cd stockflow

Usage

1. Clone the repository:

   git clone https://github.com/twolven/mcp-stockflow.git
   cd mcp-stockflow

2. Install dependencies:

   pip install -r requirements.txt

3. Add to your Claude configuration: In your claude-desktop-config.json, add the following to the mcpServers section:

{
    "mcpServers": {
        "stockflow": {
            "command": "python",
            "args": ["path/to/stockflow.py"]
        }
    }
}

Replace "path/to/stockflow.py" with the full path to where you saved the stockflow.py file.

Usage Prompt for Claude

When working with Claude, you can use this prompt to help it understand the available tools:

"I've enabled the stockflow tools which give you access to stock market data. You can use these three main functions:

1. get_stock_data - Get comprehensive stock info:

   {
       "symbol": "AAPL",
       "include_financials": true,  # optional
       "include_analysis": true,    # optional
       "include_calendar": true     # optional
   }

2. get_historical_data - Get price history and technical indicators:

   {
       "symbol": "AAPL",
       "period": "1y",        # 1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max
       "interval": "1d",      # 1m, 2m, 5m, 15m, 30m, 60m, 90m, 1h, 1d, 5d, 1wk, 1mo, 3mo
       "prepost": false       # optional - include pre/post market data
   }

3. get_options_chain - Get options data:

   {
       "symbol": "AAPL",
       "expiration_date": "2024-12-20",  # optional - uses nearest date if not specified
       "include_greeks": true            # optional
   }

All responses include current price data, error handling, and comprehensive market information."

Running the Server

python stockflow.py

Using with MCP Client

from mcp import ClientSession, StdioServerParameters
from mcp.client.stdio import stdio_client

server_params = StdioServerParameters(
    command="python",
    args=["stockflow.py"]
)

async def run():
    async with stdio_client(server_params) as (read, write):
        async with ClientSession(read, write) as session:
            await session.initialize()

            # Get current stock data
            result = await session.call_tool(
                "get-stock-data", 
                arguments={"symbol": "AAPL"}
            )

            # Get options chain
            options = await session.call_tool(
                "get-options-chain",
                arguments={
                    "symbol": "AAPL",
                    "expiration_date": "2024-12-20"
                }
            )

if __name__ == "__main__":
    import asyncio
    asyncio.run(run())

Available Tools

1. get-stock-data - Current price and volume - Market cap and P/E ratio - 52-week high/low

2. get-historical-data - OHLC prices - Configurable time periods - Volume data

3. get-options-chain - Calls and puts - Strike prices - Greeks and IV - Volume and open interest

Available Resources

1. company-info://{symbol} - Company description - Sector and industry - Employee count - Website

2. financials://{symbol} - Income statement - Balance sheet - Cash flow statement

Prompts

1. analyze-options - Options strategy analysis - Risk/reward evaluation - Market condition assessment

Requirements

• Python 3.12+
• mcp
• yfinance

Limitations

• Data is sourced from Yahoo Finance and may have delays
• Options data availability depends on market hours
• Rate limits apply based on Yahoo Finance API restrictions

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Author

Todd Wolven - Lead AI Software Developer and open-source GenAI engineer

Acknowledgments

• Built with the Model Context Protocol (MCP) by Anthropic
• Data provided by Yahoo Finance
• Developed for use with Anthropic's Claude