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.

PyPI MCP Registry License: MIT Python 3.12+ CI


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:

datasaudi-mcp answering a question in Claude Desktop


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.

HerramientaQué hace
list_cubesBusca en el catálogo de 277 conjuntos de datos por palabra clave (inglés o árabe).
describe_cubeMuestra las dimensiones de desglose y las medidas de un conjunto de datos.
query_cubeEjecuta 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á uv instalado y en tu PATH? Ejecuta uvx --version en 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.