Stock MCP Server

# Stock MCP Server

An MCP (Model Context Protocol) server that gives Claude access to accurate, free stock-market data — quotes, fundamentals, history, news, index top-10 rankings, market movers, and penny-stock screens. All data comes from public sources (Yahoo Finance via yfinance, plus Wikipedia/Slickcharts for index membership). No API keys, no paid subscriptions.

Tools

Related MCP server: Yahoo Finance MCP Server

Run with Docker (recommended)

The server runs as a Streamable HTTP MCP server on port 8200:

cd "D:\Local Development\Stock MCP Server"
docker compose up -d --build

The MCP endpoint is then http://localhost:8200/mcp.

• Logs: docker logs stock-mcp

• Stop: docker compose down

• Change the port: edit MCP_PORT and the ports mapping in docker-compose.yml (host and container side).

Use with Claude Code

A project-scoped .mcp.json is already included and points at the Docker endpoint (http://localhost:8200/mcp) — start the container, open Claude Code in this directory, and approve the stock-info server when prompted.

Use with Claude Desktop

Add this to %APPDATA%\Claude\claude_desktop_config.json under "mcpServers" (with the container running):

{
  "mcpServers": {
    "stock-info": {
      "type": "http",
      "url": "http://localhost:8200/mcp"
    }
  }
}

Then restart Claude Desktop. (If your Claude Desktop version doesn't support HTTP servers directly, use the stdio setup below instead.)

Run without Docker (stdio, local)

cd "D:\Local Development\Stock MCP Server"
python -m venv .venv
.\.venv\Scripts\python.exe -m pip install -r requirements.txt

# Run on stdio (default transport)
.\.venv\Scripts\python.exe server.py

Stdio Claude Desktop config:

{
  "mcpServers": {
    "stock-info": {
      "command": "D:\\Local Development\\Stock MCP Server\\.venv\\Scripts\\python.exe",
      "args": ["D:\\Local Development\\Stock MCP Server\\server.py"]
    }
  }
}

Environment variables: MCP_TRANSPORT (stdio default, or streamable-http), MCP_HOST (default 0.0.0.0), MCP_PORT (default 8200).

Notes & limitations

• Data is sourced from Yahoo Finance's public endpoints via the yfinance library. It is delayed/indicative, subject to Yahoo's rate limits, and not suitable for trading execution. This server provides information only, not investment advice.

• Index constituent lists are scraped from Wikipedia (S&P 500/100, Dow) and Slickcharts (Nasdaq-100) and cached for 24 hours. If a page layout changes, get_top_stocks / list_index_constituents may need a source update in INDEX_SOURCES in server.py.

• get_top_stocks with rank_by="market_cap" makes one lightweight request per constituent (threaded), so the S&P 500 takes ~15–30 seconds; the S&P 100 and Dow are fast.