Public data atlas · v0.15.0
EcuDataMCP connects your AI assistant to 82 official sources —from the Central Bank to SERCOP— and answers with the origin link for every figure. Open source, read-only, no sign-up.
Each dot is an official source, colored by theme. Positions are illustrative; hover or focus a dot to see which one it is.
How it works
Your assistant picks the right tool, queries the official portal live, and hands the figure back with its citation. Nothing is copied or made up.
The backstage
EcuDataMCP runs as a Python server built with the official MCP SDK, exposed over Streamable HTTP or stdio. There is no database of its own: every tool calls the matching official portal live (CKAN, gob.ec, SERCOP, BCE, Supercías, IG-EPN, SGR) and returns the formatted response.
Sources
EcuDataMCP never stores these catalogs: every query goes live to the originating institution. Pick a theme to see its sources, or open the full page.
Full macroeconomic catalog: monetary/financial, public finance, external sector and real sector
Monthly bulletin with ~60 individual XLSX tables, richer detail than BCEData
Country risk, gold and oil prices, sovereign bonds and other genuinely daily series, not rolled up to monthly
Historical series and monthly datasets, including the per-entity breakdown available since July 2025
Per-series historical file archive of sector bulletins, plus the BCE's recent editorial publications feed
Disaggregated import/export price indices by category/product
Annual, quarterly, and regional national accounts, PIB retropolation since 1965, input-output matrices, TOU, CEI, MEI, and monthly IMAEC
Scheduled release dates for the full year, by category and periodicity
Public files on tax collection, sales/purchases, vehicles, and more
Company directory (226k+): legal representative, capital, CIIU code
Financial statement data (revenue, assets, ROE, ~38 ratios) per fiscal year since 2008 (ratios since 2018); requires a local build
Financial and series bulletins, soundness indicators (CAMEL, NPLs, liquidity), credit volume, deposits and loans, social security and studies
26 statistics sections for the popular/solidarity financial sector and non-financial popular economy organizations
Non-financial public sector fiscal accounts under IMF GFSM methodology, plus SENAE's historical archive
Trades in shares, bonds, commercial paper, securitizations and government bonds since 2019, dividends since 2002 and public offers (XLSX)
Historical quotes, issues, equities, public sector and closing and weekly bulletins (XLS/XLSX/PDF); Infolab pages need a login and are not included
Monthly PDF bulletins: arrivals by nationality, occupancy, protected areas, establishment register (Nov 2025+)
Credit and disbursements by province, monthly financial statements, investments and FNG guarantees
Monthly foreign-trade report (PDF on Google Drive)
Monthly vehicle-sales bulletins and automotive yearbooks
Statistical topics, aggregate series, bulletins and published files
Public WordPress REST API covering INEC's 1,700+ publications and bulletins, with full-text search
Complementary statistical registries and curated modules
Results tabulados (incl. household ICT by province and canton), microdata and methodology documents
INEC's catalog of surveys and censuses (437 surveys)
24 provinces + 225 cantons, per INEC's official Geographic Classifier
Historical administrative K-12 enrollment registry, 2009-present
2009-2010 to 2024-2025, start and end cuts, with dictionaries; thematic files
Databases for Ser Bachiller, Ser Estudiante, Ser Maestro, Ser Profesional, and Llece
Results, electoral roll by parish, candidates and dictionaries for 19 election processes (SPSS)
Methodology sheets, indicator reports, competitiveness index, CTI indicator inventory
~1,259 documents (PAC, LOES/SNNA regulations, agreements, ACTI indicators) across 17 categories
737 WFS layers of official cartography: boundaries, settlements, roads, rivers (1:1M, 1:50k, 1:25k)
Operational snapshot of demand and generation, monthly commercial-transactions bulletin (2019 onward) and report library
Centrosur's scheduled power cuts (Azuay, Cañar, Morona Santiago), 2023 onward, including the 2024 crisis
Scheduled power cuts of Empresa Eléctrica Quito, 2023 and 2024 blackout crises (26 PDFs); same search_cortes and get_cortes_horarios tools with distribuidora="eeq"
Maintenance outage notices in Imbabura, Carchi and northern Pichincha (latest 100); search_cortes with distribuidora="emelnorte"
Scheduled maintenance on San Cristóbal, Santa Cruz and Isabela (latest 100); search_cortes with distribuidora="elecgalapagos"
Scheduled work for the coming days in Tungurahua and Pastaza, no history; search_cortes with distribuidora="eeasa"
Public electricity statistics builder: 28 report types (energy balance, losses, billing, infrastructure), 1998 on
Energy balance and losses by distributor and month (1999-Apr 2024), billing, collection, subsidies and customers (1999-2025), plants, lines and substations; search_capas_geo with fuente="arconel"
Annual statistics 1990-2025 and Atlas, maps, the current national energy balance, 2023-2026 tariffs and the 51 regulations in force; list_archivo_secciones with fuente="arconel"
CELEC's 40 generation plants and the National Transmission System network (March 2025); search_capas_geo with fuente="celec"
Crude and derivatives yearbooks 2002-2024, mining exports and tax revenue, 2020-21 weekly mining reports and the National Energy Balance 2018-2025 (PDF/XLS)
Monthly and annual statistical reports since 2006, daily field production, fuel prices and subsidies, dispatches and refining (PDF)
COE emergency events + tsunami early-warning stations
Resolutions, contingency plans, threat maps, and tsunami evacuation routes (~1660 documents)
Historical archive of situation reports per adverse event, 2016-2026
Technical report search by type (seismic/volcanic), volcano and year, with PDF text extraction
Public Ministry of Labor indicators through its statistical dashboards (Power BI)
Annual statistical bulletin on the Ecuadorian labor market (known editions 2020-2022)
Public employer-obligations compliance certificate (arrears or not)
AIP AD 2.x data sheets per aerodrome/helipad: coordinates, runway, operating hours, frequencies
Real-time weather reports and notices to airmen
INEC quarterly releases built from ANT records (Q1 2022 to Q4 2025) with tabulations and microdata, plus CKAN datasets on SPPAT road deaths; ant.gob.ec is unreachable
Daily report: closed and restricted roads by province
Base de Registros Emitidos: food, medications, cosmetics, medical devices, and more (27 categories)
MSP weekly surveillance bulletins, 18 series (vaccine-preventable, vector-borne, food and water-borne, SARI, outbreaks, maternal deaths, tuberculosis...), 2013-present
Every revision of the price-setting council since 2016
Public-network health facilities, sexual and reproductive health indicators by canton, visits and discharges
Independent municipal CKAN portal (92 datasets); same tools with source="cuenca"
Third municipal CKAN portal (15 datasets: property cadastre, current ordinances, waste-collection routes); same tools with source="latacunga"
2,059 regional indicators from CEPAL; every query filters to Ecuador by default
World Bank WDI, IRENA, Ember's monthly power mix, XM Colombia-Ecuador flows, UN Comtrade bilateral trade, IMF series, WHO health, ILO labour and UNHCR displacement; Ecuador by default
Latin Macro Watch (665 resources, 26 countries) and the World Bank/IADB Database of Political Institutions — a standard CKAN portal, reachable with source="iadb" on the generic CKAN tools
Monthly statistical reports (2017-2026) and annual/topical bulletins (2015-2024)
25 indicators (active lines, base stations, internet, pay TV, concessions, complaints) with full history
Open audit data and the Annual Control Plan
Ten dashboards from the Portal de Estadística Judicial (hearings, mediation, notaries, judge productivity, SUPA, and more), queryable live
What you can ask
Eight real questions, with the answer EcuDataMCP returned, the tools it used and the official source.
“What do I need to get a passport for the first time?”
If you are over 18: proof of payment (online, at a partner bank, or at the office) and a valid physical or digital ID card; if you are renewing, your previous passport. In Quito, Guayaquil and Cuenca it is issued the same day; at other offices, within 24 to 72 hours.
“Were there any strong earthquakes in Ecuador this week?”
The strongest within Ecuadorian territory was magnitude 4.8, 45.7 km from Salinas (Santa Elena), on November 7 at 17:17, at a depth of 2.4 km. There was also a 3.7 near Pasaje (El Oro).
“How much money do migrants send to Ecuador?”
In 2025, remittances reached US$ 7,728 million, 18.2% more than in 2024 (US$ 6,540 million). In the second quarter of 2026, US$ 2,041 million arrived.
“What public data is there on Corporación Favorita?”
RUC 1790016919001. Active corporation (sociedad anónima), incorporated on November 30, 1957 in Quito, with subscribed capital of US$ 900 million. Activity: retail trade (CIIU G4711.01). Latest balance sheet filed: 2025.
“How much did the public sector contract in Manta in 2025?”
253 procedures worth US$ 34.7 million (awarded or estimated value of 211 procedures with an amount). The largest buyers were the Manta General Hospital (US$ 16.6 million) and the Municipality of Manta (US$ 9.4 million).
“Are there scheduled power outages in Ambato or Puyo?”
Yes, 3 active notices. For example: Monday, November 9, from 09:00 to 14:00, in the Callate San Antonio neighborhood (Píllaro); Tuesday, November 10, from 10:00 to 14:00, in the La Libertad neighborhood (Puyo).
“What percentage of households have internet in Manta?”
According to the 2022 Census, 65.0% of households in Manta have fixed internet (66.6% in urban areas and 33.1% in rural areas), compared with 47.4% in Manabí and 60.9% nationwide.
“Where is the 2022 Census data on household internet access?”
In the «Information technologies» tabulation of the 2022 Census (03_2022_CPV_TIC.xlsx), with households by internet, computer and cell phone availability by province, canton and parish.
Answers extracted on November 9, 2026 with EcuDataMCP v0.15.0. Each answer came from a real query to the official source listed; values may have changed since then.
Connect your assistant
Works with any MCP client. Pick yours and copy the configuration.
If your assistant has terminal access, hand it the repo link:
Clone https://github.com/DweskZ/EcuDataMCP, install its dependencies with uv sync,
and register it as an MCP server in my client using stdio mode with
`uv run --directory <clone-path> python main.py --transport stdio`.
Verify the server responds before calling it done.Always review what your assistant changes (config files, commands run) before confirming. It only works with assistants that can run commands on their own: today that's Claude Code, Codex, Cursor, and Windsurf in agent mode.
Claude Desktop runs the PyPI package with uv, so no server has to be started. Add this to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows) and restart Claude Desktop. You can also install the .mcpb file attached to each GitHub release as an extension.
{
"mcpServers": {
"ecuador-datos": {
"command": "uvx",
"args": ["ecuador-mcp", "--transport", "stdio"]
}
}
}Alternative: connect to an HTTP server that is already running (needs Node.js 18+ for mcp-remote)
{
"mcpServers": {
"ecuador-datos": {
"command": "npx",
"args": ["-y", "mcp-remote", "http://localhost:8000/mcp"]
}
}
}One command and you are set: Claude Code starts the server over stdio with uvx. Restart the session to see the tools.
claude mcp add ecuador-datos -- uvx ecuador-mcp --transport stdioAlternative: an HTTP server that is already running
claude mcp add --transport http ecuador-datos http://localhost:8000/mcpOpen Cursor Settings, search for "MCP" and add a new server, or edit ~/.cursor/mcp.json directly:
{
"mcpServers": {
"ecuador-datos": {
"command": "uvx",
"args": ["ecuador-mcp", "--transport", "stdio"]
}
}
}Alternative: an HTTP server that is already running
{
"mcpServers": {
"ecuador-datos": {
"url": "http://localhost:8000/mcp",
"transport": "http"
}
}
}For remote clients or your own deployments. Docker requires a token (MCP_AUTH_TOKEN); the endpoint is http://localhost:8000/mcp. Without Docker, uv run serves it on the same port.
MCP_AUTH_TOKEN="$(openssl rand -hex 32)" docker compose up -d
# or, without Docker:
uv sync && uv run python main.py --transport http --port 8000Check that it responds
curl http://localhost:8000/healthAdd to your mcp.json file (run MCP: Open User Configuration from the command palette):
{
"servers": {
"ecuador-datos": {
"url": "http://localhost:8000/mcp",
"type": "http"
}
}
}*Available on paid plans (Plus, Pro, Team, Enterprise).*
Settings > Apps and connectorsAdvanced settings and enable Developer modeSettings > Connectors > Browse connectors, click Add a new connectorhttp://localhost:8000/mcpSaves the configuration to ~/.codex/config.toml (an [mcp_servers.ecuador-datos] block with url). To use the server over stdio instead of HTTP: codex mcp add ecuador-datos -- uvx ecuador-mcp --transport stdio.
codex mcp add ecuador-datos --url http://localhost:8000/mcpAdd to ~/.gemini/settings.json:
{
"mcpServers": {
"ecuador-datos": {
"httpUrl": "http://localhost:8000/mcp"
}
}
}Intelligence > ConnectorsAdd connector > Custom MCP Connectorhttp://localhost:8000/mcpAdd to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"ecuador-datos": {
"command": "npx",
"args": ["-y", "mcp-remote", "http://localhost:8000/mcp"]
}
}
}+ icon > MCP Servers > Manage MCP ServersAdd Server with name "Ecuador Datos" and URL http://localhost:8000/mcpFrequently asked questions
An open-source MCP (Model Context Protocol) server that helps your AI assistant discover and query Ecuador's open government data: datasets, procedures, regulations, public contracts, risk events, earthquakes, Central Bank indicators, and companies.
Model Context Protocol is an open standard for connecting AI assistants to external tools and data sources, while keeping control over what the model can do and what data it can read.
Yes. Every answer comes live from the institution's own portal (BCE, INEC, SRI, Supercías, SERCOP…) and carries the link to verify it.
Any MCP-compatible client: Claude Desktop, Claude Code, Codex, ChatGPT (paid plans), Cursor, VS Code, Gemini CLI, Le Chat, Windsurf, HuggingChat, and more.
No. Every source the server uses is public data with no authentication. (The HTTP endpoint can be protected with your own token, MCP_AUTH_TOKEN.)
No. EcuDataMCP is an independent, open-source project that queries the same public sources the Ecuadorian state already publishes. It is not affiliated with any institution.
There is no external telemetry. The server runs locally on your machine, and every query goes straight from the MCP client to the matching official portal. The only thing recorded is local per-tool usage counters (name, outcome and duration, never the arguments).
In-memory preview of CSV, TSV, JSON, GeoJSON, and XLSX; filtered tabular queries via the CKAN DataStore when the resource supports it.
Start with curl http://localhost:8000/health. If it responds, the problem is usually in the client configuration or the upstream portal. See the Troubleshooting section below.
Yes, the project is MIT-licensed and accepts pull requests. See the guide at Contribute.
Troubleshooting
Start by confirming the server is alive. If it responds, the problem is almost always in the client configuration or the upstream portal, not in EcuDataMCP.
curl http://localhost:8000/healthIt should return {"status":"ok", "version": ...}. If it doesn't respond, the server isn't running or is listening on a different port.
Check, in order: (1) the server is running (/health responds); (2) the URL ends in /mcp, not / or /health; (3) the config JSON is valid (one stray comma silently breaks it); and (4) you fully restarted the client after editing the config. Claude Desktop, Cursor, and Windsurf only read the file at startup.
npx not foundThe mcp-remote alternative (and the Windsurf config) needs Node.js 18+ installed and on the PATH. Install it from nodejs.org and restart the client. Node-free alternative: use stdio mode with uvx ecuador-mcp --transport stdio, or with "command": "uv" and "args": ["run", "--directory", "<clone-path>", "python", "main.py", "--transport", "stdio"].
Start the server on another port (uv run main.py --port 8007, or MCP_PORT=8007 docker compose up -d) and change the client URL to http://localhost:8007/mcp.
Run the same command by hand in a terminal to see the real error. Typical causes are a wrong --directory path, not having run uv sync in the clone, or uv not being on the PATH the client sees (in that case, use the absolute path to uv).
localhostWeb clients run in the cloud and can't see your machine. You need to expose the server at a public HTTPS URL (a tunnel or your own deployment) and, in that case, enable MCP_REQUIRE_AUTH=1 with an MCP_AUTH_TOKEN. Never expose the server without a token.
401: the server requires a token (MCP_AUTH_TOKEN) and the client isn't sending it as Authorization: Bearer .... 429: you exceeded the per-window request limit (MCP_RATE_LIMIT_REQUESTS, 120 per 60 s by default); wait, or raise it for local use. 503: too many concurrent requests (MCP_MAX_CONCURRENT_REQUESTS, 8 by default).
www.datosabiertos.gob.ec sometimes rejects connections coming from outside Latin America (403 error). If you see this, run the server from a connection with an exit point in Ecuador or the region (a VPN, for example). The procedures and institutions tools use a different portal and don't have this issue. Government portals also have their own outages: if a single tool fails while the rest respond, try again later.
Some official portals have served expired certificates or incomplete chains (the Open Data portal's expired in July 2026). For that portal there's an opt-in retry: CKAN_INSECURE_TLS=1 in your .env. Use it only while the portal is broken and remove it afterward.
That's intentional: downloads are capped at 5 MB and ZIP/tar.gz decompression at 20 MB. For large resources use query_resource_data (filters in the CKAN DataStore without downloading the file) or list_zip_contents to see what a ZIP contains and read_zip_member to read one of its files without downloading the whole ZIP.
Start with LOG_LEVEL=DEBUG, reproduce the error, and open a GitHub issue with the tool, its parameters, the /health output, and the log. Don't include tokens.