StockFlow

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.

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

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

# Install dependencies pip install mcp yfinance # Clone the repository git clone https://github.com/twolven/stockflow cd stockflow

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

- Add to your Claude configuration: In yourclaude-desktop-config.json, add the following to themcpServerssection:

{ "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.

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:
- get_stock_data- Get comprehensive stock info:

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

- 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 }

{ "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."

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())

- Current price and volume
- Market cap and P/E ratio
- 52-week high/low

- OHLC prices
- Configurable time periods
- Volume data

- Calls and puts
- Strike prices
- Greeks and IV
- Volume and open interest

- Company description
- Sector and industry
- Employee count
- Website

- Income statement
- Balance sheet
- Cash flow statement
- analyze-options

- Options strategy analysis
- Risk/reward evaluation
- Market condition assessment

- 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

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

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

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

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

Access real-time Binance cryptocurrency market data, including prices, order books, and trading history.