Releases: SidneyBissoli/ibge-br-mcp
Release list
Release v3.0.2
See CHANGELOG.md for release notes.
v3.0.0
BREAKING
- Renamed the
datasaudetool toibge_datasaude— all 22 tools now share theibge_prefix. Update any client config/calls that useddatasaude.
Added
- Structured output for every tool: the 15 catalog/locality/listing tools now declare an
outputSchemaand return typedstructuredContent(all 22 tools now have it; additive/non-breaking). - Hosted HTTP transport (Cloudflare Worker, Streamable HTTP) at
https://ibge.sidneybissoli.com/mcp, declared as aremotesentry;/.well-known/mcp/server-card.json. SECURITY.md; npm publish provenance; a "Behavior:" line in every tool description.
Fixed
ibge_paiseswas broken against the live IBGE API (wrong assumed shapes for name/id/currency/region) — search threw, region filter returned empty, names/codes mis-rendered. Types and accessors corrected.ibge_sidra_metadados: coerce the table code to string so structured output validates.- Repointed the Glama badge to its canonical URL; fixed the dead MseeP badge link.
See CHANGELOG.md for details.
v2.0.0 — IBGE-only refocus (removes BCB tool)
⚠️ Breaking change
The bcb tool (Banco Central / SGS data) has been removed. It was the only non-IBGE data source and contradicted this project's stated scope — IBGE specialist, no scope creep to other sources. Dedicated Banco Central MCP servers cover that use case better.
Also removed: the cruzar-ibge-bcb prompt, the BCB API endpoints/aliases, and the toBcbDate helper.
Migration: IPCA/INPC and other price indices remain available via ibge_indicadores (IBGE is their primary source). For interest/exchange rates (SELIC, CDI, dollar/euro), use a dedicated BCB MCP server.
Tool count: 23 → 22.
Also in this release
- README differentiator (roadmap 2.1): both READMEs now lead with the "live, exact, sourced data vs. just asking an LLM" pitch.
- Registry metadata / SEO (roadmap 2.4): value-oriented description and expanded keywords;
server.jsoncleaned up. - Accuracy fix: removed the inaccurate claim that the server queries a DataSUS API — health data is read from IBGE's SIDRA; DataSUS is credited only as the original producer of some stats served via SIDRA.
Full notes in CHANGELOG.md.
v1.10.0 — Phase 1 complete (usability)
This release completes Phase 1 (usability) of the roadmap.
Added
- MCP resources — five reference catalogs as readable
ibge://catalogos/*resources (ufs,regioes,niveis-territoriais,tabelas-sidra,biomas), so an agent can read lookup tables without guessing a code or spending a tool round-trip. - MCP prompts — three ready-made analysis templates:
comparar-municipios,perfil-demografico,cruzar-ibge-bcb, with zod-validated arguments. - Read-only tool annotations — all 23 tools declare
readOnlyHint/idempotentHint/openWorldHintso clients can auto-approve them. - Configurable request timeout — every upstream request is bounded by an
AbortController(default 30s, override viaIBGE_MCP_TIMEOUT_MS), surfacing a clear message instead of hanging.
Changed
- Errors that teach — every tool's error path points at the related tool(s) to try next.
- Server construction extracted into a side-effect-free
createServer()(src/server.ts), making the MCP protocol surface testable end-to-end.
Plus the earlier Phase 1 work already shipped on main: structured output + field selection (1.2), parameter consistency (1.3), and the test-coverage push (1.5).
Test suite: 460 passing. Full notes in CHANGELOG.md.
v1.9.2
Add mcpName and server.json to MCP Registry
v1.9.1
Add mcpName and server.json to MCP Registry
v1.9.0
Initial release of IBGE MCP Server
- 23 specialized tools for IBGE APIs
- Full documentation in English and Portuguese