datasaudi-mcp
Consulta estadísticas económicas y sociales de Arabia Saudita (PIB, inflación, comercio, población, índice de precios inmobiliarios) desde GASTAT / DataSaudi oficial, en inglés o árabe. Sin clave, sin base de datos.
Documentación
datasaudi-mcp
Pregúntale a Claude, Cursor o cualquier cliente MCP sobre la economía saudí — en inglés sencillo o árabe. Sin clave API. Sin base de datos.
Pregúntale · Cobertura · Instalación · العربية · Herramientas
PIB, inflación, comercio, población, el índice de precios inmobiliarios — 277 conjuntos de datos oficiales de GASTAT, en vivo desde DataSaudi, respondidos directamente dentro de tu cliente de IA. Nunca necesitas nombrar un conjunto de datos; el modelo lo encuentra.
Aquí está en Claude Desktop — una pregunta en inglés sencillo, y el modelo encuentra el conjunto de datos, extrae el índice de precios inmobiliarios de Riad frente a la tendencia nacional, y lo grafica:

Pregúntale cualquier cosa
Conéctalo en unos 2 minutos (Instalación), y luego solo pregunta:
💬 "¿Cuál fue el índice de precios inmobiliarios en Riad por trimestre, y cómo se compara con la tendencia nacional?"
💬 "¿Quiénes son los principales socios comerciales de Arabia Saudita? Desglosa el comercio exterior por país y exportaciones vs. importaciones."
🇸🇦 "اعرض الرقم القياسي لأسعار العقارات في الرياض حسب الربع" — pregunta en árabe, recibe respuesta en árabe (
الرياض,مكة المكرمة). Consulta Soporte en árabe.
El modelo descubre el conjunto de datos correcto, extrae los números y responde. No necesitas conocer ningún nombre de conjunto de datos ni sintaxis de consulta.
Más ejemplos de preguntas
- "Muéstrame la inflación y el IPC por provincia para el último año — ¿qué regiones fueron las más altas?"
- "¿Cómo ha diferido el índice de precios inmobiliarios entre villas y apartamentos a lo largo del tiempo?"
- "¿Cuál es la población por provincia, dividida por sexo y nacionalidad (saudí vs. no saudí)?"
- "Muéstrame el PIB real por sector económico, trimestre a trimestre, con crecimiento interanual."
- "Compara los salarios mensuales promedio: saudí vs. no saudí, y hombres vs. mujeres."
Sobre qué puedes preguntar
277 conjuntos de datos seleccionados de GASTAT / DataSaudi. Cada consulta accede a la API en vivo, por lo que los números están tan actualizados como los publica GASTAT.
|
📈 Economía PIB (sector / gasto / actividad), IPC e inflación (nacional + por provincia), el índice de precios al productor, IED, comercio exterior (país / producto / flujo), la balanza comercial, confianza empresarial y del consumidor. |
👥 Sociedad Población (provincia / sexo / nacionalidad / edad), hogares y viviendas, salarios, empleo y tasas de participación, educación, salud, discapacidad. |
|
🏗️ Bienes raíces El índice de precios por provincia y tipo de propiedad (villa / apartamento / terreno), permisos de construcción, el índice de costos de construcción, tenencia y tipo de vivienda. |
🌍 Más Turismo y ocupación hotelera, energía y agua, Hajj y Umrah, series financieras de SAMA, indicadores reportados internacionalmente (Banco Mundial / ONU). |
[!IMPORTANT] Dónde se detiene — a propósito. Una herramienta de datos confiable te dice sus límites.
- Sirve el índice de precios inmobiliarios (año base 100) — no precios por transacción en riales (esos viven en MoJ / Srem).
- Sin volúmenes de transacciones de MoJ, sin REGA, sin datos municipales / ZATCA / CMA, sin microdatos. Esta es la capa de indicadores principales de ~277 series, no el corpus nacional completo.
- El detalle geográfico se detiene a nivel de provincia para la mayoría de las series — sin desglose por ciudad / distrito.
Si preguntas por algo fuera de esto, el servidor lo dice claramente, en lugar de adivinar.
Instalación
Sin clave API, nada que configurar — DataSaudi no requiere clave. Necesitarás
uv instalado.
Claude Code — una línea, sin editar archivos:
claude mcp add datasaudi -- uvx datasaudi-mcp
Claude Desktop
Settings → Developer → Edit Config, agrega el bloque a continuación, luego cierra y vuelve a abrir completamente
Claude Desktop (sal por completo desde la bandeja del sistema — no solo cierres la ventana):
{
"mcpServers": {
"datasaudi": {
"command": "uvx",
"args": ["datasaudi-mcp"]
}
}
}
Cursor
Settings → Tools & MCP → New MCP Server (o edita ~/.cursor/mcp.json), mismo bloque:
{
"mcpServers": {
"datasaudi": {
"command": "uvx",
"args": ["datasaudi-mcp"]
}
}
}
Luego haz una de las preguntas anteriores.
Soporte en árabe
Datos saudíes en árabe, como una característica de primera clase — no un complemento.
- Pregunta en árabe, recibe respuesta en árabe. Los nombres de los miembros se devuelven en escritura árabe:
الرياضpara Riad,مكة المكرمةpara La Meca,المنطقة الشرقيةpara la Región Oriental. - La búsqueda del catálogo también funciona en árabe — un término en árabe coincide con las anotaciones de tema / fuente en árabe de los conjuntos de datos.
- Los números y la estructura son idénticos en todos los idiomas — solo cambian los títulos legibles por humanos.
Las herramientas
Tres herramientas hacen el trabajo; el modelo las llama por ti.
| Herramienta | Qué hace |
|---|---|
list_cubes | Busca en el catálogo de 277 conjuntos de datos por palabra clave (inglés o árabe). |
describe_cube | Muestra las dimensiones de desglose y las medidas de un conjunto de datos. |
query_cube | Ejecuta una consulta validada y devuelve filas ordenadas — con la consulta repetida y paginación honesta. |
Solución de problemas — "datasaudi" no aparece
- ¿Cerraste y volviste a abrir completamente la aplicación? (Cerrar la ventana no es suficiente — sal desde la bandeja del sistema).
- ¿Tu configuración es JSON válido? Una coma suelta rompe todo el archivo — pégala en un validador de JSON.
- ¿Está
uvinstalado y en tu PATH? Ejecutauvx --versionen una terminal. - Revisa el panel de MCP / herramientas del cliente para ver un mensaje de error junto a
datasaudi.
Fuente de datos y actualización
Los datos provienen en vivo de api.datasaudi.sa (la API Tesseract de DataSaudi, operada por el
Ministerio de Economía y Planificación; datos producidos por GASTAT). El servidor no tiene copia local
— cada consulta se obtiene fresca, por lo que los resultados siempre están tan actualizados como el propio DataSaudi. Solo
el catálogo ligero de conjuntos de datos se almacena en caché en memoria durante la sesión.
Los términos de uso de datos de DataSaudi los establece su operador; este proyecto es un cliente independiente de código abierto y atribuye a GASTAT / MEP como fuente. Revisa los términos de DataSaudi para tu caso de uso.
Contribuciones
Las contribuciones son bienvenidas — consulta CONTRIBUTING.md. Para desarrollar localmente:
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
Licencia
MIT — consulta LICENSE.