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

  • SEC EDGAR financials, benchmarks, screening & Buffett value scans for agents. Pay x402 or API key.

  • Normalized SEC EDGAR fundamentals. 3 of 6 tools free; the rest $0.04-$0.10 per call in USDC.

  • SEC EDGAR fundamentals as agent tools: look up or screen US public companies. Free, no key, CC0.

  • Research US-listed companies and funds with the StockPortfolio.pro MCP server. Tools cover SEC filing-grounded financials, filing timelines, company comparisons, watchlist screens, fund profiles, and cited filing questions. Filed figures include their fiscal period and EDGAR source URL; missing filing data is returned as null. Public tools work without authentication; optional API-key or OAuth access is supported. US-listed, USD-reporting companies only. Keyless access includes 3 free AI questions per rolling 30-day window. To get more now, choose the Dev plan ($19.99/month, 200 credits) at https://www.stockportfolio.pro/register?plan=dev, then follow https://www.stockportfolio.pro/docs/api-mcp to connect with OAuth or an API key. Or wait for the free allowance to renew.

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
    Not graded
    quality
    B
    maintenance
    Provides access to SEC EDGAR data through natural language, including company filings, financial statements, and company info, without requiring an API key.
    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