EcuDataMCP
ES EN
GitHub Instalar

Atlas de datos públicos · v0.15.0

Todo el Estado ecuatoriano, a una pregunta.

EcuDataMCP conecta tu asistente de IA con 82 fuentes oficiales —del Banco Central al SERCOP— y responde con el enlace de origen de cada dato. Código abierto, solo lectura, sin registro.

Instalar en 1 minuto Explorar las 82 fuentes →
+7 temas

Cada punto es una fuente oficial, coloreada por tema. La posición es ilustrativa; pasa el cursor o enfoca un punto para ver cuál es.

82fuentes oficiales
85tools públicas
14temas
80/82fuentes en línea según el catálogo
0registros o claves

Cómo funciona

Una pregunta, un camino trazable.

Tu asistente elige la tool adecuada, consulta en vivo el portal oficial y te devuelve el dato con su cita. Nada se copia ni se inventa.

Aviso: Algunas definiciones, parámetros y descripciones de herramientas fueron generados o asistidos por IA. Pueden estar incompletos o desactualizados; una herramienta puede devolver resultados parciales, rechazar parámetros válidos o comportarse inesperadamente cuando cambia la fuente oficial. Verifica siempre la respuesta contra la fuente enlazada y revisa manualmente los resultados antes de usarlos para decisiones importantes.
asistente · ecudata
solo lectura · en vivo

El backstage

Servidor MCP de código abierto.

EcuDataMCP corre como un servidor en Python construido con el SDK oficial de MCP, expuesto sobre HTTP Streamable o stdio. No hay base de datos propia: cada tool llama en vivo al portal oficial correspondiente (CKAN, gob.ec, SERCOP, BCE, Supercías, IG-EPN, SGR) y devuelve la respuesta formateada.

Ver los 85 tools en la Referencia →

Fuentes

82 fuentes oficiales, siempre citadas.

EcuDataMCP no almacena estos catálogos: cada consulta va en vivo a la institución de origen. Elige un tema para ver sus fuentes, o consulta la página completa.

Economía y finanzas · 21

Banco Central del Ecuador (BCE)

BCEData en línea

Catálogo macroeconómico completo: monetario/financiero, finanzas públicas, sector externo y sector real

Banco Central del Ecuador (BCE)

Información Estadística Mensual (IEM) en línea

Boletín mensual con ~60 tablas XLSX individuales, más rico que BCEData en desagregación

Banco Central del Ecuador (BCE)

Indicadores en línea en línea

Riesgo país, precio del oro y del petróleo, bonos soberanos y otras series verdaderamente diarias, sin agregar a mensual

Banco Central del Ecuador (BCE)

Remesas de trabajadores en línea

Serie histórica y bases mensuales, con la desagregación por entidad disponible desde julio de 2025

Banco Central del Ecuador (BCE)

Índices y publicaciones en línea

Archivo histórico por serie de boletines sectoriales y últimas publicaciones editoriales del BCE

Banco Central del Ecuador (BCE)

Precios de comercio exterior en línea

Índices de precios de importación y exportación desagregados por categoría/producto

Banco Central del Ecuador (BCE)

Cuentas Nacionales en línea

Cuentas anuales, trimestrales y regionales, retropolación del PIB desde 1965, matrices insumo-producto, TOU, CEI, MEI e IMAEC mensual

Banco Central del Ecuador (BCE)

Calendario de publicaciones en línea

Fechas programadas de publicación para el año completo, por categoría y periodicidad

Servicio de Rentas Internas (SRI)

SRI Datasets en línea

Archivos públicos de recaudación, ventas/compras, vehículos y más

Servicio de Rentas Internas (SRI)

Consulta de RUC en línea

Datos públicos de un contribuyente por número de RUC o razón social

Superintendencia de Compañías (Supercías)

Directorio de compañías en línea

Directorio de compañías (226k+): representante legal, capital, CIIU

Superintendencia de Compañías (Supercías)

Ranking financiero build local

