stock-mcp

Overview

Stock MCP is a comprehensive financial data service that provides both MCP and HTTP API interfaces. It offers market data for A-shares, US stocks, ETFs, indices, and cryptocurrencies, along with technical analysis, fundamentals, money flow analysis, news retrieval, and filing processing. The server features a modular architecture with capability and provider plugins, supports multiple authentication modes, and includes a proxy boundary for handling domestic and international data sources.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• get_kline_data

  Retrieve K-line/candlestick data for a given financial symbol

  Try:Get 6 months of K-line data for SSE:600519Try:Show me daily candlestick data for AAPL
• calculate_technical_indicators

  Calculate technical indicators like RSI, MACD, moving averages for a symbol

  Try:Calculate RSI and MACD for TSLATry:Get 20-day moving average for BTC-USD
• get_market_data

  Fetch market data including price, volume, and basic info for financial symbols

  Try:Get current market data for SSE:600519Try:Show me the latest price and volume for AAPL
• get_fundamental_data

  Retrieve fundamental and financial metrics for companies

  Try:Get P/E ratio and revenue for AAPLTry:Show me debt-to-equity ratio for MSFT
• get_money_flow

  Analyze money flow and chip distribution for financial instruments

  Try:Show money flow data for SSE:600519Try:Get institutional ownership for TSLA
• search_news

  Search financial news using Tavily's unified search

  Try:Find recent news about AppleTry:Search for information on Fed interest rate decisions
• get_filings

  Retrieve SEC/EDGAR filings or A-share company announcements

  Try:Get latest 10-K filing for AAPLTry:Find recent announcements for SSE:600519
• export_data

  Export financial data as CSV or JSON for code execution workflows

  Try:Export last 3 months of stock data for NVDA to CSVTry:Generate JSON file with technical indicators for TSLA

Note: Tool names inferred from MCP call example and described capabilities. The README describes functionality but doesn't explicitly list all tool names with complete signatures.

Comparable tools

Installation

git clone https://github.com/huweihua123/stock-mcp.git
cd stock-mcp
cp .env.example .env
docker compose up -d --build

uv sync --dev
cp .env.example .env
export STOCK_MCP_AUTH_MODE=none
uv run python -m uvicorn src.server.app:app --host 127.0.0.1 --port 9898

{
  "mcpServers": {
    "stock-mcp": {
      "command": "uv",
      "args": ["run", "python", "-c", "import src.server.mcp.server as m; m.create_mcp_server().run(transport='stdio')"],
      "env": {
        "STOCK_MCP_AUTH_MODE": "none"
      }
    }
  }
}

FAQ

What financial markets are supported?

The server supports A-shares (Chinese stocks), US stocks, ETFs, indices, and cryptocurrencies with market data, technical analysis, fundamentals, and news.

How can I authenticate with the server?

Three authentication modes are supported: none (for development), token (static Bearer token), and jwt (OIDC/JWT compatible for production).

Compare stock-mcp with