Stock Analysis MCP Server
Provides financial stock analysis for U.S. public companies via SEC EDGAR APIs, offering tools to resolve companies, retrieve filings, calculate profitability metrics, compare periods, detect red flags, and get audit evidence, all without API keys.
README
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.
🏛️ 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 |
🛠️ 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.
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.