Financieros por balance (ingresos, activos, ROE, ~38 ratios) por año fiscal desde 2008 (ratios desde 2018); requiere build local

Superintendencia de Bancos (Superbancos)

Superbancos en línea

Boletines financieros y de series, indicadores de solidez (CAMEL, morosidad, liquidez), volumen de crédito, captaciones y colocaciones, seguridad social y estudios

Superintendencia de Economía Popular y Solidaria (SEPS)

Estadísticas SEPS en línea

26 secciones de estadísticas del sector financiero popular y solidario y de la economía popular y solidaria

Ministerio de Economía y Finanzas (MEF)

Estadística fiscal SPNF en línea

Cuentas fiscales del Sector Público No Financiero bajo metodología FMI/GFSM, más el archivo histórico de SENAE

Bolsa de Valores de Guayaquil

Estadísticas históricas en línea

Negociaciones de acciones, obligaciones, papel comercial, titularizaciones y bonos del Estado desde 2019, dividendos desde 2002 y ofertas públicas (XLSX)

Bolsa de Valores de Quito

Estadísticas bursátiles en línea

Cotizaciones históricas, emisiones, renta variable, sector público y boletines al cierre y semanales (XLS/XLSX/PDF); las páginas Infolab requieren login y no se incluyen

Ministerio de Producción (Turismo)

Boletín de Cifras del Sector Turismo en línea

Boletines mensuales en PDF: llegadas por nacionalidad, ocupación, áreas protegidas, catastro (nov 2025+)

Corporación Financiera Nacional (CFN)

Estadísticas CFN en línea

Crédito y desembolsos por provincia, estados financieros mensuales, inversiones y garantías del FNG

Gremios privados

FEDEXPOR — Expordata en línea

Informe mensual de comercio exterior (PDF en Google Drive)

Gremios privados

AEADE — ventas de vehículos en línea

Boletines mensuales de ventas de vehículos y anuarios del sector automotor

Qué puedes preguntar

En lenguaje natural, sin buscar portal por portal.

Ocho preguntas reales, con la respuesta que devolvió EcuDataMCP, las tools que usó y la fuente oficial.

“¿Qué necesito para sacar el pasaporte por primera vez?”

Si eres mayor de 18 años: comprobante de pago (en línea, banco corresponsal o en la agencia) y cédula física o digital vigente; si renuevas, el pasaporte anterior. En Quito, Guayaquil y Cuenca lo entregan el mismo día; en otras agencias, en 24 a 72 horas.

“¿Hubo temblores fuertes en Ecuador esta semana?”

El más fuerte en territorio ecuatoriano fue de magnitud 4,8, a 45,7 km de Salinas (Santa Elena), el 7 de noviembre a las 17:17, a 2,4 km de profundidad. También hubo uno de 3,7 cerca de Pasaje (El Oro).

“¿Cuánto dinero envían los migrantes al Ecuador?”

En 2025 ingresaron US$ 7.728 millones en remesas, 18,2 % más que en 2024 (US$ 6.540 millones). En el segundo trimestre de 2026 llegaron US$ 2.041 millones.

“¿Qué datos públicos hay de Corporación Favorita?”

RUC 1790016919001. Sociedad anónima activa, constituida el 30 de noviembre de 1957 en Quito, con capital suscrito de US$ 900 millones. Actividad: comercio al por menor (CIIU G4711.01). Último balance presentado: 2025.

“¿Cuánto contrató el sector público en Manta en 2025?”

253 procesos por US$ 34,7 millones (valor adjudicado o estimado de 211 procesos con monto). Los mayores compradores fueron el Hospital General Manta (US$ 16,6 millones) y el Municipio de Manta (US$ 9,4 millones).

“¿Hay cortes de luz programados en Ambato o el Puyo?”

Sí, 3 avisos vigentes. Por ejemplo: lunes 9 de noviembre, de 09:00 a 14:00, en el barrio Callate San Antonio (Píllaro); martes 10, de 10:00 a 14:00, en el barrio La Libertad (Puyo).

“¿Qué porcentaje de hogares tiene internet en Manta?”

Según el Censo 2022, el 65,0 % de los hogares de Manta dispone de internet fijo (66,6 % en el área urbana y 33,1 % en la rural), frente al 47,4 % de Manabí y el 60,9 % nacional.

“¿Dónde están los datos del Censo 2022 sobre internet en los hogares?”

En el tabulado «Tecnologías de la información» del Censo 2022 (03_2022_CPV_TIC.xlsx), con hogares por disponibilidad de internet, computadora y celular por provincia, cantón y parroquia.

Respuestas extraídas el 9 de noviembre de 2026 con EcuDataMCP v0.15.0. Cada respuesta se obtuvo con una consulta real a la fuente oficial indicada; los valores pueden haber cambiado desde entonces.

Conecta tu asistente

Listo en un minuto.

Funciona con cualquier cliente MCP. Elige el tuyo y copia la configuración.

  • Solo lectura: nunca modifica datos públicos
  • Sin claves ni registro
  • Código abierto con licencia MIT
  • Disponible por PyPI, Docker o HTTP
Opción rápida: deja que tu asistente lo instale

Si tu asistente tiene acceso a una terminal, pégale el link del repositorio:

Clona https://github.com/DweskZ/EcuDataMCP, instala sus dependencias con uv sync,
y regístralo como servidor MCP en mi cliente usando modo stdio con
`uv run --directory <ruta-del-clon> python main.py --transport stdio`.
Verifica que el servidor responda antes de darlo por terminado.

Revisa siempre lo que tu asistente cambie (archivos de configuración, comandos ejecutados) antes de confirmar. Solo funciona con asistentes que pueden ejecutar comandos por su cuenta: hoy eso es Claude Code, Codex, Cursor y Windsurf en modo agente.

Claude Desktop ejecuta el paquete de PyPI con uv, sin levantar ningún servidor. Agrega esto a ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows) y reinicia Claude Desktop. También puedes instalar el archivo .mcpb adjunto a cada release de GitHub como extensión.

{
  "mcpServers": {
    "ecuador-datos": {
      "command": "uvx",
      "args": ["ecuador-mcp", "--transport", "stdio"]
    }
  }
}

Alternativa: conectarte a un servidor HTTP que ya corre (requiere Node.js 18+ para mcp-remote)

{
  "mcpServers": {
    "ecuador-datos": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://localhost:8000/mcp"]
    }
  }
}

Un comando, y listo: Claude Code lanza el servidor por stdio con uvx. Reinicia la sesión para ver los tools.

claude mcp add ecuador-datos -- uvx ecuador-mcp --transport stdio

Alternativa: servidor HTTP que ya corre

claude mcp add --transport http ecuador-datos http://localhost:8000/mcp

Abre Cursor Settings, busca "MCP" y agrega un servidor nuevo, o edita ~/.cursor/mcp.json directamente:

{
  "mcpServers": {
    "ecuador-datos": {
      "command": "uvx",
      "args": ["ecuador-mcp", "--transport", "stdio"]
    }
  }
}

Alternativa: servidor HTTP que ya corre

{
  "mcpServers": {
    "ecuador-datos": {
      "url": "http://localhost:8000/mcp",
      "transport": "http"
    }
  }
}

Para clientes remotos o despliegues propios. Docker exige un token (MCP_AUTH_TOKEN); el endpoint queda en http://localhost:8000/mcp. Sin Docker, uv run lo levanta en el mismo puerto.

MCP_AUTH_TOKEN="$(openssl rand -hex 32)" docker compose up -d
# o, sin Docker:
uv sync && uv run python main.py --transport http --port 8000

Comprueba que responde

curl http://localhost:8000/health
Otros clientes: VS Code, ChatGPT, Codex, Gemini CLI, Le Chat (Mistral), Windsurf, HuggingChat

VS Code

