{
  "markdown": "<!-- mcp-name: io.github.mohsinmshabbir/datasaudi-mcp -->\n\n<div align=\"center\">\n\n# datasaudi-mcp\n\n*Ask Claude, Cursor, or any MCP client about the Saudi economy —*\n*in plain English **or Arabic**. No API key. No database.*\n\n[![PyPI](https://img.shields.io/pypi/v/datasaudi-mcp)](https://pypi.org/project/datasaudi-mcp/)\n[![MCP Registry](https://img.shields.io/badge/MCP_Registry-listed-6E56CF.svg)](https://registry.modelcontextprotocol.io/v0/servers?search=datasaudi)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/)\n[![CI](https://github.com/mohsinmshabbir/datasaudi-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/mohsinmshabbir/datasaudi-mcp/actions)\n\n<br/>\n\n**[Ask it](#ask-it-anything)**&nbsp;&nbsp;·&nbsp;&nbsp;**[Coverage](#what-you-can-ask-about)**&nbsp;&nbsp;·&nbsp;&nbsp;**[Install](#install)**&nbsp;&nbsp;·&nbsp;&nbsp;**[العربية](#arabic-support)**&nbsp;&nbsp;·&nbsp;&nbsp;**[Tools](#the-tools)**\n\n</div>\n\n---\n\nGDP, inflation, trade, population, the real‑estate price index — **277 official\n[GASTAT](https://www.stats.gov.sa) datasets**, live from [DataSaudi](https://datasaudi.sa),\nanswered right inside your AI client. You never name a dataset; the model finds it.\n\nHere it is in Claude Desktop — one plain‑English question, and the model finds the dataset,\npulls Riyadh's real‑estate price index against the national trend, and charts it:\n\n![datasaudi-mcp answering a question in Claude Desktop](https://raw.githubusercontent.com/mohsinmshabbir/datasaudi-mcp/main/docs/demo.gif)\n\n---\n\n## Ask it anything\n\nConnect it in about 2 minutes ([Install](#install)), then just ask:\n\n> 💬 &nbsp;*\"What was the real‑estate price index in Riyadh by quarter, and how does it\n> compare to the national trend?\"*\n\n> 💬 &nbsp;*\"Who are Saudi Arabia's top trading partners? Break foreign trade down by\n> country and exports vs. imports.\"*\n\n> 🇸🇦 &nbsp;*\"اعرض الرقم القياسي لأسعار العقارات في الرياض حسب الربع\"*\n> &nbsp;&nbsp;— ask in Arabic, get Arabic back (`الرياض`, `مكة المكرمة`). See [Arabic support](#arabic-support).\n\nThe model discovers the right dataset, pulls the numbers, and answers. **You don't need to\nknow any dataset names or query syntax.**\n\n<details>\n<summary><b>More example prompts</b></summary>\n\n<br/>\n\n- *\"Show me inflation and the CPI by province for the latest year — which regions were highest?\"*\n- *\"How has the real‑estate price index differed between villas and apartments over time?\"*\n- *\"What's the population by province, split by sex and nationality (Saudi vs. non‑Saudi)?\"*\n- *\"Show me real GDP by economic sector, quarter over quarter, with year‑on‑year growth.\"*\n- *\"Compare average monthly wages: Saudi vs. non‑Saudi, and men vs. women.\"*\n\n</details>\n\n---\n\n## What you can ask about\n\n277 curated GASTAT / DataSaudi datasets. Every query hits the **live** API, so the numbers\nare as current as GASTAT publishes.\n\n<table>\n<tr>\n<td width=\"50%\" valign=\"top\">\n\n**📈 Economy**\n\nGDP (sector / expenditure / activity), CPI & inflation (national + by province), the\nProducer Price Index, FDI, foreign trade (country / product / flow), the trade balance,\nbusiness & consumer confidence.\n\n</td>\n<td width=\"50%\" valign=\"top\">\n\n**👥 Society**\n\nPopulation (province / sex / nationality / age), households & dwellings, wages, employment\n& participation rates, education, health, disability.\n\n</td>\n</tr>\n<tr>\n<td width=\"50%\" valign=\"top\">\n\n**🏗️ Real estate**\n\nThe price **index** by province and property type (villa / apartment / land), building\npermits, the construction cost index, housing tenure & type.\n\n</td>\n<td width=\"50%\" valign=\"top\">\n\n**🌍 More**\n\nTourism & hotel occupancy, energy & water, Hajj & Umrah, SAMA financial series,\ninternationally‑reported (World Bank / UN) indicators.\n\n</td>\n</tr>\n</table>\n\n> [!IMPORTANT]\n> **Where it stops — on purpose.** A data tool you can trust tells you its edges.\n> - Serves the real‑estate **price index** (base‑year 100) — **not per‑deal prices in riyals** (those live in MoJ / Srem).\n> - 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.\n> - Geographic detail stops at the **province** level for most series — no city / district breakdown.\n>\n> Ask for something outside this and the server says so plainly, rather than guessing.\n\n---\n\n## Install\n\nNo API key, nothing to configure — DataSaudi is keyless. You'll need\n[`uv`](https://docs.astral.sh/uv/getting-started/installation/) installed.\n\n**Claude Code** — one line, no file editing:\n\n```bash\nclaude mcp add datasaudi -- uvx datasaudi-mcp\n```\n\n<details>\n<summary><b>Claude Desktop</b></summary>\n\n<br/>\n\n`Settings → Developer → Edit Config`, add the block below, then **completely quit and reopen**\nClaude Desktop (fully quit from the tray — not just close the window):\n\n```json\n{\n  \"mcpServers\": {\n    \"datasaudi\": {\n      \"command\": \"uvx\",\n      \"args\": [\"datasaudi-mcp\"]\n    }\n  }\n}\n```\n\n</details>\n\n<details>\n<summary><b>Cursor</b></summary>\n\n<br/>\n\n`Settings → Tools & MCP → New MCP Server` (or edit `~/.cursor/mcp.json`), same block:\n\n```json\n{\n  \"mcpServers\": {\n    \"datasaudi\": {\n      \"command\": \"uvx\",\n      \"args\": [\"datasaudi-mcp\"]\n    }\n  }\n}\n```\n\n</details>\n\nThen ask one of the questions above.\n\n---\n\n## Arabic support\n\nSaudi data in Arabic, as a first‑class feature — not an afterthought.\n\n- **Ask in Arabic, get Arabic back.** Member names return in Arabic script: `الرياض` for\n  Riyadh, `مكة المكرمة` for Makkah, `المنطقة الشرقية` for the Eastern Region.\n- **Catalog search works in Arabic too** — an Arabic term matches the datasets' Arabic\n  topic / source annotations.\n- **Numbers and structure are identical** across languages — only the human‑readable\n  captions change.\n\n---\n\n## The tools\n\nThree tools do the work; the model calls them for you.\n\n| Tool | What it does |\n|---|---|\n| `list_cubes` | Search the 277‑dataset catalog by keyword (English or Arabic). |\n| `describe_cube` | Show one dataset's breakdown dimensions and measures. |\n| `query_cube` | Run a validated query and return tidy rows — with the query echoed back and honest paging. |\n\n<details>\n<summary><b>Troubleshooting — \"datasaudi\" doesn't show up</b></summary>\n\n<br/>\n\n- Did you **fully quit and reopen** the app? (Closing the window isn't enough — quit from the tray.)\n- Is your config valid JSON? A stray comma breaks the whole file — paste it into a JSON validator.\n- Is `uv` installed and on your PATH? Run `uvx --version` in a terminal.\n- Check the client's MCP / tools panel for an error message next to `datasaudi`.\n\n</details>\n\n<details>\n<summary><b>Data source & freshness</b></summary>\n\n<br/>\n\nData comes live from `api.datasaudi.sa` (the DataSaudi Tesseract API, operated by the\nMinistry of Economy & Planning; data produced by GASTAT). The server holds **no local copy**\n— every query is fetched fresh, so results are always as current as DataSaudi itself. Only\nthe lightweight dataset *catalog* is cached in memory for the session.\n\nDataSaudi's data‑usage terms are set by its operator; this project is an independent\nopen‑source client and attributes GASTAT / MEP as the source. Please review DataSaudi's\nterms for your use case.\n\n</details>\n\n---\n\n## Contributing\n\nContributions welcome — see [`CONTRIBUTING.md`](CONTRIBUTING.md). To develop locally:\n\n```bash\ngit clone https://github.com/mohsinmshabbir/datasaudi-mcp\ncd datasaudi-mcp\nuv sync --all-extras\nuv run pytest -m \"not live\"    # offline test suite\nuv run pytest -m live          # optional: hits the real API\n```\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n",
  "bytes": 7701,
  "sha": "4e745d203f5263e9e758dcc2097824a5ed362b492003c64c7ac8f0653667fd0c",
  "repo_slug": "mohsinmshabbir/datasaudi-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_mohsinmshabbir_datasaudi_mcp_7547c8c2/readme"
}