StockFlow

Stock market data provider for Claude Desktop using MCP

python

22

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "twolven-mcp-stockflow": {
      "command": "python",
      "args": [
        "stockflow.py"
      ]
    }
  }
}

StockFlow MCP Server provides real-time stock data and options analysis through Yahoo Finance, enabling large language models to access market information and evaluate investment strategies with actionable tools.

How to use

You interact with StockFlow through an MCP client to access stock data, historical prices, and options analysis. Use the three main tools to get current data, price history, and options chains, then combine them to build trading insights or evaluate strategies in real time.

How to install

Prerequisites you need before installing: Python 3.12 or newer. Make sure you have a working Python environment and pip available.

Install core dependencies needed by the server and client tooling.

Install the MCP framework and Yahoo data adapter library.

Additional sections

Configuration and running details are provided below. Follow the commands exactly as shown to ensure proper startup and MCP integration.

# Install Python dependencies
pip install mcp yfinance

# Clone the StockFlow MCP server repository
git clone https://github.com/twolven/mcp-stockflow.git
cd mcp-stockflow

# Install Python requirements for the server
pip install -r requirements.txt

# Run the server (available as a local stdio server)
python stockflow.py

Available tools

get-stock-data

Returns current price, volume, market cap, P/E ratio, and 52-week high/low for a given symbol.

get-historical-data

Provides OHLC prices and volume data over configurable periods with technical indicators.

get-options-chain

Retrieves options data including calls/puts, strike prices, Greeks, IV, and volume/open interest.