Agrega a tu archivo mcp.json (ejecuta MCP: Open User Configuration desde la paleta de comandos):

{
  "servers": {
    "ecuador-datos": {
      "url": "http://localhost:8000/mcp",
      "type": "http"
    }
  }
}

ChatGPT

*Disponible para planes pagos (Plus, Pro, Team, Enterprise).*

  1. Ve a Settings > Apps and connectors
  2. Abre Advanced settings y habilita Developer mode
  3. En Settings > Connectors > Browse connectors, haz clic en Add a new connector
  4. Configura la URL: http://localhost:8000/mcp

Codex

Guarda la configuración en ~/.codex/config.toml (bloque [mcp_servers.ecuador-datos] con url). Para usar el servidor por stdio en vez de HTTP: codex mcp add ecuador-datos -- uvx ecuador-mcp --transport stdio.

codex mcp add ecuador-datos --url http://localhost:8000/mcp

Gemini CLI

Agrega a ~/.gemini/settings.json:

{
  "mcpServers": {
    "ecuador-datos": {
      "httpUrl": "http://localhost:8000/mcp"
    }
  }
}

Le Chat (Mistral)

  1. Ve a Intelligence > Connectors
  2. Add connector > Custom MCP Connector
  3. Nombre: "Ecuador Datos" / URL: http://localhost:8000/mcp

Windsurf

Agrega a ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "ecuador-datos": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://localhost:8000/mcp"]
    }
  }
}

HuggingChat

  1. En el chat, haz clic en el ícono + > MCP Servers > Manage MCP Servers
  2. Add Server con nombre "Ecuador Datos" y URL http://localhost:8000/mcp

Preguntas frecuentes

¿Tienes más preguntas?

¿Qué es EcuDataMCP?

Un servidor MCP (Model Context Protocol) de código abierto que ayuda a tu asistente de IA a descubrir y consultar datos abiertos del gobierno de Ecuador: datasets, trámites, regulaciones, contratos públicos, riesgos, sismos, indicadores del Banco Central y compañías.

¿Qué es MCP?

Model Context Protocol es un estándar abierto para conectar asistentes de IA con herramientas y fuentes de datos externas, manteniendo el control sobre qué puede hacer el modelo y qué datos puede leer.

¿Los datos son oficiales?

Sí. Cada respuesta proviene en vivo del portal de la institución (BCE, INEC, SRI, Supercías, SERCOP…) y trae el enlace para verificarla.

¿Qué asistentes puedo usar?

Cualquier cliente compatible con MCP: Claude Desktop, Claude Code, Codex, ChatGPT (planes pagos), Cursor, VS Code, Gemini CLI, Le Chat, Windsurf, HuggingChat, y más.

¿Necesito una API key?

No. Todas las fuentes que usa el servidor son datos públicos sin autenticación. (El endpoint HTTP puede protegerse con tu propio token, MCP_AUTH_TOKEN.)

¿Es esto un servicio oficial del gobierno ecuatoriano?

No. EcuDataMCP es un proyecto independiente de código abierto que consulta las mismas fuentes públicas que ya publica el Estado ecuatoriano. No está afiliado a ninguna institución.

¿El servidor guarda mis preguntas?

No hay telemetría externa. El servidor corre localmente en tu máquina y cada consulta va directo del cliente MCP al portal oficial correspondiente. Lo único que se registra son contadores locales de uso por tool (nombre, resultado y duración, nunca los argumentos).

¿Qué formatos soporta?

Preview en memoria de CSV, TSV, JSON, GeoJSON y XLSX; consulta tabular filtrada vía el DataStore de CKAN cuando el recurso lo soporta.

Algo no funciona, ¿dónde busco?

Empieza por curl http://localhost:8000/health. Si responde, el problema suele estar en la configuración del cliente o en el portal de origen. Revisa la sección Solución de problemas más abajo.

¿Puedo contribuir?

Sí, el proyecto es MIT y acepta pull requests. Ve la guía en Cómo colaborar.

Solución de problemas

