Skip to main content

datasaudi-mcp

Ask Claude, Cursor, or any MCP client about the Saudi economy — in plain English or Arabic. No API key. No database.

PyPI MCP Registry License: MIT Python 3.12+ CI


Ask it  ·  Coverage  ·  Install  ·  العربية  ·  Tools


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:

datasaudi-mcp answering a question in Claude Desktop


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.


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.

The tools

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"    # offline test suite
uv run pytest -m live          # optional: hits the real API

License

MIT — see LICENSE.

Metadata

Release files for datasaudi-mcp 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for datasaudi-mcp 0.1.1
File Size Uploaded
datasaudi_mcp-0.1.1.tar.gz 1.9 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for datasaudi-mcp 0.1.1
File Interpreter ABI Platform
datasaudi_mcp-0.1.1-py3-none-any.whl Python 3 none any Details

Total release size: 1.9 MB

Release files / datasaudi_mcp-0.1.1.tar.gz

Download URL datasaudi_mcp-0.1.1.tar.gz
Size 1.9 MB
Tags Source
SHA-256 checksum
How to use checksums
949338ad2c8a27834be292b09fe86dacc76d45a60a552486061c97bd9ddf46b0
BLAKE2b-256 checksum
How to use checksums
b8f51c481eaab1ddf601c6a56d972d5ac3f1b0298fd6ba29aeabb414967883f8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jul 9, 2026.

Transparency log

Release files / datasaudi_mcp-0.1.1-py3-none-any.whl

Download URL datasaudi_mcp-0.1.1-py3-none-any.whl
Size 20.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
4830396675aa625a1045c8f256b8fb36caa58f88963b0f4bde81d2abf770e621
BLAKE2b-256 checksum
How to use checksums
d4571091d0444b53acb945819927efe3a0c737c3a33b886971805b28bc76ffed
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jul 9, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page