Skip to main content
Glama
AnasOsama2

Stock Analysis MCP Server

by AnasOsama2

Multi-Market Stock Analysis MCP Server 📈🌍

A defensible, filing-based Model Context Protocol (MCP) server for financial stock analysis supporting US (SEC EDGAR), Egypt (EGX/FRA), Dubai (DFM), and Abu Dhabi (ADX) markets.

Python MCP Markets License Docker


🏛️ Regional Market Adapters

Adapter Module

Supported Exchanges / Markets

Key Responsibilities

twelve_data_adapter

EGX, DFM, ADX, US Equities

Market quotes, symbol resolution, and exchange metadata

sec_edgar_adapter

SEC EDGAR (USA)

Official US 10-K/10-Q filing history and XBRL fact extraction

egx_disclosures_adapter

EGX / FRA (Egypt)

Egyptian Exchange announcements and financial statements (COMI, HRHO, ETEL)

dfm_disclosures_adapter

DFM (Dubai, UAE)

Dubai Financial Market disclosures and quarterly releases (EMAAR, DIB, DEWA)

adx_reports_adapter

ADX (Abu Dhabi, UAE)

Abu Dhabi Securities Exchange reports and releases (EAND, FAB, IHC)

regional_analysis_engine

Universal Multi-Currency (EGP, AED, USD)

Deterministic metric calculations and red-flag diagnostics


Related MCP server: Financial Datasets MCP Server

🛠️ Unified MCP Tools

Tool

Description

Key Arguments

resolve_company

Resolve symbol, CIK, or name across US, EGX, DFM, and ADX

query, market

list_disclosures

List recent disclosures, filing announcements, and regulatory releases

ticker_or_symbol, market, limit

get_financial_report

Return financial report metadata, summary, and direct document source links

ticker_or_symbol, market, period

extract_statement

Extract structured financial statement facts (Income, Balance, Cash Flow)

ticker_or_symbol, statement_type, market

calculate_profitability

Compute Net Income, Free Cash Flow (Operating Cash Flow - CapEx), Margins, EBITDA Proxy, SBC

ticker_or_symbol, market, period_type

compare_periods

Multi-period financial comparisons and YoY growth rates

ticker_or_symbol, metric, market, num_periods

detect_red_flags

Apply financial red-flag diagnostic tests (cash conversion, margin compression, receivables lag)

ticker_or_symbol, market

get_evidence

Return audit evidence, accession numbers/source IDs, filing URLs, and calculation traces

ticker_or_symbol, fact_tag, market


🚀 Quick Start (Docker)

# Build Docker image
docker build -t stock-analysis-mcp-server:latest .

# Run container interactively
docker run -i --rm stock-analysis-mcp-server:latest

💻 Configuration (mcp_config.json)

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

📄 License

This project is licensed under the MIT License.

Related MCP Connectors

Related MCP Servers

  • -
    license
    Not graded
    quality
    Not graded
    maintenance
    Enables deep analysis of SEC EDGAR filings through universal company search, document content extraction, and advanced filing search capabilities. Provides AI-ready access to business descriptions, risk factors, financial statements, and full-text search across any public company's SEC documents.
    -
  • A
    license
    A
    quality
    A
    maintenance
    An MCP server for SEC EDGAR written in Rust: company filings, full-text search, XBRL financials, insider transactions and company info. A single native binary; no API key.
    32
    14
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Provides free SEC filing fundamentals for US public companies, including financial statements, 10-K/10-Q summaries, and 8-K event histories. No API key or signup required.
    MIT