¿Algo no funciona?

Empieza por confirmar que el servidor está vivo. Si responde, el problema casi siempre está en la configuración del cliente o en el portal de origen, no en EcuDataMCP.

curl http://localhost:8000/health

Debe devolver {"status":"ok", "version": ...}. Si no responde, el servidor no está corriendo o escucha en otro puerto.

Mi cliente no muestra ningún tool

Revisa, en orden: (1) que el servidor esté corriendo (/health responde); (2) que la URL termine en /mcp, no en / ni en /health; (3) que el JSON de configuración sea válido (una coma de más lo invalida en silencio); y (4) que hayas reiniciado el cliente por completo después de editar la configuración. Claude Desktop, Cursor y Windsurf solo leen el archivo al arrancar.

Claude Desktop o Windsurf: npx no se encuentra

La alternativa con mcp-remote (y la configuración de Windsurf) necesita Node.js 18+ instalado y en el PATH. Instálalo desde nodejs.org y reinicia el cliente. Alternativa sin Node: usa modo stdio con uvx ecuador-mcp --transport stdio, o con "command": "uv" y "args": ["run", "--directory", "<ruta-del-clon>", "python", "main.py", "--transport", "stdio"].

El puerto 8000 ya está en uso

Arranca el servidor en otro puerto (uv run main.py --port 8007, o MCP_PORT=8007 docker compose up -d) y cambia la URL del cliente a http://localhost:8007/mcp.

En modo stdio el servidor se cierra al instante

Corre el mismo comando a mano en una terminal para ver el error real. Las causas típicas son una ruta incorrecta en --directory, no haber corrido uv sync en el clon, o que uv no esté en el PATH que ve el cliente (en ese caso, usa la ruta absoluta a uv).

ChatGPT o Le Chat no pueden conectarse a localhost

Los clientes web corren en la nube y no ven tu máquina. Necesitas exponer el servidor con una URL pública HTTPS (un túnel o un despliegue propio) y, en ese caso, activar MCP_REQUIRE_AUTH=1 con un MCP_AUTH_TOKEN. Nunca expongas el servidor sin token.

Error 401, 429 o 503 del servidor

401: el servidor exige token (MCP_AUTH_TOKEN) y el cliente no lo envía como Authorization: Bearer .... 429: superaste el límite de solicitudes por ventana (MCP_RATE_LIMIT_REQUESTS, 120 por 60 s por defecto); espera o súbelo en uso local. 503: demasiadas solicitudes simultáneas (MCP_MAX_CONCURRENT_REQUESTS, 8 por defecto).

Error 403 o timeout del portal de Datos Abiertos

www.datosabiertos.gob.ec a veces rechaza conexiones que vienen de fuera de Latinoamérica (error 403). Si ves esto, corre el servidor desde una conexión con salida en Ecuador o la región (por ejemplo, una VPN). Los tools de trámites e instituciones usan otro portal y no tienen este problema. Los portales del Estado también tienen caídas propias: si un solo tool falla y los demás responden, reintenta más tarde.

Error de certificado TLS / SSL

Algunos portales oficiales han publicado certificados vencidos o con la cadena incompleta (el de Datos Abiertos venció en julio de 2026). Para ese portal existe un reintento opt-in: CKAN_INSECURE_TLS=1 en tu .env. Úsalo solo mientras dure la falla del portal y quítalo después.

El preview sale cortado o dice que el archivo es muy grande

Es intencional: las descargas se limitan a 5 MB y la descompresión de ZIP/tar.gz a 20 MB. Para recursos grandes usa query_resource_data (filtra en el DataStore de CKAN sin bajar el archivo) o list_zip_contents para ver qué trae un ZIP y read_zip_member para leer uno de sus archivos sin bajar el ZIP entero.

Necesito más detalle para reportar un bug

Arranca con LOG_LEVEL=DEBUG, reproduce el error y abre un issue en GitHub con el tool, los parámetros, la salida de /health y el log. No incluyas tokens.