Stockflow (Yahoo Finance)

🚀 StockFlow MCP Server

A Model Context Protocol (MCP) server that provides real-time stock data and options analysis through Yahoo Finance. It enables Large Language Models (LLMs) to access market data, analyze stocks, and evaluate options strategies.

✨ Features

Stock Data

• Real-time stock prices and key indicators
• Historical price data and 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 Examples

Basic 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 Claude configuration: Add the following to the mcpServers section of your claude-desktop-config.json file:

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

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

Advanced Usage

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

“ I have enabled the stock data tools, which allow you to access stock market data. You can use these three main functions:

1. get_stock_data - Get comprehensive stock information:

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

2. get_historical_data - Get price history and technical indicators:

{
    "symbol": "AAPL",
    "start_date": "2024-01-01",  # Start date
    "end_date": "2024-12-31"     # End date
}

3. analyze_options - Conduct options analysis:

{
    "symbol": "AAPL",
    "option_type": "call",  # Optional: call or put
    "strike_price": 150      # Strike price
}

Example Conversation

User Input:

{
    "messages": [
        {
            "role": "user",
            "content": "Help me analyze Apple's stock options."
        }
    ],
    "model": "claude-3-opus-20240129"
}

Claude's Response:

{
    "messages": [
        {
            "role": "assistant",
            "content": "Sure, please provide the following information for options analysis:\n1. Option type (call or put)\n2. Strike price\n3. Other relevant parameters (e.g., expiration date, volatility). "
        }
    ]
}

📚 Documentation

Available Tools

• get_stock_data - Get real-time and historical information about stocks.
• get_historical_data - Analyze stock price trends over a specific period.
• analyze_options - Evaluate the risks and potential returns of options strategies.

Resources

Prompts

1. analyze_options - Conduct options strategy analysis, evaluate risk/reward, and assess the impact of market conditions.

🔧 Technical Details

Requirements

• Python 3.12+
• mcp
• yahoo-finance

Limitations

• Data is sourced from Yahoo Finance and may have delays.
• Options data availability depends on market trading hours.
• Subject to Yahoo Finance API rate limits.

🤝 Contribution

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

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