GDP, inflation, trade, population, the real‑estate price index — 277 official
GASTAT datasets, live from DataSaudi,
answered right inside your AI client. You never name a dataset; the model finds it.
Here it is in Claude Desktop — one plain‑English question, and the model finds the dataset,
pulls Riyadh's real‑estate price index against the national trend, and charts it:
Ask it anything
Connect it in about 2 minutes (Install), then just ask:
💬 "What was the real‑estate price index in Riyadh by quarter, and how does it
compare to the national trend?"
💬 "Who are Saudi Arabia's top trading partners? Break foreign trade down by
country and exports vs. imports."
🇸🇦 "اعرض الرقم القياسي لأسعار العقارات في الرياض حسب الربع"
— ask in Arabic, get Arabic back (الرياض, مكة المكرمة). See Arabic support.
The model discovers the right dataset, pulls the numbers, and answers. You don't need to
know any dataset names or query syntax.
More example prompts
- "Show me inflation and the CPI by province for the latest year — which regions were highest?"
- "How has the real‑estate price index differed between villas and apartments over time?"
- "What's the population by province, split by sex and nationality (Saudi vs. non‑Saudi)?"
- "Show me real GDP by economic sector, quarter over quarter, with year‑on‑year growth."
- "Compare average monthly wages: Saudi vs. non‑Saudi, and men vs. women."
What you can ask about
277 curated GASTAT / DataSaudi datasets. Every query hits the live API, so the numbers
are as current as GASTAT publishes.
|
📈 Economy
GDP (sector / expenditure / activity), CPI & inflation (national + by province), the
Producer Price Index, FDI, foreign trade (country / product / flow), the trade balance,
business & consumer confidence.
|
👥 Society
Population (province / sex / nationality / age), households & dwellings, wages, employment
& participation rates, education, health, disability.
|
|
🏗️ Real estate
The price index by province and property type (villa / apartment / land), building
permits, the construction cost index, housing tenure & type.
|
🌍 More
Tourism & hotel occupancy, energy & water, Hajj & Umrah, SAMA financial series,
internationally‑reported (World Bank / UN) indicators.
|
IMPORTANT
Where it stops — on purpose. A data tool you can trust tells you its edges.
- Serves the real‑estate price index (base‑year 100) — not per‑deal prices in riyals (those live in MoJ / Srem).
- No MoJ transaction volumes, no REGA, no municipal / ZATCA / CMA data, no microdata. This is the ~277‑series headline‑indicator layer, not the full national corpus.
- Geographic detail stops at the province level for most series — no city / district breakdown.
Ask for something outside this and the server says so plainly, rather than guessing.
Install
No API key, nothing to configure — DataSaudi is keyless. You'll need
uv installed.
Claude Code — one line, no file editing:
claude mcp add datasaudi -- uvx datasaudi-mcp
Claude Desktop
Settings → Developer → Edit Config, add the block below, then completely quit and reopen
Claude Desktop (fully quit from the tray — not just close the window):
{
"mcpServers": {
"datasaudi": {
"command": "uvx",
"args": ["datasaudi-mcp"]
}
}
}
Cursor
Settings → Tools & MCP → New MCP Server (or edit ~/.cursor/mcp.json), same block:
{
"mcpServers": {
"datasaudi": {
"command": "uvx",
"args": ["datasaudi-mcp"]
}
}
}
Then ask one of the questions above.
Arabic support
Saudi data in Arabic, as a first‑class feature — not an afterthought.
- Ask in Arabic, get Arabic back. Member names return in Arabic script:
الرياض for
Riyadh, مكة المكرمة for Makkah, المنطقة الشرقية for the Eastern Region.
- Catalog search works in Arabic too — an Arabic term matches the datasets' Arabic
topic / source annotations.
- Numbers and structure are identical across languages — only the human‑readable
captions change.
Three tools do the work; the model calls them for you.
| Tool | What it does |
|---|
list_cubes | Search the 277‑dataset catalog by keyword (English or Arabic). |
describe_cube | Show one dataset's breakdown dimensions and measures. |
query_cube | Run a validated query and return tidy rows — with the query echoed back and honest paging. |
Troubleshooting — "datasaudi" doesn't show up
- Did you fully quit and reopen the app? (Closing the window isn't enough — quit from the tray.)
- Is your config valid JSON? A stray comma breaks the whole file — paste it into a JSON validator.
- Is
uv installed and on your PATH? Run uvx --version in a terminal.
- Check the client's MCP / tools panel for an error message next to
datasaudi.
Data source & freshness
Data comes live from api.datasaudi.sa (the DataSaudi Tesseract API, operated by the
Ministry of Economy & Planning; data produced by GASTAT). The server holds no local copy
— every query is fetched fresh, so results are always as current as DataSaudi itself. Only
the lightweight dataset catalog is cached in memory for the session.
DataSaudi's data‑usage terms are set by its operator; this project is an independent
open‑source client and attributes GASTAT / MEP as the source. Please review DataSaudi's
terms for your use case.
Contributing
Contributions welcome — see CONTRIBUTING.md. To develop locally:
git clone https://github.com/mohsinmshabbir/datasaudi-mcp
cd datasaudi-mcp
uv sync --all-extras
uv run pytest -m "not live"
uv run pytest -m live
License
MIT — see LICENSE.
