What is Mcp Stockflow

mcp-stockflow is a Model Context Protocol (MCP) server that provides real-time stock market data and options analysis through Yahoo Finance, enabling LLMs to access and analyze market data effectively.

Use cases

Use cases for mcp-stockflow include stock market analysis, options strategy evaluation, financial reporting, and integrating market data into trading algorithms.

How to use

To use mcp-stockflow, clone the repository from GitHub, install the required dependencies, and configure it in your Claude Desktop settings by adding it to the mcpServers section of your configuration file.

Key features

Key features of mcp-stockflow include real-time stock prices, historical price data, company fundamentals, complete options chain data, Greeks for options analysis, and tracking of volume and open interest.

Where to use

mcp-stockflow can be used in finance, investment analysis, trading applications, and any environment where real-time stock and options data is needed.

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 - (https://github.com/twolven)

Acknowledgments

Acknowledgments

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