Datasaudi Mcp

io.github.mohsinmshabbirPublished by GitHub account mohsinmshabbirv0.1.0Updated Nov 3, 2026

Saudi economic & social statistics (GASTAT/DataSaudi) in English or Arabic. Keyless, no database.

VerifiedSTDIODesktop onlyWeb Search & ScrapingData & Analytics

Overview

AI-generated overview

Lets an assistant search and query 277 official Saudi GASTAT/DataSaudi statistical datasets in English or Arabic, with no API key.

What you can do
  • Search the 277-dataset catalog by keyword in English or Arabic
  • Inspect a dataset's breakdown dimensions and measures
  • Run validated queries that return tidy rows with the query echoed back and paging
  • Cover economy, society and real-estate indicators such as GDP, CPI, trade, population and the property price index
When to use it
Useful when you want to ask plain-language questions about the Saudi economy or society — GDP, inflation, trade, population, wages, real-estate price index — and have the assistant find the right official dataset and pull live numbers, including in Arabic.
Requirements
Runs locally over stdio via uvx, so the uv tool must be installed and on the PATH. No API key, account or environment variables are needed; network access to the DataSaudi API is required for every query.
Before you install
Queries go to the live DataSaudi API operated by the Ministry of Economy and Planning, so requests leave your machine; only the dataset catalog is cached in memory. Coverage is headline indicators at province level, not per-deal prices or microdata. Data-usage terms are set by the operator and should be reviewed for your use case.

Installation

In SourceWeft

  1. Open Datasaudi Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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.

[!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:

bash
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):

json
{  "mcpServers": {    "datasaudi": {      "command": "uvx",      "args": ["datasaudi-mcp"]    }  }}
Cursor

Settings → Tools & MCP → New MCP Server (or edit ~/.cursor/mcp.json), same block:

json
{  "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.

ToolWhat it does
list_cubesSearch the 277‑dataset catalog by keyword (English or Arabic).
describe_cubeShow one dataset's breakdown dimensions and measures.
query_cubeRun 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:

bash
git clone https://github.com/mohsinmshabbir/datasaudi-mcpcd datasaudi-mcpuv sync --all-extrasuv run pytest -m "not live"    # offline test suiteuv run pytest -m live          # optional: hits the real API

License

MIT — see LICENSE.

Source: README.md at commit 692c9b0

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts