MCP INE Server - API del Instituto Nacional de Estadística

📊 Estadísticas del Servidor

24 Herramientas MCP

24 Endpoints INE

3 Protocolos

🔌 Endpoints MCP (Model Context Protocol)

POST http://mcp.manalejandro.com/mcp/v1

JSON-RPC Endpoint - Endpoint principal para MCP sobre HTTP usando JSON-RPC 2.0. Este es el endpoint recomendado para la mayoría de clientes.

GET http://mcp.manalejandro.com/mcp/v1/sse

Conexión SSE - Endpoint alternativo para conexión MCP con Server-Sent Events (experimental).

📝 Configuración para VS Code AI Toolkit

{
  "mcpServers": {
    "mcp-ine": {
      "url": "http://mcp.manalejandro.com/mcp/v1",
      "transport": "http"
    }
  }
}

Agrega esta configuración a ~/.aitk/mcp.json

🧪 Probar el Endpoint

curl -X POST http://mcp.manalejandro.com/mcp/v1 \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"initialize","params":{},"id":1}'

🛠️ Herramientas MCP Disponibles

El servidor expone 24 herramientas para consultar datos del INE:

ine_datos_tabla Obtiene los datos estadísticos de una tabla específica del INE. EJEMPLOS DE TABLAS COMUNES: - Tabla 50902: IPC por grupos ECOICOP (inflación por categorías) - Tabla 4247: Población por provincias y sexo - Tabla 4076: EPA - Tasas de paro por sexo y edad - Tabla 30678: PIB a precios de mercado PARÁMETROS: - nult: Limita a los N últimos periodos (ej: nult=12 para último año mensual) - det: Nivel de detalle (0=básico, 1=medio, 2=completo con metadatos) - tip: Formato de respuesta (A=amigable con nombres, M=solo metadatos, AM=ambos) - tv: Filtrar por variable (formato: ID_VARIABLE:ID_VALOR, ej: "3:6" para filtrar por Madrid) - date: Rango de fechas (formato: AAAAMMDD:AAAAMMDD, ej: "20230101:20231231") Para encontrar IDs de tablas, usa primero ine_tablas_operacion con el código de la operación (ej: "IPC").

ine_datos_serie Obtiene los datos históricos de una serie temporal específica del INE. Las series son conjuntos de datos a lo largo del tiempo para un indicador específico. Cada serie tiene un código único que combina la operación y un identificador numérico. EJEMPLOS DE SERIES: - IPC251856: Índice general de precios al consumo (base 2021) - EPA17: Tasa de paro total nacional - DPOP163: Población total de España PARÁMETROS: - nult: Obtener solo los N últimos valores (ej: nult=24 para últimos 24 meses) - date: Filtrar por rango de fechas Para encontrar códigos de series, usa ine_series_operacion o ine_series_tabla.

ine_datos_metadata_operacion Obtiene datos de series filtrando por metadatos de una operación estadística. Permite hacer consultas avanzadas combinando múltiples filtros (hasta 5 grupos de filtrado). Útil cuando necesitas datos específicos de una operación sin conocer los IDs de series. EJEMPLO: Para obtener el IPC de alimentación en Madrid: - idOperacion: "IPC" - g1: "762:244074" (grupo ECOICOP: Alimentos y bebidas no alcohólicas) - g2: "70:9264" (provincia: Madrid) PERIODICIDADES COMUNES (parámetro p): - 1: Mensual - 3: Trimestral - 6: Semestral - 12: Anual Para conocer los IDs de variables y valores, usa ine_variables_operacion y ine_valores_variable_operacion.

ine_operaciones_disponibles HERRAMIENTA PRINCIPAL para descubrir todas las operaciones estadísticas del INE. USA ESTA HERRAMIENTA PRIMERO para saber qué datos están disponibles. OPERACIONES MÁS RELEVANTES: - IPC: Índice de Precios al Consumo (inflación mensual) - EPA: Encuesta de Población Activa (empleo/desempleo trimestral) - PIB (o CNE): Contabilidad Nacional (PIB trimestral y anual) - CIFRAS_POB: Cifras oficiales de población - ECV: Encuesta de Condiciones de Vida - DEFUNCIONES / NACIMIENTOS: Estadísticas vitales - COMERCIO_EXT: Comercio exterior - TURISMO: Estadísticas de turismo - HIPOTECAS: Estadísticas de hipotecas - SOCIEDADES: Estadísticas de sociedades mercantiles La respuesta incluye el código de operación (campo "Codigo") que necesitarás para otras consultas.

ine_operacion Obtiene información detallada de una operación estadística específica. Devuelve metadatos completos incluyendo: - Nombre completo y descripción - Periodicidad (mensual, trimestral, anual) - Fecha de inicio de la serie - Código IOE (clasificación internacional) - Información sobre la publicación EJEMPLOS DE CÓDIGOS: - "IPC" → Índice de Precios al Consumo - "EPA" → Encuesta de Población Activa - "PIB" o "30678" → Producto Interior Bruto - "CIFRAS_POB" → Cifras de Población - "ECV" → Encuesta de Condiciones de Vida

ine_variables Lista todas las variables estadísticas disponibles en el INE. Las variables son las dimensiones que caracterizan los datos estadísticos. VARIABLES MÁS COMUNES: - ID 3 (Territorio): Provincias, CCAA, municipios - ID 70 (Provincias): 52 provincias españolas - ID 762 (Grupos ECOICOP): Categorías del IPC - ID 547 (Sexo): Hombre, Mujer, Total - ID 18 (Edad): Grupos de edad - ID 349 (Actividad económica): Sectores CNAE Estas variables se usan para filtrar datos con el parámetro 'tv' (formato: ID_VARIABLE:ID_VALOR).

ine_variables_operacion Obtiene las variables (dimensiones) utilizadas en una operación específica. Muy útil para saber qué filtros puedes aplicar a los datos de una operación. EJEMPLO: Para el IPC, devuelve variables como: - Grupos ECOICOP (categorías de productos) - Índices y tasas (índice, variación mensual, anual) - Tipo de dato (dato definitivo, provisional) Para la EPA, devuelve: - Sexo - Grupo de edad - Situación laboral - Comunidad Autónoma Usa el ID de la variable con ine_valores_variable_operacion para ver sus valores posibles.

ine_valores_variable Obtiene todos los valores posibles de una variable estadística. EJEMPLOS: - Variable 70 (Provincias): Madrid (28), Barcelona (8), Valencia (46)... - Variable 547 (Sexo): Hombres, Mujeres, Ambos sexos - Variable 762 (Grupos ECOICOP): Alimentos, Vestido, Vivienda, Transporte... - Variable 3 (Territorio): Comunidades autónomas y provincias Los valores obtenidos (campo "Id") se usan para filtrar datos con el formato ID_VARIABLE:ID_VALOR. Por ejemplo, para filtrar por Madrid: - Variable 70 (provincias), Valor para Madrid = su ID específico - Usar en filtro: "70:28" (si 28 es el ID de Madrid)

ine_valores_variable_operacion Obtiene los valores de una variable específica DENTRO del contexto de una operación. Más preciso que ine_valores_variable porque solo devuelve valores relevantes para la operación. EJEMPLO PRÁCTICO: Para saber qué grupos de productos tiene el IPC: - idOperacion: "IPC" - idVariable: "762" (Grupos ECOICOP) Resultado: Alimentos (Id: X), Vestido (Id: Y), Vivienda (Id: Z), etc. Luego usa esos IDs para filtrar datos específicos.

ine_tablas_operacion Lista todas las tablas de datos disponibles para una operación estadística. Esta herramienta es CLAVE para saber qué datos puedes obtener de una operación. EJEMPLOS: Para "IPC" devuelve tablas como: - Índices por comunidades autónomas - Índices por grupos ECOICOP - Variaciones mensuales y anuales - Índices por provincias Para "EPA" devuelve tablas como: - Activos por sexo y grupo de edad - Parados por tiempo de búsqueda de empleo - Ocupados por sector económico - Tasas de actividad, empleo y paro El campo "Id" de cada tabla se usa luego con ine_datos_tabla para obtener los datos.

ine_grupos_tabla Obtiene los grupos de selección (dimensiones) que definen una tabla. Cada tabla del INE está estructurada en grupos que determinan cómo se organizan los datos. Esto te ayuda a entender la estructura de los datos antes de solicitarlos. EJEMPLO: Una tabla del IPC puede tener grupos como: - Grupo 1: Tipo de índice/variación - Grupo 2: Grupos ECOICOP (categorías de productos) - Grupo 3: Territorio Usa el ID del grupo con ine_valores_grupos_tabla para ver sus valores posibles.

ine_valores_grupos_tabla Obtiene los valores disponibles para un grupo específico dentro de una tabla. Complementa a ine_grupos_tabla: primero obtienes los grupos, luego los valores de cada grupo. EJEMPLO: Si la tabla del IPC tiene un grupo "Territorio" (ID: 1), esta herramienta devuelve: - Nacional - Andalucía - Aragón - ... (todas las CCAA y provincias disponibles)

ine_serie Obtiene información completa (metadatos) de una serie temporal específica. A diferencia de ine_datos_serie (que devuelve los datos), esta herramienta devuelve los METADATOS: - Nombre completo de la serie - Periodicidad (mensual, trimestral, anual) - Unidad de medida - Escala - Operación a la que pertenece - Fecha de inicio y fin Útil para entender qué representa una serie antes de pedir sus datos.

ine_series_operacion Lista todas las series temporales disponibles para una operación. Puede devolver MUCHAS series (algunas operaciones tienen miles). Usa el parámetro 'page' para paginar si es necesario. EJEMPLO: Para "IPC" devuelve series como: - IPC251856: Índice general nacional - IPC251857: Índice de alimentos - IPC251858: Índice de vestido - ... y muchas más por territorio y categoría Cada serie tiene un código (campo "COD") que puedes usar con ine_datos_serie.

ine_valores_serie Obtiene las variables y sus valores que definen una serie específica. Explica QUÉ REPRESENTA la serie mostrando sus dimensiones. EJEMPLO: Para una serie del IPC de alimentación en Madrid: - Variable "Grupo ECOICOP": Valor "Alimentos y bebidas no alcohólicas" - Variable "Territorio": Valor "Madrid" - Variable "Tipo de dato": Valor "Índice" Útil para entender exactamente qué datos contiene una serie.

ine_series_tabla Obtiene todas las series temporales contenidas en una tabla específica. Relaciona tablas con series: una tabla puede contener múltiples series. EJEMPLO: La tabla de IPC por comunidades autónomas contiene series para: - Cada comunidad autónoma - Cada tipo de índice - Cada período Puedes filtrar las series con el parámetro 'tv' (formato: ID_VARIABLE:ID_VALOR).

ine_serie_metadata_operacion Busca series temporales usando filtros de metadatos dentro de una operación. Similar a ine_datos_metadata_operacion pero devuelve SERIES en lugar de datos. Útil para encontrar códigos de series específicas antes de pedir sus datos. EJEMPLO: Para encontrar la serie del IPC de transporte en Barcelona: - idOperacion: "IPC" - g1: "762:244082" (grupo ECOICOP: Transporte) - g2: "70:8" (provincia: Barcelona) La respuesta incluirá el código de la serie que coincide con esos filtros.

ine_periodicidades Lista todas las periodicidades disponibles en el INE. PERIODICIDADES COMUNES: - 1: Mensual (IPC, paro registrado) - 3: Trimestral (EPA, PIB) - 6: Semestral - 12: Anual (censos, encuestas estructurales) Cada estadística tiene una periodicidad que indica con qué frecuencia se publican nuevos datos.

ine_publicaciones Lista todas las publicaciones estadísticas disponibles del INE. Las publicaciones son documentos/informes que agrupan y presentan los datos de las operaciones. Cada publicación tiene una fecha de difusión programada. EJEMPLOS: - Índice de Precios de Consumo (publicación mensual) - Encuesta de Población Activa (publicación trimestral) - Cifras de Población (publicación semestral) Usa ine_publicacion_fecha_publicacion para ver las fechas de publicación.

ine_publicaciones_operacion Obtiene las publicaciones asociadas a una operación estadística específica. Una operación puede tener múltiples publicaciones con diferentes periodicidades o enfoques. EJEMPLO: La operación "IPC" tiene publicaciones como: - Índices nacionales mensuales - Índices por comunidades autónomas - Variaciones interanuales - Notas de prensa

ine_publicacion_fecha_publicacion Obtiene las fechas de difusión (calendario de publicación) para una publicación estadística. Muestra cuándo se han publicado y se publicarán nuevos datos. Útil para saber cuándo habrá datos actualizados disponibles. Incluye: - Fechas de publicaciones pasadas - Fechas programadas de próximas publicaciones

ine_clasificaciones Lista todas las clasificaciones estadísticas utilizadas por el INE. Las clasificaciones son sistemas jerárquicos para organizar datos. CLASIFICACIONES COMUNES: - CNAE: Clasificación Nacional de Actividades Económicas - ECOICOP: Clasificación del consumo (usada en el IPC) - CNO: Clasificación Nacional de Ocupaciones - NUTS: Nomenclatura de Unidades Territoriales - CIE: Clasificación Internacional de Enfermedades Cada clasificación tiene múltiples niveles de detalle.

ine_clasificaciones_operacion Obtiene las clasificaciones utilizadas en una operación estadística específica. Muestra qué sistemas de clasificación se usan para organizar los datos de esa operación. EJEMPLOS: - IPC usa ECOICOP (clasificación de productos de consumo) - EPA usa CNO (clasificación de ocupaciones) y CNAE (actividades económicas) - Comercio Exterior usa CNAE y clasificaciones arancelarias

ine_valores_hijos Obtiene valores hijos en una estructura jerárquica de una variable. Muchas variables del INE tienen estructuras de árbol (padre-hijo). EJEMPLOS: - Territorio: España → Comunidades Autónomas → Provincias → Municipios - Actividad económica: Sector → División → Grupo → Clase - Grupos ECOICOP: Grupo principal → Subgrupos CASO DE USO: Para obtener las provincias de Andalucía: - idVariable: "70" (provincias/territorio) - idValor: ID de Andalucía Resultado: Almería, Cádiz, Córdoba, Granada, Huelva, Jaén, Málaga, Sevilla

📚 Documentación y APIs

GET http://mcp.manalejandro.com/api-docs

Swagger UI - Documentación interactiva completa de la API REST con todos los endpoints disponibles.

GET http://mcp.manalejandro.com/health

Health Check - Verifica el estado del servidor.

🌐 API REST Directa

Además del protocolo MCP, puedes acceder directamente a los datos mediante endpoints REST:

GET /api/operaciones-disponibles

Lista todas las operaciones estadísticas disponibles

GET /api/operacion/:idOperacion

Información detallada de una operación (ej: IPC, EPA)

GET /api/datos-tabla/:idTabla

Datos completos de una tabla estadística

GET /api/datos-serie/:idSerie

Datos de una serie temporal específica

GET /api/variables

Lista todas las variables estadísticas

GET /api/series-operacion/:idOperacion

Todas las series de una operación

💡 Ejemplos de Uso

Consulta directa con curl:

curl "http://mcp.manalejandro.com/api/operaciones-disponibles?idioma=ES"

Consulta mediante MCP:

// Usa la herramienta ine_operaciones_disponibles
// desde tu cliente MCP (VS Code AI Toolkit, etc.)

ℹ️ Información

Servidor: MCP INE Server v1.0.0

Protocolo: Model Context Protocol (MCP) + REST API

Fuente de datos: Instituto Nacional de Estadística (INE)

Documentación MCP: modelcontextprotocol.io

🚀 MCP INE Server