Skip to content

SidneyBissoli/ibge-br-mcp

MCP Data & Storage

A server that lets AI assistants query official IBGE APIs for live Brazilian geographic, demographic, economic and health data with provenance.

TypeScript Latest v3.0.2 · 1mo ago Security brief →

Features

  • 22 specialized tools covering all major IBGE data domains
  • Real‑time access to official IBGE statistics via the Model Context Protocol (MCP)
  • Automatic caching, retry with exponential backoff, and comprehensive validation

Recent releases

View all 7 releases →
Config change
v3.0.0 Breaking risk
Breaking upgrade

datasaude renamed

v2.0.0 Breaking risk
⚠ Upgrade required
  • Migrate IPCA/INPC price indices to use `ibge_indicadores` (IBGE primary source).
  • For interest/exchange rates (SELIC, CDI, dollar/euro), switch to a dedicated BCB MCP server.
Breaking changes
  • Removed the `bcb` tool (Banco Central/SGS data source).
  • Removed the `cruzar-ibge-bcb` prompt, BCB API endpoints/aliases, and the `toBcbDate` helper.
  • Tool count reduced from 23 to 22.
Notable features
  • README now leads with a differentiator emphasizing live, exact, sourced data vs. LLM answers.
  • Registry metadata updated with value‑oriented description, expanded keywords, and cleaned `server.json`.
Full changelog

⚠️ 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.

No immediate action
v1.10.0 New feature

MCP catalogs + prompts + timeout

No immediate action
v1.9.2 Feature

mcpName + server.json

No immediate action
v1.9.1 Feature

mcpName + server.json

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

About

Stars
6
Forks
5
Languages
TypeScript JavaScript Dockerfile
Downloads/week
173 ↓58%
NPM Maintainers
1 Single npm maintainer
Contributors
2
TypeScript
Types included ✓

Install & Platforms

Install via
npm

Beta — feedback welcome: [email protected]