Skip to content

Releases: SidneyBissoli/ibge-br-mcp

Release v3.0.2

Choose a tag to compare

@github-actions github-actions released this 21 Jun 19:15

See CHANGELOG.md for release notes.

v3.0.0

Choose a tag to compare

@SidneyBissoli SidneyBissoli released this 20 Jun 03:34

BREAKING

  • Renamed the datasaude tool to ibge_datasaude — all 22 tools now share the ibge_ prefix. Update any client config/calls that used datasaude.

Added

  • Structured output for every tool: the 15 catalog/locality/listing tools now declare an outputSchema and return typed structuredContent (all 22 tools now have it; additive/non-breaking).
  • Hosted HTTP transport (Cloudflare Worker, Streamable HTTP) at https://ibge.sidneybissoli.com/mcp, declared as a remotes entry; /.well-known/mcp/server-card.json.
  • SECURITY.md; npm publish provenance; a "Behavior:" line in every tool description.

Fixed

  • ibge_paises was 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)

Choose a tag to compare

@SidneyBissoli SidneyBissoli released this 19 Jun 14:11

⚠️ 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.json cleaned 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)

Choose a tag to compare

@SidneyBissoli SidneyBissoli released this 19 Jun 12:20

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/openWorldHint so clients can auto-approve them.
  • Configurable request timeout — every upstream request is bounded by an AbortController (default 30s, override via IBGE_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

Choose a tag to compare

@SidneyBissoli SidneyBissoli released this 18 Jan 15:59
42dccac

Add mcpName and server.json to MCP Registry

v1.9.1

Choose a tag to compare

@SidneyBissoli SidneyBissoli released this 18 Jan 15:37

Add mcpName and server.json to MCP Registry

v1.9.0

Choose a tag to compare

@SidneyBissoli SidneyBissoli released this 18 Jan 12:50

Initial release of IBGE MCP Server

  • 23 specialized tools for IBGE APIs
  • Full documentation in English and Portuguese