Related MCP Server Resources

Explore more AI models, providers, and integration options:

  • Explore AI Models
  • Explore AI Providers
  • Explore MCP Servers
  • LangDB Pricing
  • Documentation
  • AI Industry Blog
  • Alpha Vantage Stock Analysis MCP Server
  • SQL Query MCP Server
  • IR Toolshed MCP Server
  • Root Signals MCP Server
  • Vertex AI MCP Server
Back to MCP Servers
StockFlow MCP Server

StockFlow MCP Server

Public
twolven/mcp-stockflow

Provides real-time stock market data, historical prices, company financials, and comprehensive options analysis including Greeks and strategy evaluation via the Model Context Protocol for seamless LLM integration.

python
0 tools
May 29, 2025
Updated Jun 4, 2025

Supercharge Your AI with StockFlow MCP Server

MCP Server

Unlock the full potential of StockFlow MCP Server through LangDB's AI Gateway. Get enterprise-grade security, analytics, and seamless integration with zero configuration.

Unified API Access
Complete Tracing
Instant Setup
Get Started Now

Free tier available • No credit card required

Instant Setup
99.9% Uptime
10,000+Monthly Requests

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
Publicly Shared Threads0

Discover shared experiences

Shared threads will appear here, showcasing real-world applications and insights from the community. Check back soon for updates!

Share your threads to help others
Related MCPs5
  • Alpha Vantage Stock Analysis MCP Server
    Alpha Vantage Stock Analysis MCP Server

    Provides real-time and historical stock market data, customizable intraday and daily intervals, and ...

    3 tools
    Added May 30, 2025
  • SQL Query MCP Server
    SQL Query MCP Server

    Enables natural language querying of PostgreSQL databases by translating prompts into SQL via LLM in...

    Added May 30, 2025
  • IR Toolshed MCP Server
    IR Toolshed MCP Server

    Provides a Model Context Protocol (MCP) service offering advanced network incident response tools in...

    Added May 30, 2025
  • Root Signals MCP Server
    Root Signals MCP Server

    Bridges Root Signals API with Model Context Protocol clients to enable AI assistants and agents to p...

    Added May 30, 2025
  • Vertex AI MCP Server
    Vertex AI MCP Server

    Provides a Model Context Protocol server enabling advanced interaction with Google Cloud's Vertex AI...

    20 tools
    Added May 30, 2025