Stock Analysis MCP Server 📈

A defensible, filing-based Model Context Protocol (MCP) server for financial stock analysis of U.S. public companies powered by SEC EDGAR REST APIs and XBRL facts datasets.

🌟 Features

• Zero API Keys Required: Queries the official, free, and public SEC EDGAR REST APIs directly.

• Deterministic Metric Engine: Calculates Net Income, Free Cash Flow (Operating Cash Flow - CapEx), Operating Margin, Net Margin, EBITDA Proxy, and Stock-Based Compensation intensity with complete calculation traces.

• Red-Flag Diagnostic Engine: Automatically flags cash conversion divergence, margin compression, receivables growing faster than revenue, and SBC share dilution.

• SEC Audit Evidence: Direct links to SEC filings, 10-K/10-Q documents, and accession numbers.

• FastMCP Compliant: Built strictly following MCP standards (single-line docstrings, stdio transport, formatted output).

Related MCP server: Financial Datasets MCP Server

🛠️ Exposed MCP Tools

🚀 Quick Start (Docker)

1. Build the Container Image

docker build -t stock-analysis-mcp-server:latest .

2. Add to your MCP Client Configuration

In your claude_desktop_config.json or mcp_config.json:

{
  "mcpServers": {
    "stock_analysis": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "stock-analysis-mcp-server:latest"
      ]
    }
  }
}

💻 Local Development (Without Docker)

Installation

pip install -r requirements.txt

Run Server

python stock_analysis_server.py

📄 License

This project is licensed under the MIT License.