SAHMK MCP Server
Official distribution: GitHub (
sahmk-sa/sahmk-mcp) and PyPI (sahmk-mcp) only. Do not install from third-party forks.
Official SAHMK MCP server for SAHMK — use Saudi market data inside AI agents such as Cursor and Claude Desktop.
Power your agent
การติดตั้งจากผู้เผยแพร่ ไม่ใช่เอนด์พอยต์ของ PlugMCP
URL แบบรีโมตหรือคำสั่งบนเครื่องของคุณ? การติดตั้งสองแบบต่างกันอย่างไร
รันบน PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
เปิดจากผู้เผยแพร่
Official distribution: GitHub (
sahmk-sa/sahmk-mcp) and PyPI (sahmk-mcp) only. Do not install from third-party forks.
Official SAHMK MCP server for SAHMK — use Saudi market data inside AI agents such as Cursor and Claude Desktop.
Official SAHMK MCP server for AI agent access to Saudi market data (v0.7.0). Default public Dev API host: api.sahmk.sa.
This MCP exposes a curated set of Sahmk tools for AI agents, so assistants can query the Saudi market in natural language.
identifier and identifiers.symbol and symbols are still accepted for compatibility.SDK repo: sahmk-sa/sahmk-python
shmk_live_ or shmk_test_)get_depth is entitlement-gated. Request realtime/depth access from the developer dashboard:
SAHMK_API_KEY is required for all server runs (Claude Desktop, Cursor, and direct CLI usage).
Set it in your MCP client env config or export it before running sahmk-mcp.
Optional: SAHMK_BASE_URL overrides the default public Developer API host.
Default REST base URL is https://api.sahmk.sa/api/v1/ (aligned with sahmk SDK 0.16.0).
https://app.sahmk.sa/api/v1/ remains a fully supported compatibility host — set SAHMK_BASE_URL if you need it:
export SAHMK_BASE_URL="https://app.sahmk.sa/api/v1"
Path shapes are unchanged (/api/v1/, /api/v2/, /ws/v1/). Portal/dashboard routes (/api/developers/*) stay on app.sahmk.sa and are not used by this MCP.
pip install sahmk-mcp
Requires sahmk>=0.16.0 for current MCP-SDK compatibility (default host api.sahmk.sa, market depth, live trades, and events tools).
SAHMK_API_KEY).Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"sahmk": {
"command": "sahmk-mcp",
"env": {
"SAHMK_API_KEY": "your_api_key"
}
}
}
}
Optional compatibility host override (same paths on app.sahmk.sa):
{
"mcpServers": {
"sahmk": {
"command": "sahmk-mcp",
"env": {
"SAHMK_API_KEY": "your_api_key",
"SAHMK_BASE_URL": "https://app.sahmk.sa/api/v1"
}
}
}
}
Add to .cursor/mcp.json:
{
"mcpServers": {
"sahmk": {
"command": "sahmk-mcp",
"env": {
"SAHMK_API_KEY": "your_api_key"
}
}
}
}
Optional compatibility host override:
{
"mcpServers": {
"sahmk": {
"command": "sahmk-mcp",
"env": {
"SAHMK_API_KEY": "your_api_key",
"SAHMK_BASE_URL": "https://app.sahmk.sa/api/v1"
}
}
}
}
export SAHMK_API_KEY="your_api_key"
sahmk-mcp
get_market_summary.index: TASI or NOMU (NOMUC alias is accepted and normalized).get_market_movers.type: gainers, losers, volume, or value.get_market_movers.limit: integer from 1 to 50.get_quote.identifier (preferred): accepts numeric symbol, Arabic/English company name, or known alias.get_quote.symbol (legacy alias): accepted for backward compatibility.get_quotes.identifiers (preferred): maximum 50 identifiers per request.get_quotes.symbols (legacy alias): accepted for backward compatibility.get_financials.symbol: prefers exact exchange symbol; MCP attempts SDK-backed identifier resolution for names/aliases when possible.get_financials.period and get_financials.statement_period: if both are provided, period takes precedence.get_financials supports optional passthrough params: type, period, statement_period, history, metrics, result, and include_partial.get_financials response is statement-block focused and does not include meta.get_ratios.symbol: prefers exact exchange symbol; MCP attempts SDK-backed identifier resolution for names/aliases when possible.get_ratios.history: defaults to latest.get_ratios.period: defaults to annual.get_ratios.metrics: defaults to core.compare_symbols.symbols: list of symbols (preferred) or comma-separated string; MCP attempts SDK-backed identifier resolution for names/aliases when possible.compare_symbols.metrics: defaults to core.get_ratios and compare_symbols include minimal meta only: period, metrics, warnings.applied_profile, plan, or source diagnostics.get_dividends.symbol: prefers exact exchange symbol; MCP attempts SDK-backed identifier resolution for names/aliases when possible.get_depth.symbol: prefers exact exchange symbol; MCP attempts SDK-backed identifier resolution for names/aliases when possible.get_depth.levels: optional integer from 1 to 20 (backend default is typically 5; entitlement may cap below the request).get_trades.symbol: prefers exact exchange symbol; MCP attempts SDK-backed identifier resolution for names/aliases when possible.get_trades.limit: optional integer from 1 to 200 (backend default is typically 50; newest first).get_trades.events[].side: optional trade side, one of buy, sell, or null.get_events.symbol: optional exact exchange symbol filter; omit for market-wide recent events.get_events.limit: optional integer from 1 to 100.get_historical.symbol: prefers exact exchange symbol; MCP attempts SDK-backed identifier resolution for names/aliases when possible.companies_list.market: TASI or NOMU (NOMUC alias is accepted and normalized).companies_list.limit: integer greater than 0.companies_list.offset: integer greater than or equal to 0.get_historical.interval: 1d, 1w, 1m, 30m, or 60m.AMBIGUOUS_IDENTIFIER with retry guidance and candidates when available.companies_list(search="aramco")companies_list(search="acwa", market="NOMUC")companies_list(search="bank", limit=50, offset=100)get_quote(identifier="أرامكو")get_quote(symbol="2222")get_quotes(identifiers=["سبكيم", "كيان"])get_quotes(symbols=["2222", "1120"])get_financials(symbol="1120")get_ratios(symbol="1120")get_ratios(symbol="1120", history="5y", period="quarterly", metrics="extended")compare_symbols(symbols=["1120", "1180", "1010"])compare_symbols(symbols=["1120", "1180", "1010", "2222"], metrics="extended")get_dividends(symbol="1120")get_depth(symbol="2222")get_depth(symbol="2222", levels=10)get_trades(symbol="2222")get_trades(symbol="2222", limit=20)events[] item may include side = buy, sell, or null.get_events(limit=10)get_events(symbol="1120", limit=5)get_historical(symbol="1120", interval="1d")get_historical(symbol="1120", from_date="2026-01-01", to_date="2026-03-31", interval="1d")get_historical(symbol="1120", interval="60m")get_historical(symbol="1120", from_date="2026-05-01", to_date="2026-05-31", interval="60m")Use companies_list first to reduce invalid-symbol 404s before symbol-only tools.
companies_list(search="aramco")companies_list(search="2222")companies_list(search="acwa", market="NOMUC") (NOMUC is normalized to NOMU)results, then call:
get_quote(identifier="<symbol>")get_financials(symbol="<symbol>")get_dividends(symbol="<symbol>")get_historical(symbol="<symbol>")offset by limit until you reach total:
companies_list(search="bank", limit=100, offset=0)companies_list(search="bank", limit=100, offset=100)offset >= totalget_quote(identifier="الراجحي").resolved_instrument.symbol = "1120", reuse it and call get_financials(symbol="1120").Note: get_financials and get_dividends require Sahmk API access on Starter or higher. If unavailable for the current key, the MCP returns the underlying API error.
Note: get_depth is entitlement-gated — request access. get_trades and get_events require Pro+. If unavailable for the current key, the MCP surfaces the API error.
Note: intraday historical intervals (30m, 60m) may be plan-gated. If unavailable for the current key, the MCP surfaces the API error (for example 403 PLAN_LIMIT).
0.8.1: bump minimum sahmk SDK requirement to 0.16.0.0.8.0: add optional side to get_trades events (buy/sell/null) with backward-compatible output for payloads that omit it.0.7.0: default public Developer API host → api.sahmk.sa (require sahmk>=0.15.0); app.sahmk.sa still supported via SAHMK_BASE_URL.0.6.0: require sahmk>=0.14.0; add get_trades for recent live trade prints (Pro+).0.5.1: document market-depth entitlement request link in the README.0.5.0: require sahmk>=0.13.0; add get_depth (order-book ladder) and get_events (AI event summaries, Pro+).0.4.7: remove include_quality from public get_financials tool contract, normalize equivalent Arabic-Indic/ASCII digit inputs before identifier conflict checks, and improve Glama form UX with enum selectors for stable ratio/period options.0.4.6: add SDK-backed identifier fallback for get_company and symbol-first tools (get_financials, get_ratios, compare_symbols, get_dividends, get_historical) when name/alias inputs fail direct symbol lookup.0.4.5: align to sahmk>=0.11.0; extend get_historical.interval support to 30m/60m; document intraday plan-gating behavior.0.4.4: docs: clarify official distribution channels (GitHub + PyPI only)0.4.3: Align MCP output contract: no financials meta; analytics meta is limited to period, metrics, and warnings.0.4.2: Add SDK method-name compatibility fallback for analytics (get_ratios/ratios, compare_symbols/compare).0.4.1: Require sahmk>=0.9.1 in package dependency and runtime version guard.0.4.0: Add analytics ratios and compare tools; enhance financials optional parameters.MIT — see LICENSE
Official SAHMK MCP server for AI agent access to Saudi market data (v0.7.0). Default public Dev API host: api.sahmk.sa.
เครื่องมือ
ยังไม่มีรายการเครื่องมือ เซิร์ฟเวอร์แบบรีโมตจะได้รายการหลังการตรวจสอบสถานะครั้งแรก
FAQ
คัดลอกคอนฟิก stdio สำหรับ Cursor, Claude Desktop, Claude Code หรือ VS Code ได้ในหน้านี้ คอนฟิกนี้ใช้การติดตั้งของผู้เผยแพร่ ไม่ใช่พร็อกซีของ PlugMCP
ระเบียนนี้ไม่ได้ระบุตัวแปรสภาพแวดล้อมที่จำเป็น
Sahmk ทำงานแบบโลคัลผ่าน stdio
ตรวจสอบล่าสุดเมื่อ 2026-10-28 Official SAHMK MCP server for AI agent access to Saudi market data (v0.7.0). Default public Dev API host: api.sahmk.sa.