1. What is MCP?
MCP (Model Context Protocol) is an open standard that lets AI assistants call external tools. The SAHMK MCP server gives your assistant these tools for Tadawul data:
| Tool | What it does |
|---|---|
| get_quote | Get live quote details for one stock |
| get_quotes | Compare live quotes for multiple stocks |
| get_market_summary | See how an index is performing today |
| get_market_movers | Get top gainers, losers, or active stocks with stable type, index, count, and items |
| get_sectors | View sector performance with stable index, count, and items |
| get_company | Get company profile and key fundamentals |
| get_historical | Fetch historical OHLCV price data |
| get_financials | Review company financial statements and metrics |
| get_dividends | See dividend history and payout details |
Note: get_financials and get_dividends may require an eligible plan (Starter+ or above).
2. Get your API key
You need a SAHMK API key. Get your free key by signing up here.
Your key starts with shmk_live_ or shmk_test_.
3. Installation
Install the MCP server from PyPI:
pip install sahmk-mcpVerify it's installed:
sahmk-mcp --help4. Connect to Claude Desktop
Add the following to your Claude Desktop config file.
On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"sahmk": {
"command": "sahmk-mcp",
"env": {
"SAHMK_API_KEY": "your_api_key_here"
}
}
}
}Restart Claude Desktop. You should see the SAHMK tools available in the tools menu.
5. Connect to Cursor
Add the following to your project's .cursor/mcp.json:
{
"mcpServers": {
"sahmk": {
"command": "sahmk-mcp",
"env": {
"SAHMK_API_KEY": "your_api_key_here"
}
}
}
}Restart Cursor. The SAHMK tools will be available to the AI assistant in your editor.
6. Try it out
Once connected, ask your AI assistant questions in plain language.
Prompt
How is the Saudi market doing today?Calls get_market_summary.
Prompt
Show the top gainers in TASICalls get_market_movers.
Prompt
Show sector performance in TASICalls get_sectors.
Prompt
Get financials for AramcoCalls get_financials.
Prompt
Show dividends for AramcoCalls get_dividends.
Prompt
Compare Aramco and Al Rajhi BankCalls get_quotes.
Prompt
Show Aramco's price history for the last 3 monthsCalls get_historical.
Financials and dividends may require an eligible plan (Starter+ or above).
7. Available plans
| Plan | Price | Requests/day |
|---|---|---|
| Free | 0 SAR | 100 |
| Starter | 149 SAR/mo | 5,000 |
| Pro | 499 SAR/mo | 50,000 |
| Enterprise | Contact us | Unlimited |
The free plan gives you 100 requests per day — enough to get started and test the integration.
8. Next steps
- →Browse the SAHMK MCP source code on GitHub
- →Explore the Python SDK quick start for building custom applications
- →Check the API reference for all available endpoints
Give your AI assistant access to Tadawul
Install the SAHMK MCP server and start asking questions about the Saudi stock market in plain language. 100 free requests per day, no credit card required.