datasaudi-mcp
About
Query Saudi economic & social statistics (GDP, inflation, trade, population, real-estate price index) from official GASTAT / DataSaudi, in English or Arabic. Keyless, no database.
Details
- Author
- mohsinmshabbir
- Categories
- Database, Other
Jump to
Setup
Install datasaudi-mcp in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/mohsinmshabbir/datasaudi-mcp
Follow the installation instructions in the repository README, then restart your MCP client.
Ask Claude, Cursor, or any MCP client about the Saudi economy —in plain Englishor Arabic. No API key. No database.
Ask it·Coverage·Install·العربية·Tools
GDP, inflation, trade, population, the real‑estate price index —277 officialGASTATdatasets, live fromDataSaudi, 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:
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 (الرياض,مكة المكرمة). SeeArabic support.
The model discovers the right dataset, pulls the numbers, and answers.You don't need to know any dataset names or query syntax.
- "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."
277 curated GASTAT / DataSaudi datasets. Every query hits theliveAPI, so the numbers are as current as GASTAT publishes.
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.
Population (province / sex / nationality / age), households & dwellings, wages, employment & participation rates, education, health, disability.
The priceindexby province and property type (villa / apartment / land), building permits, the construction cost index, housing tenure & type.
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‑estateprice 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‑seriesheadline‑indicatorlayer, not the full national corpus.
- Geographic detail stops at theprovincelevel for most series — no city / district breakdown.
Ask for something outside this and the server says so plainly, rather than guessing.
No API key, nothing to configure — DataSaudi is keyless. You'll needuvinstalled.
Claude Code— one line, no file editing:
claude mcp add datasaudi -- uvx datasaudi-mcp
Settings → Developer → Edit Config, add the block below, thencompletely quit and reopenClaude Desktop (fully quit from the tray — not just close the window):
{ "mcpServers": { "datasaudi": { "command": "uvx", "args": ["datasaudi-mcp"] } } }
Settings → Tools & MCP → New MCP Server(or edit~/.cursor/mcp.json), same block:
{ "mcpServers": { "datasaudi": { "command": "uvx", "args": ["datasaudi-mcp"] } } }
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 identicalacross languages — only the human‑readable captions change.
Three tools do the work; the model calls them for you.
- Did youfully quit and reopenthe 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.
- Isuvinstalled and on your PATH? Runuvx --versionin a terminal.
- Check the client's MCP / tools panel for an error message next todatasaudi.
Data comes live fromapi.datasaudi.sa(the DataSaudi Tesseract API, operated by the Ministry of Economy & Planning; data produced by GASTAT). The server holdsno local copy*— every query is fetched fresh, so results are always as current as DataSaudi itself. Only the lightweight datasetcatalog*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.
Contributions welcome — seeCONTRIBUTING.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
Schedule and queue text, image, and video posts to many social networks, including LinkedIn, X, Bluesky, Instagram, Facebook, Threads, Tiktok.
An MCP server to connect and interact with all your social media
Streamline your social media with Postiz. Schedule posts, analyze performance, and manage all accounts in one place
Installable MCP server for AgentLux marketplace, identity, creator, services, social, and Base/x402 commerce flows.
Draft, schedule and publish social posts to LinkedIn, X, Instagram, Facebook, Threads, TikTok, Pinterest and YouTube from your AI assistant, in a brand voice learned per account.
AI-powered social media posting across 14 platforms with per-platform content adaptation, scheduling, and 30-day calendar generation
Schedule, generate and publish social posts to X, LinkedIn, Instagram, Threads and YouTube from any MCP client.
Create, schedule, and publish social media posts to 9 platforms from Claude, Cursor, or any AI agent. Hosted server with OAuth or API key auth.
Access the BlueSky social network data via its official API.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
