EcuDataMCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MCP_HOST | No | Dirección de bind | 127.0.0.1 |
| MCP_PORT | No | Puerto del servidor | 8000 |
| LOG_LEVEL | No | Nivel de log (DEBUG, INFO, WARNING, ERROR) | INFO |
| MCP_TRANSPORT | No | Transporte: http o stdio | http |
| MCP_AUTH_TOKEN | No | Token Bearer opcional para /mcp | |
| MCP_SSL_KEYFILE | No | Clave para TLS directo | |
| MCP_REQUIRE_AUTH | No | Rechaza el arranque remoto sin token | 0 |
| MCP_SSL_CERTFILE | No | Certificado para TLS directo | |
| MCP_RATE_LIMIT_REQUESTS | No | Cuota por cliente/IP: número de solicitudes permitidas en la ventana de tiempo | 120 |
| MCP_RATE_LIMIT_WINDOW_SECONDS | No | Cuota por cliente/IP: longitud de la ventana de tiempo en segundos | 60 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_ecuadorA | Unified first-step search across CKAN datasets, organizations, gob.ec trámites and regulations, SERCOP contracts and SGR risk events. Drill down afterwards with the source-specific get_* tools. |
| lookup_ubicacionA | Look up Ecuador's provinces, cantons and parroquias with INEC codes, region and population. For parroquias, filter by canton and/or provincia. |
| search_eventos_riesgoA | Current and recent SGR (Gestión de Riesgos) risk events from the live COE feed: landslides, floods, structural damage, with location, status and impacts. No history; for past event dossiers use search_sgr_sitreps. |
| search_sgr_sitrepsA | SGR's archive of ~54 adverse-event dossiers 2016-2026 (earthquakes, rainy and fire seasons, volcanic activity) with status. Next: get_sgr_sitrep_archivos(evento_url) for the SITREP PDFs. |
| get_sgr_sitrep_archivosA | SITREP PDF links (national, provincial, cantonal) for one SGR event page from search_sgr_sitreps. Returns links, not contents. |
| list_sat_tsunamiB | SGR tsunami early-warning (SAT) stations with codes and coordinates. |
| search_sismosA | Recent earthquakes from the IG-EPN catalog feed: magnitude, depth, coordinates, time and place. Filter by text, minimum magnitude and days. |
| search_informes_igepnA | Search IG-EPN's PDF report archive: seismic bulletins and volcanic alerts/reports, by year and group. Next: get_informe_igepn to read one. For raw earthquake data use search_sismos. |
| get_informe_igepnA | Download and extract the text of one IG-EPN report from search_informes_igepn, re-located by exact nombre, grupo and anio (plus volcan when names repeat). pages limits the range (max 20/call). |
| get_metarA | Latest METAR/SPECI weather reports for an Ecuadorian aerodrome (ICAO code, e.g. SEQM), raw ICAO text with UTC times, from DGAC/AIS. |
| get_notamB | Active NOTAMs for an Ecuadorian aerodrome (ICAO code, e.g. SEQM): raw ICAO text plus DGAC's decoded fields. |
| get_sigmetA | Active SIGMETs for Ecuador's single FIR (SEFG): volcanic ash, turbulence, icing, storms. Empty means none active. |
| list_aip_aerodromosA | ICAO codes and names of aerodromes/helipads with a published AIP AD 2 page (DGAC eAIP). Next: get_aip_aerodromo. |
| get_aip_aerodromoA | Full published AIP AD 2 data sheet for one aerodrome (ICAO code): coordinates, runways, hours, services, frequencies, procedures. |
| search_datasetsA | Search CKAN open-data datasets (national portal by default; see source). Use sort="recent" without a query to browse new or updated datasets. Next: list_dataset_resources. |
| get_dataset_infoB | Metadata for one CKAN dataset: description, organization, tags, dates, license, update frequency and the publisher's source URL. |
| list_dataset_resourcesA | Files (resources) in a CKAN dataset with format, size, URL and dates, flagging name groups that look like periodic series. Next: preview_resource_data or query_resource_data. |
| get_resource_infoB | Metadata for one CKAN resource (file): format, size, MIME type, download URL and parent dataset. |
| preview_resource_dataA | First rows of a CKAN resource as a table: CSV/TSV, JSON/GeoJSON, XLS/XLSX/XLSB, ODS, and ZIP/tar.gz wrapping a CSV. Max 5 MB; for DataStore resources prefer query_resource_data. |
| detect_series_patternA | Tell whether a dataset's periodic files are cumulative (newest file suffices) or incremental (combine all) by comparing period values in the two newest files. Heuristic over up to 500 rows each. |
| download_resourceA | Raw bytes of a CKAN resource, base64-encoded, for formats the preview can't parse. Max 5 MB. Use format="json"; text only confirms the download. |
| query_resource_dataA | Query a tabular CKAN resource through the DataStore without downloading it: full-text query, exact filters (filters_json), sort and pagination. |
| search_organizationsB | Search the institutions publishing on a CKAN portal (98+ on the national one: INEC, SRI, MSP, BCE...). |
| get_organization_infoB | One CKAN organization and its datasets; the way to browse large publishers (e.g. sri-servicio-de-rentas-internas). query filters dataset titles. |
| list_categoriesA | Thematic categories of a CKAN portal with dataset counts; pass a name as search_datasets' category. |
| get_category_infoA | Details and sample datasets for one CKAN thematic category (name from list_categories). |
| get_sri_ruc_infoA | Public SRI record for one 13-digit RUC: name, status, type, activity, dates and registered establishments. No tax amounts. |
| search_sri_rucA | Find SRI taxpayers by partial razón social or trade name (min 4 characters) when the RUC is unknown. SRI caps results at 100. |
| read_pdfA | Extract text from a PDF at a direct URL (max 5 MB, 20 pages per call; pages selects a range). No OCR: scanned PDFs come back empty. |
| list_zip_contentsA | List a remote ZIP's members (name, size) via HTTP Range requests, without downloading it; works for archives far beyond 5 MB. No ZIP64. |
| investigate_datasetA | One-step shortcut: search CKAN, pick the top dataset and preview its first readable resource. Use the individual tools when the top hit isn't the right one. |
| search_tramitesA | Search gob.ec government procedures (trámites). Pass institution_id (SRI=8, IESS=5, Registro Civil=23, ANT=62, Cancillería=16; others via list_instituciones) for relevant results. |
| get_tramite_infoA | One gob.ec trámite's requirements, beneficiaries, cost and responsible institution (tramite_id from search_tramites). |
| get_tramite_estadisticasB | Monthly attentions and complaints for one gob.ec trámite since mid-2021. |
| list_institucionesA | List or search public institutions registered on gob.ec, with their IDs. |
| get_institucion_infoC | One gob.ec institution's acronym, sector, description and websites. |
| search_andaA | Search INEC's ANDA catalog of 437+ surveys and censuses; the broadest INEC index. Entries without microdata point to search_inec_estadisticas. Next: get_anda_survey_info. |
| get_anda_survey_infoA | Full metadata for one ANDA survey (string idno from search_anda): scope, variables, microdata availability and access terms. |
| download_anda_microdataA | Direct links to an ANDA survey's microdata files (accepts ANDA's research-use terms). Check get_anda_survey_info first; returns links to multi-MB ZIPs. |
| search_inec_estadisticasA | INEC's ~75 statistical topic pages on ecuadorencifras.gob.ec (IPC, ENEMDU, pobreza, cuentas nacionales...), where published aggregate series live. Next: get_inec_estadistica_files. |
| get_inec_estadistica_filesA | File links (bulletins, methodology, historical series) on one INEC topic page from search_inec_estadisticas. |
| search_inec_publicacionesA | Every INEC post on Ecuador en Cifras, newest first; use for the latest release of an operation (topic pages can go stale). Next: get_inec_publicacion_archivos. |
| get_inec_publicacion_archivosA | File links (PDF/XLSX/CSV/ZIP) in one INEC publication (id or URL from search_inec_publicaciones). |
| search_biinec_extrasA | Small curated list of INEC BIINEC registries found nowhere else (e.g. environmental modules). A last resort; not a live BIINEC search. |
| search_infomies_bases_mensualesA | infoMIES monthly program databases, serie "anc" (economic inclusion) or "is" (social inclusion). Closed years have one year-end file. .rar files: links only. |
| search_infomies_boletines_zonalesA | infoMIES zonal bulletins: modo="zonal" (per-zone .rar, 2017-2021, needs zona) or "consolidado" (yearly XLSX 2021-2026, still updated). Returns links. |
| search_regulacionesA | Search or list regulations published on gob.ec, with Registro Oficial references when available. |
| get_regulacion_infoB | One gob.ec regulation's type, Registro Oficial reference, description and PDF link. |
| get_sipa_resumen_indicadoresA | Monthly PDF links of SIPA's (MAG) "Resumen de Indicadores" for one year, 2018 onward. |
| list_sut_indicadoresA | Ministerio del Trabajo SUT Power BI dashboards (contracts since 2015 by industry/province/gender, labor demand, gender policy). Next: get_sut_indicador_schema, then query_sut_indicador. |
| get_sut_indicador_schemaA | Queryable fields of one SUT dashboard: columns, measures ([medida]) and date levels, for query_sut_indicador. |
| query_sut_indicadorB | Live query of one SUT dashboard's data model with any combination of campos, optional equality filtros (plain columns only) and a row limite. |
| list_contraloria_informesA | Contraloría's quarterly CSVs of audit reports approved for any public institution, plus annual control plans. Next: get_contraloria_informe. |
| get_contraloria_informeA | Rows of one Contraloría audit-reports CSV (one row per approved report), or metadata and a read_pdf pointer for an annual plan. |
| list_iess_coleccionesA | IESS document collections (statistical bulletins, actuarial studies, audit reports) with years and counts. Next: get_iess_archivos. |
| get_iess_archivosA | Documents in one IESS collection with direct links. anio is required for informes_auditoria. |
| get_certificado_cumplimiento_patronalA | Whether an employer (RUC) or person (cédula) is current on IESS contributions. A compliance check, not a headcount; for employees use get_financials' n_empleados. |
| search_contratosA | Search SERCOP public procurement (OCDS) by keyword (min 3 characters), year, buyer or supplier. |
| get_contrato_infoA | Full OCDS record of one SERCOP procurement process (ocid from search_contratos): buyer, tender, awards, contracts. |
| search_indicadores_bceA | Search BCEData indicator groups (monetary, fiscal, external, real sector), matching series names too. Not CPI or poverty (INEC). First call after 24h can take 10-15 s. Next: get_indicador_bce. |
| get_indicador_bceA | Time series of one BCEData group (id_grupo from search_indicadores_bce), with optional YYYY-MM range, frequency and unit. |
| search_bce_iemA | Search the Excel tables of BCE's monthly IEM bulletin (trade by country, debt, fiscal, oil, GDP detail). historico=true searches past bulletins. Next: get_bce_iem_table. |
| get_bce_iem_tableA | One IEM XLSX table (table_id from search_bce_iem): date-filterable series for the standard layout, a faithful preview otherwise. boletin_numero selects a past bulletin. |
| search_bce_publicacionesA | BCE's ~30 most recent published reports and bulletins (editorial feed, not data series), filterable by title and format. Returns links. |
| search_bce_remesasB | BCE worker-remittance file links: historical series, methodology note and, since July 2025, microdata-based monthly databases (a distinct series). Returns links. |
| search_bce_paginasA | BCE publication pages with file archives: indices (sector bulletins, price and confidence indices, FX, balance of payments; some back to 2004) or cuentas_nacionales (annual, quarterly, regional accounts, input-output, IMAEC). Next: get_bce_pagina_archivos(pagina_id). |
| get_bce_pagina_archivosA | Files of one BCE publication page (pagina_id from search_bce_paginas): title, URL and format, most recent first. anio filters the indices catalog by year. |
| search_bce_precios_comexA | BCE foreign-trade price-index files by import use category and export product (oil, shrimp, banana, cacao...). BCEData only has the aggregates. Returns links. |
| search_bce_calendarioB | BCE's forward-looking statistical release calendar: dates, category, periodicity and reference period. solo_proximas=true keeps upcoming releases. |
| list_bce_indicadores_diariosB | BCE daily and monthly indicator widgets outside BCEData: riesgo país (daily since 2004), gold, WTI, bonds, payments, reserves, fiscal and external series. Next: get_bce_indicador_diario. |
| get_bce_indicador_diarioA | One BCE daily/monthly indicator (archivo and codigo from list_bce_indicadores_diarios): the last ultimos_n points or a date range, capped at 366 rows. |
| get_cenace_tableroA | CENACE live grid snapshot: generation mix and demand now, yesterday, month or year to date. No historical queries. |
| list_arconel_reportesA | Report types, years (1998 on) and company groups in ARCONEL's electricity statistics builder. Next: get_arconel_reporte. |
| get_arconel_reporteA | Run one ARCONEL report (e.g. "Balance Energía" for a year) and return its rows. Slow, ~50 rows per page; max_paginas caps work and completo says if everything was read. |
| search_cortesA | Scheduled power-cut PDFs of one utility: eeq (Quito, 2023-2024 blackout crises) or centrosur (Azuay, Cañar, Morona Santiago, 2023 on). Next: get_cortes_horarios with a file's archivo. |
| get_cortes_horariosA | Parse one power-cut PDF (archivo from search_cortes) into rows: date, time blocks without power, location (EEQ: substation; Centrosur: province/canton/zone) and sectors. query filters by place. |
| get_energia_ecuador_snapshotB | Wayback Machine snapshot (2024-04-24) of the national blackout-schedule portal energia-ecuador.com; only EEQ's Pichincha rotation survived. |
| list_archivo_seccionesA | List the sections of one institution's document archive: ARCSA sanitary registry, Superbancos and SEPS statistics, INEVAL evaluation datasets, SGR and Educación Superior libraries, or SIPA agricultural statistics. Next: get_archivo_seccion(fuente, seccion). |
| get_archivo_seccionA | List the downloadable files (title, URL, format) in one section from list_archivo_secciones. Returns links, not file contents; download large files directly (preview/download tools cap at 5 MB). |
| search_capas_geoA | Search layers of a GeoServer geoportal: inamhi (rainfall normals and anomalies, WRF forecast grids, watersheds) or mag (agro zoning, land cover, agricultural censuses, rural cadastre, agroclimatic risk). solo_wfs=true keeps layers with attribute data. |
| get_capa_geo_datosA | Sample up to 20 features' attributes from a WFS-enabled layer (capa from search_capas_geo). A preview, not a spatial query: no bbox or filters, and geometry is dropped. |
| search_archivosA | File links from one institution's catalog, filtered by text: sri_datasets, sri_recaudacion (SRI), mef, senae (fiscal), censo (Census 2022), minedec (enrollment), senescyt, msp (vaccine gazettes), cnig (gender violence), trabajo_boletin, salarios, arcotel_boletines, arcotel_mensuales. Links, not contents. |
| search_companiasA | Search Supercías' registry of 226k+ companies by name or RUC: legal status, incorporation, representative, capital, CIIU, address. First call after 6h can take 30-40 s. |
| get_compania_infoA | Supercías registry record for one company by RUC: status, incorporation, representative, capital, CIIU, address. No financials. |
| search_rankingA | Rank Supercías companies by financial indicators for one fiscal year (last five years), optionally by CIIU letter. descending=true for top-N by a column. |
| get_financialsA | One company's Supercías financial history (last five fiscal years): revenue, assets, equity, profit, employees and ratios. Takes expediente or RUC. |
| search_auditoresA | Search Supercías' registry of 1,447 authorized external auditors by name or ID. |
| get_auditor_infoA | One external auditor's authorization, nationality and contact details by RUC or cédula. |
| search_cepalstat_indicadoresA | Search CEPALSTAT's 2,059 regional indicators (demographic, economic, environmental, SDG). Next: get_cepalstat_indicador for Ecuador's values. |
| get_cepalstat_indicadorB | Observations of one CEPALSTAT indicator for one country (Ecuador by default), with dimension ids decoded to labels. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| explorar_datos | Guía para encontrar y previsualizar datasets del portal CKAN de Ecuador. |
| consultar_tramite | Guía para requisitos, costo y pasos de un trámite en gob.ec. |
| investigar_contrato | Guía para buscar contrataciones SERCOP/OCDS por palabra clave. |
| buscar_regulacion | Guía para encontrar normas y referencias de Registro Oficial. |
| explorar_tema | Guía para recorrer datasets, trámites, regulaciones, contratos y riesgos de un tema en una sola pasada. |
| buscar_inec | Guía para buscar una operación estadística del INEC probando ANDA, Ecuador en Cifras y, como último recurso, el Banco de Datos Abiertos (BIINEC). |
| monitorear_riesgos | Guía para consultar eventos SGR COE y estaciones SAT tsunami. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| fuentes_ecuador | Catálogo de fuentes gubernamentales integradas en este servidor. |
| provincias_ecuador | 24 provincias con código INEC, capital y región natural. |
| cantones_ecuador | Cantones con código INEC, provincia, región y población estimada. |
| parroquias_ecuador | Parroquias con código INEC, cantón y provincia (~1040). |
| instituciones_clave | IDs frecuentes para search_tramites(institution_id=...). |
TDQS
Scored across 90 tools
Most tools target distinct sources and descriptions explicitly cross-reference the next step, but several near-duplicates create real overlap: three CKAN entry points (search_ecuador, search_datasets, investigate_dataset) and multiple file/archive tools (search_archivos, list_archivo_secciones, get_archivo_seccion, download_resource, list_zip_contents). With 90 tools the sheer volume of similar search_*/get_* pairs makes misselection likely.
Names are overwhelmingly consistent snake_case with a verb-first prefix (search_, get_, list_, download_, query_, read_), making the pattern predictable. A few deviations in verb choice (lookup_ubicacion, investigate_dataset, detect_series_pattern) are minor and still readable.
90 tools is far beyond a comfortable agent-facing surface and exceeds the 50+ threshold; even accounting for the very broad multi-institution scope, this is unwieldy and error-prone. Many tools could be grouped or scoped by source family.
The search-to-get/list-to-download/preview lifecycle is covered for virtually every source across INEC, BCE, SRI, SERCOP, CEPALSTAT and more, with clear fallbacks when microdata or history is absent. Gaps are minor (some sources return links only, no OCR for scanned PDFs).