Skip to main content
Glama
Stock Analysis MCP Server

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.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    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
      B
      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.
      1
      MIT