Analytics
souqdata.com
Provides financial data and metrics for GCC-listed companies, including company details, statements, stock prices, and key ratios.
ENDPOINT 1
https://souqdata.com/api/v1/mcp
MCP server metadata
- Name
- souqdata-mcp
- Version
- 1.0.0
Known tools 131
get_financialsGet financial statements (income, balance sheet, cash flow) for a company.
Inferred read-onlyget_metricsGet financial metrics/ratios for a company: PE, ROE, margins, yields, growth rates.
Inferred read-onlyget_management_teamGet the executive management team (CEO, CFO, etc.) for a company.
Inferred read-onlyget_exchange_infoGet information about a GCC exchange: company count, sectors, governance code.
Inferred read-onlyget_fair_valueGet multi-model fair value estimate for a company (DCF, DDM, EV/EBITDA).
Inferred read-onlyget_macro_exposureGet oil price, USD peg, and cyclicality sensitivity for a GCC company.
Inferred read-onlyget_alpha_scoreGet composite Alpha Score (0-100) combining governance, insider, credibility, quality, and dividend signals.
Inferred read-onlyget_succession_riskGet board succession planning analysis — retirement pressure, skills gaps, diversity shortfalls, tenure risk.
Inferred read-onlyget_conflictsDetect director conflicts of interest — cross-directorships, overboarded directors, conglomerate overlaps, insider trading flags.
Inferred read-onlyget_disclosure_languageAnalyse disclosure language style — transparency, specificity, forward-looking, hedging, readability dimensions.
Inferred read-onlyget_oci_divergenceGet OCI divergence signal — gap between net income and comprehensive income revealing hidden FX/revaluation risks.
Inferred read-onlyget_chair_performanceGet chair performance benchmarking score across 6 dimensions for a company.
Inferred read-onlyget_chair_ceo_lisGet Language Intelligence Score (LIS) for board chairs and CEOs — measures communication quality across 7 dimensions: sentiment, conviction, transparency, forward-looking orientation, readability, topic diversity, and uncertainty management.
Inferred read-onlyget_valuation_consensusGet multi-method valuation consensus — DCF, DDM, EV/EBITDA, and analyst targets blended into a single view.
Inferred read-onlyget_signal_fusionGet active composite signals — multi-factor alerts combining insider trades, governance changes, earnings shifts.
Inferred read-onlyoptimize_portfolioRun portfolio optimization (MVO, Black-Litterman, or HRP) on a set of GCC tickers.
Inferred read-onlyget_royal_family_board_presenceGet ruling family board presence across GCC-listed companies.
Inferred read-onlyget_sovereign_linksGet sovereign wealth fund and state ownership/control links for GCC companies.
Inferred read-onlyget_nationalization_complianceGet workforce nationalization compliance data for a GCC company — Nitaqat (Saudi), Emiratization (UAE), Omanization, Qatarization, Bahrainization, Jordanization.
Inferred read-onlyget_board_certificationsGet governance certification data for GCC directors — GCC BDI, Hawkamah, DIFC IoD, CMA, IFC, AICD certifications.
Inferred read-onlyget_ir_briefingGet a structured IR briefing for a GCC company with governance, board composition, sentiment, ownership, insider activity, and change detection flags.
Inferred read-onlysimulate_investor_qaGenerate the 10 hardest investor questions for a GCC company using AI.
Inferred read-onlyanalyse_ir_draftAnalyse a draft announcement for language risks, sentiment prediction, media pickup probability, readability, buzzword detection, and likely analyst follow-up questions.
Inferred read-onlyget_deal_insider_signalsDetect pre-deal insider trading patterns by cross-referencing insider trades with capital raises.
Inferred read-onlyget_cma_complianceAssess a Tadawul (TDWL) listed company against Saudi CMA Corporate Governance Regulations (2017, amended 2023).
Inferred read-onlyget_social_sentimentGet combined news + social media sentiment for a GCC company (last 30 days).
Inferred read-onlyget_investment_profileGet 5-axis investment profile radar for a GCC company: Value, Growth, Profitability, Safety, Momentum.
Inferred read-onlyget_governance_v2Get Governance Risk Score v2 with 5 diagnostic sub-scores: Board Quality, Leadership, Oversight, Accountability, Transparency.
Inferred read-onlyget_insider_clustersDetect coordinated insider trading patterns for a GCC company.
Inferred read-onlyget_technical_signalsGet technical analysis indicators for a GCC stock: RSI(14), MACD(12/26/9), SMA(20/50/200), Bollinger Bands, volume ratio.
Inferred read-onlyget_portfolio_summaryGet portfolio overview with holdings, P&L, allocation breakdown, and total value.
Inferred read-onlyget_broker_activityQuery broker trading data from Tadawul (Saudi Exchange) monthly member activity reports.
Inferred read-onlyget_broker_flow_summaryGet aggregated broker flow metrics from v_broker_flow_summary view.
Inferred read-onlyget_ubo_analysisAnalyze ultimate beneficial ownership of a GCC company — trace ownership through nominees, custodians, and holding companies to identify true beneficial owners.
Inferred read-onlyscreen_pepScreen a person for Politically Exposed Person (PEP) status — checks ruling family, SWF, government, regulatory, and merchant family connections.
Inferred read-onlyget_accounting_qualityGet accounting quality score for a company — accrual ratio, cash conversion, revenue quality, earnings persistence, audit opinion risk.
Inferred read-onlyget_auditor_qualityGet auditor quality analysis — Big4 vs mid-tier, tenure, fee ratio, opinion history, KAM count, partner rotation.
Inferred read-onlyget_dividend_safetyGet dividend safety score (0-100) — payout ratio, coverage, streak, growth, free cash flow coverage, earnings stability.
Inferred read-onlyget_earnings_surprisePredict earnings surprise probability — 8-factor beat/miss model using insider activity, sentiment, governance, and financial trends.
Inferred read-onlyget_financial_distressGet financial distress scores — Altman Z-Score, Piotroski F-Score, Beneish M-Score, interest coverage, debt service.
Inferred read-onlyget_esg_compositeGet CESG composite ESG score (0-100) — environmental, social, governance sub-scores with evidence-based methodology.
Inferred read-onlyget_board_health_v2Get enhanced board health score (21-factor): Composition (6), Effectiveness (5), Stability (5), Experience (4), Transparency (2).
Inferred read-onlyget_greenwashing_riskDetect greenwashing risk — compares ESG narrative claims against actual evidence.
Inferred read-onlyget_annual_report_qualityScore annual report disclosure quality (0-100) across 5 dimensions — completeness, transparency, timeliness, readability, compliance.
Inferred read-onlyget_voting_qualityGet voting quality score — AGM participation rates, resolution pass rates, contested votes, minority protection indicators.
Inferred read-onlyget_shareholder_rightsGet shareholder rights score (0-100) — 6 components: voting rights, minority protection, disclosure, dividend policy, pre-emption, AGM access.
Inferred read-onlyget_corporate_riskGet composite corporate risk score combining governance, financial distress, regulatory, audit, and market signals into a single risk rating.
Inferred read-onlyget_regulatory_complianceGet multi-regulator compliance assessment — evaluates company against applicable governance code (SCA, CMA, QFMA, CBB, JSC).
Inferred read-onlyget_board_effectivenessGet board effectiveness score — composite of meeting attendance, tenure balance, turnover stability, and meeting frequency.
Inferred read-onlyget_director_pipelinePredict upcoming board vacancies — identifies directors near term limits, retirement age, or ending appointments.
Inferred read-onlyget_earnings_surprise_historyGet earnings surprise beat/miss history — tracks which companies consistently beat or miss YoY earnings expectations.
Inferred read-onlyget_dividend_cut_probabilityGet dividend cut probability (0-100%) — model based on payout ratio stress, FCF coverage, earnings trajectory, debt load, and cut history.
Inferred read-onlyget_governance_momentumGet governance score momentum — compares current vs previous financial year governance scores, identifies improving or declining trends.
Inferred read-onlyget_board_diversityGet board diversity analysis — gender representation, age distribution, international experience, and peer comparison.
Inferred read-onlyget_ceo_succession_riskGet CEO succession risk score — tenure concentration, age risk, deputy/COO presence, and CEO-chair separation.
Inferred read-onlyget_auditor_rotationGet auditor rotation status — years since last rotation, overdue flags, Big 4 status, and non-audit fee ratio.
Inferred read-onlyget_rpt_analysisGet related party transaction analysis — RPT materiality (% of revenue), concentration, ruling family involvement, and recurring transaction patterns.
Inferred read-onlyget_ownership_changesGet institutional ownership change alerts — detects new entrants, exits, position increases/decreases, and concentration shifts in top-20 shareholders.
Inferred read-onlyget_governance_gap_reportGet detailed governance gap analysis — identifies specific weaknesses vs best practice (board size, independence, committees, disclosure, attendance).
Inferred read-onlyget_peer_setGet auto-generated peer group for a company by sector, market cap band, and exchange.
Inferred read-onlyget_earnings_qualityGet earnings quality score — accrual quality, cash flow confirmation, revenue recognition, expense timing, one-off adjustments.
Inferred read-onlyget_governance_scorecardGet full governance scorecard with weighted scoring across board, ownership, disclosure, and compliance dimensions.
Inferred read-onlyget_foreign_investor_guideGet governance explainer for international investors — ownership limits, regulatory framework, independence standards, RPT protections, minority rights, and key risks for a specific company.
Inferred read-onlyget_audit_opinionsGet market-wide audit opinion analysis — going concern flags, KAMs, modified opinions, Big4 vs mid-tier breakdown, opinion downgrade detection.
Inferred read-onlyget_regulatory_risk_analysisGet market-wide regulatory risk analysis — multi-regulator severity ranking, penalty amounts in USD, risk scoring 0-100, repeat offender detection.
Inferred read-onlyget_disclosure_timelinessGet disclosure timeliness across all GCC companies — CMA 30/45 working day tracking, speed grades A-F, late filer detection by exchange.
Inferred read-onlyget_ir_readinessGet IR readiness scores — 10-dimension IR maturity assessment aligned with Saudi Exchange IR Best Practice Toolkit.
Inferred read-onlyget_ir_performanceGet IR performance scores — 7-dimension composite IR effectiveness (0-100) with exchange benchmarks.
Inferred read-onlyget_ir_website_scoresGet IR website quality scores — 10 criteria aligned with Saudi Exchange IR toolkit: accessibility, disclosures, governance section, investor calendar, FAQs.
Inferred read-onlyget_disclosure_compliance_summaryGet disclosure compliance across GCC — 8 CMA disclosure categories, weighted 0-100 scoring, exchange-level breakdown.
Inferred read-onlyget_ownership_flow_alertsGet ownership flow alerts — 7 alert types (foreign spike/drop, new/departed substantial holder, SWF position change, concentration increase, institutional shift) with severity levels.
Potential side effectsget_blackout_violationsGet insider trading blackout period violations — detects trades within 30 days of earnings across all companies.
Inferred read-onlyget_earnings_completenessGet earnings disclosure completeness — 9-component financial disclosure scoring per company and exchange overview.
Inferred read-onlyget_narrative_riskGet narrative risk analysis across GCC — detects misleading language patterns, optimism bias, vague commitments, and inconsistencies in corporate communications.
Inferred read-onlyget_geopolitical_riskGet geopolitical risk exposure for GCC markets — oil dependency, sanctions exposure, regional conflict proximity, trade route disruption risk.
Potential side effectsget_takeover_probabilityGet takeover probability scores — identifies likely M&A targets based on valuation, ownership concentration, size, sector consolidation trends.
Inferred read-onlyget_gcc_governance_indexGet GCC-wide governance index — ranks all exchanges and countries by aggregate governance quality, disclosure standards, and regulatory effectiveness.
Inferred read-onlyget_conflict_mapGet market-wide conflict of interest map — cross-directorships, related party clusters, conglomerate overlaps across all GCC companies.
Inferred read-onlyget_remuneration_benchmarksGet executive remuneration benchmarks — CEO/board pay by exchange, sector, and company size.
Potential side effectsget_quorum_trackingGet AGM quorum tracking — success rates, repeat failures, jurisdiction-specific rules for all 6 GCC legal systems.
Inferred read-onlyget_governance_changesDetect year-over-year governance changes — board turnover, independence shifts, committee restructuring, disclosure improvements or deterioration.
Inferred read-onlyget_filing_diffCompare filings between two fiscal years — structured diff across 9 data sources (income, balance sheet, governance, directors, shareholders, attendance, exec comp, auditor, announcements).
Potential side effectsget_insider_tradesGet insider trading activity for a company — trade date, director, transaction type, shares, value, blackout flag.
Potential side effectsget_credit_ratingsGet credit ratings (S&P, Moody's, Fitch, Capital Intelligence) for a company or sovereign.
Inferred read-onlyget_earnings_resultsGet earnings results with YoY growth — revenue, net profit, EPS, margins, and growth rates.
Inferred read-onlyget_capital_raisesGet capital raising activity — IPOs, rights issues, sukuk issuance, private placements.
Inferred read-onlyget_executive_compensationGet executive and board compensation data — total pay, base salary, bonuses, stock awards, benefits by individual and role.
Potential side effectsget_auditor_feesGet audit fee data — audit fees, tax fees, other fees, non-audit fee ratio.
Inferred read-onlyget_fund_holdingsGet fund/SWF holdings in GCC companies — which funds hold what, weight in fund, latest holdings.
Inferred read-onlyget_merchant_familiesGet GCC merchant family business groups — family name, country, sectors, listed companies, estimated market influence.
Inferred read-onlyget_top_shareholdersGet top 20 shareholders for a company — holder name, type (nominee/trust/fund/company/individual), ownership %, HHI concentration.
Inferred read-onlyget_committee_membershipsGet board committee memberships for a company — audit, nomination, remuneration, risk, and other committees with member roles.
Inferred read-onlyget_director_skillsGet director skills matrix for a company — skills, expertise areas, and skill gap analysis across the board.
Inferred read-onlyget_board_attendanceGet board meeting attendance records — attendance rates per director, meeting frequency, trend analysis.
Inferred read-onlyget_ownership_flowsGet foreign/GCC/domestic/retail ownership flow trends for a company over time.
Inferred read-onlyget_earnings_callsGet earnings call events for a company — dates, types, and associated announcements.
Inferred read-onlyget_news_articlesGet recent news articles mentioning a GCC company — title, source, sentiment, language (Arabic/English), publication date.
Inferred read-onlyget_consensus_estimatesGet analyst consensus estimates — target price, recommendations (buy/hold/sell), EPS estimates, coverage depth.
Inferred read-onlyget_announcement_sentimentGet announcement sentiment analysis — sentiment scores, topics, and impact assessment for company announcements.
Inferred read-onlyget_giga_projectsGet all Saudi Vision 2030 giga-projects — NEOM, The Line, Red Sea Global, Qiddiya, ROSHN, Diriyah Gate.
Inferred read-onlyget_corporate_buzzwordsGet corporate language/buzzword usage for a company — tracks 54 buzzwords across 7 categories (sustainability, digital, governance, etc.) over time.
Inferred read-onlyget_esg_metricsGet ESG data for a company — emissions (Scope 1/2/3), diversity metrics (gender ratio, nationals), safety (TRIFR, LTIFR), employee count.
Inferred read-onlyget_related_party_transactionsGet related party transactions for a company — parties, amounts, types, board approvals, and recurrence patterns.
Inferred read-onlyget_director_networkGet board interlock network for a director or company — shared directorships, community membership, centrality score, and connections.
Inferred read-onlyget_ir_contactsGet IR officer contacts for GCC companies — name, role, email, phone.
Potential side effectsget_remuneration_historyGet historical board and executive remuneration for a company — total pay, individual breakdowns, year-over-year trends.
Potential side effectsget_short_interestGet short interest data for a company — net short positions reported by Edaa (Saudi Securities Depository Center).
Inferred read-onlyget_cross_exchange_directorsList directors who serve on boards of companies listed on different GCC stock exchanges.
Inferred read-onlysemantic_searchSearch GCC announcements and filings by meaning, not just keywords.
Inferred read-onlyCONNECT WITH APPROVAL
Client installation
Review this server and its permissions before adding it. Secret placeholders must be set locally.
Codex
~/.codex/config.toml
[mcp_servers.souqdata-mcp]
url = "https://souqdata.com/api/v1/mcp"
enabled = trueClaude Code
.mcp.json
{
"mcpServers": {
"souqdata-mcp": {
"type": "http",
"url": "https://souqdata.com/api/v1/mcp"
}
}
}Claude Desktop
Settings → Connectors → Add custom connector
Name: souqdata-mcp
Remote MCP URL: https://souqdata.com/api/v1/mcpAdd this remote URL as a custom connector in Claude Desktop. Availability depends on the user plan and workspace policy.
Cursor
.cursor/mcp.json
{
"mcpServers": {
"souqdata-mcp": {
"url": "https://souqdata.com/api/v1/mcp"
}
}
}Visual Studio Code
.vscode/mcp.json
Add to Visual Studio Code{
"servers": {
"souqdata-mcp": {
"type": "http",
"url": "https://souqdata.com/api/v1/mcp"
}
}
}Generic MCP
Client-specific MCP configuration
{
"name": "souqdata-mcp",
"transport": "streamable-http",
"url": "https://souqdata.com/api/v1/mcp"
}MCP Inspector
Run the official MCP Inspector locally and enter the indexed Streamable HTTP endpoint.
TRUST AND VERIFICATION EVIDENCE
Loading Trust v2 evidence…
Checking the associated registrable domain. The BuiltWith key remains server-side.
Evidence is source-attributed and does not guarantee that a third-party server is safe. Risk labels are conservative metadata heuristics.