Glama
Sign In

StockFlow MCP Server

by twolven
GitHub
Python
MIT License
3
RedditDiscord
OverviewInspectSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Hosts the StockFlow MCP server code repository, allowing users to clone and access the implementation.

  • Provides a Python-based interface for retrieving and analyzing stock market data, supporting programmatic access to stock information, historical price data, and options analysis.

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
  1. Install dependencies:
pip install -r requirements.txt
  1. 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 }
  1. 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 }
  1. 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

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

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

  1. Features
    1. Stock Data
      1. Options Analysis
      2. Installation
        1. Usage
          1. Usage Prompt for Claude
            1. Running the Server
              1. Using with MCP Client
              2. Available Tools
                1. Available Resources
                  1. Prompts
                    1. Requirements
                      1. Limitations
                        1. Contributing
                          1. License
                            1. Author
                              1. Acknowledgments
                                1. Acknowledgments

                                  Related Resources