ibge-br-mcp 5.5.0 → 5.6.0

package/README.md

@@ -17,7 +17,7 @@
 
 Ask an LLM _"what was Belo Horizonte's population in the 2022 Census?"_ and you get a plausible number from its training data: maybe right, maybe outdated, with no source. `ibge-br-mcp` instead has your assistant query the official **IBGE** APIs in real time — returning the exact figure together with the table and period it came from.
 
-🇧🇷 [Leia em Português](README.pt-BR.md)
+🇧🇷 [Leia em Português](LEIA-ME.md)
 
 This server implements the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) to give AI assistants live, structured access to Brazil's public geographic, demographic, economic, and health data — sourced from the IBGE APIs (including health indicators served through IBGE's SIDRA system).
 

package/dist/provenance.d.ts

@@ -190,6 +190,14 @@ export declare function comProveniencia<T extends z.ZodObject<z.ZodRawShape>>(sc
         }, z.core.$strict>>;
         citation: z.ZodString;
         license: z.ZodNullable<z.ZodString>;
+        field_sources: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            fields: z.ZodArray<z.ZodString>;
+            source_url: z.ZodString;
+            dataset_id: z.ZodNullable<z.ZodString>;
+            data_vintage: z.ZodNullable<z.ZodString>;
+            retrieved_at: z.ZodNullable<z.ZodString>;
+            served_from_cache: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+        }, z.core.$strict>>>;
     }, z.core.$strict>;
     attribution: z.ZodArray<z.ZodString>;
 }, z.core.$strip>;

package/dist/provenance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provenance.d.ts","sourceRoot":"","sources":["../src/provenance.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"provenance.d.ts","sourceRoot":"","sources":["../src/provenance.ts"],"names":[],"mappings":"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"}

package/dist/provenance.js

@@ -183,6 +183,7 @@ const DESCRICOES_IBGE = {
     retrieval: "Diagnóstico de origem desta chamada (contrato v1.1): idas à API do IBGE, tentativas somadas e anomalias contornadas; unstable=true quando houve anomalia. null quando nada foi medido (resposta servida só do cache)",
     citation: "Citação pronta para uso",
     license: "Regime legal do dado",
+    field_sources: "Proveniência por sub-fonte (contrato v1.2): presente só quando a resposta junta partes extraídas de origens ou em momentos distintos, uma entrada por grupo de campos; ausente quando a resposta vem de uma única extração",
 };
 /**
  * Grafts descriptions onto a zod schema, node by node, from the JSON Schema

package/dist/provenance.js.map

@@ -1 +1 @@
-{"version":3,"file":"provenance.js","sourceRoot":"","sources":["../src/provenance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,eAAe,EACf,yBAAyB,EACzB,kBAAkB,EAClB,uBAAuB,EACvB,aAAa,GAGd,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,2FAA2F;AAC3F,MAAM,CAAC,MAAM,iBAAiB,GAAG,uBAAuB,CAAC;IACvD,aAAa,EAAE,2BAA2B;IAC1C,MAAM,EAAE,OAAO;IACf,QAAQ,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,qBAAqB,EAAE;IAC5D,WAAW,EAAE,SAAS;CACvB,CAAC,CAAC;AAKH,gFAAgF;AAChF,MAAM,CAAC,MAAM,mBAAmB,GAAG,iBAAiB,CAAC,QAAQ,CAAC,UAAU,CAAC;AACzE,MAAM,CAAC,MAAM,oBAAoB,GAAG,iBAAiB,CAAC,QAAQ,CAAC,WAAW,CAAC;AAE3E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,EAAE,EAAE,IAAI;IACR,IAAI,EAAE,gFAAgF;IACtF,GAAG,EAAE,IAAI;IACT,SAAS,EAAE,4EAA4E;IACvF,WAAW,EAAE,YAAY;CACjB,CAAC;AAEX;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,WAAW,EAAE;QACX,IAAI,EAAE,2BAA2B;QACjC,QAAQ,EAAE,aAAa,CAAC,IAAI,CAAC,WAAW;KACzC;IACD,KAAK,EAAE;QACL,IAAI,EAAE,8CAA8C;QACpD,QAAQ,EAAE,aAAa,CAAC,KAAK;KAC9B;IACD,SAAS,EAAE;QACT,IAAI,EAAE,iCAAiC;QACvC,QAAQ,EAAE,aAAa,CAAC,IAAI,CAAC,SAAS;KACvC;IACD,KAAK,EAAE;QACL,IAAI,EAAE,8CAA8C;QACpD,QAAQ,EAAE,aAAa,CAAC,IAAI,CAAC,KAAK;KACnC;IACD,MAAM,EAAE;QACN,IAAI,EAAE,kCAAkC;QACxC,QAAQ,EAAE,aAAa,CAAC,IAAI,CAAC,MAAM;KACpC;IACD,WAAW,EAAE;QACX,IAAI,EAAE,6CAA6C;QACnD,QAAQ,EAAE,aAAa,CAAC,IAAI,CAAC,WAAW;KACzC;IACD,QAAQ,EAAE;QACR,IAAI,EAAE,wBAAwB;QAC9B,QAAQ,EAAE,aAAa,CAAC,IAAI,CAAC,QAAQ;KACtC;IACD,SAAS,EAAE;QACT,IAAI,EAAE,sCAAsC;QAC5C,QAAQ,EAAE,aAAa,CAAC,IAAI,CAAC,SAAS;KACvC;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,iBAAiB;QACvB,QAAQ,EAAE,aAAa,CAAC,IAAI,CAAC,IAAI;KAClC;IACD,UAAU,EAAE;QACV,IAAI,EAAE,yCAAyC;QAC/C,QAAQ,EAAE,aAAa,CAAC,IAAI,CAAC,UAAU;KACxC;IACD,MAAM,EAAE;QACN,IAAI,EAAE,sBAAsB;QAC5B,QAAQ,EAAE,aAAa,CAAC,IAAI,CAAC,MAAM;KACpC;IACD,SAAS,EAAE;QACT,IAAI,EAAE,oCAAoC;QAC1C,QAAQ,EAAE,aAAa,CAAC,IAAI,CAAC,SAAS;KACvC;CACO,CAAC;AAIX,0EAA0E;AAC1E,SAAS,WAAW,CAAC,WAA0B;IAC7C,MAAM,GAAG,GACP,WAAW,YAAY,IAAI;QACzB,CAAC,CAAC,sDAAsD;YACtD,IAAI,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE;QACpE,CAAC,CAAC,WAAW,CAAC;IAClB,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACpD,OAAO,GAAG,GAAG,IAAI,GAAG,IAAI,GAAG,EAAE,CAAC;AAChC,CAAC;AAuBD;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAA6B;IAC5D,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtC,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACrE,MAAM,WAAW,GAAG,IAAI,EAAE,WAAW,IAAI,IAAI,IAAI,EAAE,CAAC;IAEpD,OAAO,iBAAiB,CAAC,KAAK,CAAC;QAC7B,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE;QACtF,UAAU,EAAE,IAAI,CAAC,GAAG;QACpB,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChE,YAAY,EAAE,IAAI,CAAC,WAAW,IAAI,IAAI;QACtC,YAAY,EAAE,WAAW;QACzB,QAAQ,EAAE,iBAAiB,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,GAAG,iBAAiB,WAAW,CAAC,WAAW,CAAC,GAAG;QACjG,OAAO,EAAE,YAAY;QACrB,OAAO,EAAE,IAAI,CAAC,QAAQ,KAAK,SAAS;QACpC,GAAG,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/E,iBAAiB,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI;QACrD,2EAA2E;QAC3E,4EAA4E;QAC5E,0EAA0E;QAC1E,SAAS,EAAE,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,IAAI;KAC9C,CAAC,CAAC;AACL,CAAC;AAED,wFAAwF;AACxF,MAAM,CAAC,MAAM,2BAA2B,GACtC,yLAAyL,CAAC;AAE5L;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAiB,EACjB,SAAwC;IAExC,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CACtC,gDAAgD,CAAC,IAAI,CAAC,CAAC,CAAC,CACzD,CAAC;IACF,2EAA2E;IAC3E,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;IAC/E,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,MAAM,OAAO,GAAG;QACd,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;KAChF,CAAC,IAAI,EAAE,CAAC;IACT,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,OAAO,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC;AAC5F,CAAC;AAED;;;;GAIG;AACH,MAAM,eAAe,GAA0D;IAC7E,MAAM,EAAE,gDAAgD;IACxD,UAAU,EAAE,sCAAsC;IAClD,YAAY,EAAE,0EAA0E;IACxF,YAAY,EAAE,uEAAuE;IACrF,SAAS,EACP,sNAAsN;IACxN,QAAQ,EAAE,yBAAyB;IACnC,OAAO,EAAE,sBAAsB;CAChC,CAAC;AAWF;;;;GAIG;AACH,SAAS,uBAAuB,CAC9B,MAAiB,EACjB,EAA4B,EAC5B,SAAS,GAAoC,EAAE;AAC/C,sGAAsG;AACtG,KAAK,GAAuB,EAAE,EAAE,WAAW;IAE3C,IAAI,KAAgB,CAAC;IACrB,IAAI,MAAM,YAAY,CAAC,CAAC,WAAW,EAAE,CAAC;QACpC,iFAAiF;QACjF,MAAM,OAAO,GAAG,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACzE,KAAK,GAAG,uBAAuB,CAAC,MAAM,CAAC,MAAM,EAAe,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC5F,CAAC;SAAM,IAAI,MAAM,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;QACxC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,uBAAuB,CAAC,MAAM,CAAC,OAAoB,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC;IACnF,CAAC;SAAM,IAAI,MAAM,YAAY,CAAC,CAAC,SAAS,EAAE,CAAC;QACzC,KAAK,GAAG,CAAC,CAAC,YAAY,CACpB,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC;YACnD,KAAK;YACL,uBAAuB,CACrB,KAAkB,EAClB,EAAE,EAAE,UAAU,EAAE,CAAC,KAAK,CAAC,EACvB,EAAE,EACF,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,UAAU,EAAE,CAAC,KAAK,CAAC,EAAE,WAAW,CACzD;SACF,CAAC,CACH,CACF,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,KAAK,GAAG,MAAM,CAAC;IACjB,CAAC;IACD,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AAC/C,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,uBAAuB,CAC1D,kBAAkB,EAClB,yBAAyB,EACzB,eAAe,CACa,CAAC;AAE/B;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAuC,MAAS;IAC7E,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,UAAU,EAAE,qBAAqB,CAAC,QAAQ,CACxC,uGAAuG,CACxG;QACD,WAAW,EAAE,CAAC;aACX,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;aACjB,QAAQ,CAAC,gEAAgE,CAAC;KAC9E,CAAC,CAAC;AACL,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,oBAAoB,CAAC,CAAa;IAIhD,OAAO,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC7E,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,kBAAkB,CAAC,CAAa;IAC9C,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AACrC,CAAC"}
+{"version":3,"file":"provenance.js","sourceRoot":"","sources":["../src/provenance.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ibge-br-mcp",
-  "version": "5.5.0",
+  "version": "5.6.0",
   "mcpName": "io.github.SidneyBissoli/ibge-br-mcp",
   "description": "MCP server giving AI assistants live, sourced access to Brazilian public data — geography, census, economy and health — from the official IBGE APIs. Exact figures with provenance, not approximations.",
   "type": "module",
@@ -61,17 +61,17 @@
   "license": "MIT",
   "dependencies": {
     "@modelcontextprotocol/server": "^2.0.0",
-    "@sbissoli/mcp-provenance": "^0.2.0",
+    "@sbissoli/mcp-provenance": "^0.3.0",
     "@sbissoli/mcp-search": "^0.9.0",
     "@sbissoli/mcp-stats": "^0.3.0",
-    "@sbissoli/mcp-upstream": "^0.3.0",
+    "@sbissoli/mcp-upstream": "^0.4.0",
     "zod": "^4.5.4"
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
     "@modelcontextprotocol/client": "^2.0.0",
     "@sbissoli/mcp-evals": "^0.1.0",
-    "@sbissoli/mcp-surface": "^0.1.0",
+    "@sbissoli/mcp-surface": "^0.3.0",
     "@types/node": "^26.5.1",
     "@vitest/coverage-v8": "^5.0.0",
     "eslint": "^10.9.1",

package/README.pt-BR.md

@@ -1,679 +0,0 @@
-# ibge-br-mcp
-
-[![npm version](https://img.shields.io/npm/v/ibge-br-mcp.svg)](https://www.npmjs.com/package/ibge-br-mcp)
-[![npm downloads](https://img.shields.io/npm/dm/ibge-br-mcp.svg)](https://www.npmjs.com/package/ibge-br-mcp)
-[![node](https://img.shields.io/node/v/ibge-br-mcp)](https://www.npmjs.com/package/ibge-br-mcp)
-[![MCP Registry](https://img.shields.io/badge/MCP-Registry-blue)](https://registry.modelcontextprotocol.io)
-[![LobeHub](https://lobehub.com/badge/mcp/sidneybissoli-ibge-br-mcp)](https://lobehub.com/mcp/sidneybissoli-ibge-br-mcp)
-[![smithery badge](https://smithery.ai/badge/sidneybissoli/ibge-br-mcp)](https://smithery.ai/server/sidneybissoli/ibge-br-mcp)
-[![ibge-br-mcp MCP server](https://glama.ai/mcp/servers/@SidneyBissoli/ibge-br-mcp/badges/score.svg)](https://glama.ai/mcp/servers/@SidneyBissoli/ibge-br-mcp)
-[![CI](https://github.com/SidneyBissoli/ibge-br-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/SidneyBissoli/ibge-br-mcp/actions/workflows/ci.yml)
-[![Coverage](https://img.shields.io/badge/coverage-%E2%89%A588%25-brightgreen.svg)](https://github.com/SidneyBissoli/ibge-br-mcp/blob/main/vitest.config.ts)
-[![GitHub stars](https://img.shields.io/github/stars/SidneyBissoli/ibge-br-mcp?style=flat&logo=github)](https://github.com/SidneyBissoli/ibge-br-mcp)
-[![GitHub Sponsors](https://img.shields.io/github/sponsors/SidneyBissoli?logo=githubsponsors&label=Sponsor&color=db61a2)](https://github.com/sponsors/SidneyBissoli)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-
-**Dados públicos brasileiros ao vivo e exatos para o seu assistente de IA — com procedência, não chute.**
-
-Pergunte a um LLM _"qual era a população de Belo Horizonte no Censo 2022?"_ e você recebe um número plausível, tirado do treino: talvez certo, talvez desatualizado, sem fonte. O `ibge-br-mcp` faz o seu assistente consultar as APIs oficiais do **IBGE** em tempo real — devolvendo o valor exato junto com a tabela e o período de onde ele veio.
-
-🇺🇸 [Read in English](README.md)
-
-Este servidor implementa o [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) para dar aos assistentes de IA acesso ao vivo e estruturado aos dados públicos geográficos, demográficos, econômicos e de saúde do Brasil — vindos das APIs do IBGE (inclusive os indicadores de saúde, servidos pelo SIDRA do IBGE).
-
-## Veja na prática
-
-Pergunte ao seu assistente, em português:
-
-- *"Qual era a população de Belo Horizonte no Censo 2022?"* → `ibge_cidades` / `ibge_censo`
-- *"Liste os municípios do Espírito Santo."* → `ibge_municipios`
-- *"Compare o PIB das capitais do Sudeste."* → `ibge_comparar`
-
-As respostas vêm ao vivo das APIs oficiais do IBGE — valores exatos com a tabela e o período de onde vieram, não números chutados do treino.
-
-Quer ver uma análise inteira, e não uma resposta só? A
-[**demo ponta a ponta**](docs/demo.pt-BR.md) percorre uma pergunta real — *qual
-estado mais cresceu entre os Censos de 2010 e 2022, e o que puxou o crescimento*
-— da primeira chamada à conclusão, com cada número como ele voltou. Os
-[**exemplos práticos**](examples/README.pt-BR.md) são sete receitas mais curtas,
-entre elas ranquear os 5.570 municípios numa chamada só.
-
-## Recursos
-
-- **23 ferramentas** cobrindo todos os principais domínios de dados do IBGE — 21 `ibge_*` de dados mais `search`/`fetch` para o Deep Research do ChatGPT
-- **Resources de referência & prompts de análise** (catálogos MCP + templates prontos)
-- **565 testes automatizados** — 88% de cobertura geral, 92% nas tools
-- **Cache automático** com TTL configurável para performance otimizada
-- **Mecanismo de retry** com backoff exponencial para resiliência de rede
-- **Validação abrangente** para todos os parâmetros de entrada
-- **Tratamento de erros padronizado** com sugestões úteis
-- **Suporte completo a TypeScript** com tipagem estrita
-
-📖 **Artigo:** [Como achar a tabela certa no SIDRA — e como saber que é a certa](docs/artigo-sidra-tabela-certa.pt-BR.md) — os três passos da busca, os metadados que decidem, um exemplo completo com dado de 2022 e as quatro armadilhas que mais custam caro. Também publicado no site: [sidneybissoli.com](https://sidneybissoli.com/blog/posts/sidra-tabela-certa/).
-
-🔌 **Tutorial:** [Consultando o SIDRA por MCP no Claude e no ChatGPT](https://sidneybissoli.com/blog/posts/sidra-via-mcp/) — como conectar este servidor no claude.ai, Claude Desktop, Claude Code, ChatGPT (modo desenvolvedor e Deep Research), Cursor, VS Code e Gemini CLI, e uma consulta real de ponta a ponta com o bloco de procedência que ele devolve. [In English](https://sidneybissoli.com/en/blog/posts/sidra-via-mcp/).
-
-## Procedência dos dados
-
-Desde a v3.3.0 toda resposta bem-sucedida carrega um **bloco de procedência**
-([contrato do portfólio v1.0](https://www.npmjs.com/package/@sbissoli/mcp-provenance)),
-de modo que cada número é citavel, auditável e reproduzível. O bloco sai por
-três canais:
-
-1. `structuredContent.provenance` (analisável, visível ao modelo) — exatamente
-   seis chaves: `source` (a API do IBGE consultada), `source_url` (URL canônica
-   que reproduz a consulta), `data_vintage` (período de referência quando a
-   fonte publica um; `null` caso contrário), `retrieved_at` (o instante REAL da
-   extração na origem, preservado através do cache, horário de Brasília),
-   `citation` ("Fonte: IBGE — [pesquisa/tabela], [URL], extraído em [data].") e
-   `license` — mais `attribution`, a lista canônica de URLs de origem.
-2. `_meta` sob `br.com.sidneybissoli.ibge/provenance` e `.../attribution`
-   (espelho fora de banda para auditoria/UI, custo zero em tokens do modelo).
-3. Um rodapé de texto compacto anexado ao Markdown, para clientes só-texto.
-
-As APIs do IBGE não declaram licença própria; o regime jurídico é o arcabouço
-brasileiro de dados abertos — Lei 12.527/2011 (LAI) e Decreto 8.777/2016
-(reuso irrestrito, uso livre, obrigação limitada a creditar a fonte). Respostas
-em modo estatístico (`estatisticas=true`) e `ibge_comparar` vêm marcadas como
-`derived`, com nota explicativa no bloco canônico, porque os agregados são
-calculados no servidor a partir dos valores brutos do IBGE.
-
-## Ferramentas Disponíveis
-
-### Localidades e Geografia
-| Ferramenta | Descrição |
-|:-----------|:----------|
-| `ibge_estados` | Lista estados brasileiros com filtro por região |
-| `ibge_municipios` | Lista municípios por estado ou busca por nome |
-| `ibge_localidade` | Obtém detalhes de uma localidade pelo código IBGE |
-| `ibge_geocodigo` | Decodifica códigos IBGE ou busca códigos por nome |
-| `ibge_vizinhos` | Encontra municípios vizinhos |
-
-### Dados Estatísticos (SIDRA)
-| Ferramenta | Descrição |
-|:-----------|:----------|
-| `ibge_sidra` | Consulta tabelas SIDRA (Censo, PNAD, PIB, etc.) |
-| `ibge_sidra_tabelas` | Lista e busca tabelas SIDRA disponíveis (sem distinção de acento; a palavra de todo dia é traduzida para a do IBGE, e a resposta diz que traduziu) |
-| `ibge_sidra_metadados` | Obtém metadados de tabelas (variáveis, períodos, níveis) |
-| `ibge_pesquisas` | Lista pesquisas do IBGE e suas tabelas |
-
-### Indicadores Econômicos e Sociais
-| Ferramenta | Descrição |
-|:-----------|:----------|
-| `ibge_indicadores` | Indicadores econômicos e sociais (PIB, IPCA, desemprego) |
-| `ibge_censo` | Dados censitários (1970-2022) com 16 temas |
-| `ibge_comparar` | Compara indicadores entre localidades com rankings |
-
-### Dados Municipais (Cidades@)
-| Ferramenta | Descrição |
-|:-----------|:----------|
-| `ibge_cidades` | Indicadores municipais (população, IDH, PIB per capita, etc.) |
-
-### Dados Internacionais
-| Ferramenta | Descrição |
-|:-----------|:----------|
-| `ibge_paises` | Dados de países seguindo metodologia ONU M49 |
-
-### Demografia
-| Ferramenta | Descrição |
-|:-----------|:----------|
-| `ibge_nomes` | Frequência e rankings de nomes no Brasil |
-
-### Classificações
-| Ferramenta | Descrição |
-|:-----------|:----------|
-| `ibge_cnae` | CNAE (Classificação Nacional de Atividades Econômicas) |
-
-### Mapas e Malhas Geográficas
-| Ferramenta | Descrição |
-|:-----------|:----------|
-| `ibge_malhas` | Malhas geográficas (GeoJSON, TopoJSON, SVG) |
-| `ibge_malhas_tema` | O que um recorte temático contém (biomas, Amazônia Legal, semiárido, zona costeira, faixa de fronteira, regiões metropolitanas, RIDEs) + a URL para baixar a geometria |
-
-### Saúde
-| Ferramenta | Descrição |
-|:-----------|:----------|
-| `ibge_datasaude` | Indicadores de saúde via SIDRA do IBGE |
-
-### Notícias e Calendário
-| Ferramenta | Descrição |
-|:-----------|:----------|
-| `ibge_noticias` | Notícias e releases do IBGE |
-| `ibge_calendario` | Calendário de divulgações e coletas do IBGE |
-
-### Deep Research do ChatGPT
-| Ferramenta | Descrição |
-|:-----------|:----------|
-| `search` | Busca no catálogo do IBGE (tabelas SIDRA, municípios, indicadores conhecidos) — contrato Deep Research da OpenAI |
-| `fetch` | Devolve um documento do catálogo (metadados da tabela, hierarquia + população do município, série do indicador) com a URL pública para citação |
-
-As duas são as únicas ferramentas sem o prefixo `ibge_`: os nomes são fixados pelo contrato da OpenAI. Para consultar dados, continue usando as `ibge_*`.
-
-## Qual ferramenta usar?
-
-Com 23 ferramentas, várias podem tocar no mesmo assunto. Guia rápido para as sobreposições comuns:
-
-### População e demografia
-
-| Você quer… | Use |
-|:-----------|:----|
-| Painel de um único município/UF (população, IDH, PIB…) | `ibge_cidades` |
-| Dados censitários ou série histórica (1970–2022) | `ibge_censo` |
-| Ranquear/comparar 2–10 localidades num indicador | `ibge_comparar` |
-| Série temporal de indicador macro (PIB, IPCA, desemprego…) | `ibge_indicadores` |
-| Uma tabela SIDRA específica / controle fino | `ibge_sidra` |
-| O maior/menor/média/mediana de uma tabela inteira | `ibge_sidra`/`ibge_censo`/`ibge_indicadores`/`ibge_datasaude` com `estatisticas=true` |
-
-### Indicadores econômicos
-
-| Você quer… | Use |
-|:-----------|:----|
-| IPCA, INPC, PIB, desemprego (IBGE, fonte primária) | `ibge_indicadores` |
-
-### Localidades e códigos
-
-| Você quer… | Use |
-|:-----------|:----|
-| Listar/buscar municípios | `ibge_municipios` |
-| Listar estados | `ibge_estados` |
-| Resolver nome→código em qualquer nível, ou decodificar a estrutura de um código | `ibge_geocodigo` |
-| Ficha completa de uma localidade da qual você já tem o código | `ibge_localidade` |
-| Municípios vizinhos | `ibge_vizinhos` |
-
-### Fluxo SIDRA
-
-Descobrir → inspecionar → consultar: `ibge_pesquisas` / `ibge_sidra_tabelas` (achar a tabela) → `ibge_sidra_metadados` (sua estrutura) → `ibge_sidra` (consultar). Para dados comuns, os atalhos acima (`ibge_censo`, `ibge_indicadores`, `ibge_comparar`, `ibge_cidades`) costumam ser mais fáceis.
-
-### Pergunte com as suas palavras, não com as do IBGE
-
-O IBGE nomeia as tabelas no português estatístico oficial, e `ibge_sidra_tabelas` casava o que
-você escreveu contra o nome da tabela por substring pura, acento incluído — então `populacao`
-(sem til, como todo mundo digita) devolvia **zero**, e a palavra de todo dia para um conceito que
-o IBGE chama de outro nome também. Medido nos 9.336 agregados da API de Agregados (16/09/2026)
-e consertado na 5.1.0: os dois lados são normalizados, toda palavra precisa casar (AND) e a
-palavra de todo dia é expandida para a do IBGE — a resposta diz isso em `notas_vocabulario`, e
-zero resultado vem com a saída.
-
-| você pergunta | achava | o IBGE escreve | acha |
-| --- | ---: | --- | ---: |
-| `populacao`, `ocupacao`, `instrucao`, `saude`, `area`, `agua` | 0 | população, ocupação, instrução, saúde, área, água | 520, 364, 698, 518, 956, 256 |
-| `desemprego` | 4 | desocupação | 33 |
-| `renda` | 72 | rendimento | 1.126 |
-| `inflação` | 0 | IPCA, INPC, preços | 37, 15, 75 |
-| `moradia`, `casa` | 14, 101 | domicílio | 3.606 |
-| `cidade` | 110 | município | 455 |
-| `natalidade`, `mortes` | 0, 1 | nascidos vivos, óbitos | 84, 33 |
-| `gênero` | 40 | sexo | 2.020 |
-| `negros` | 0 | cor ou raça | 1.134 |
-| `universidade`, `faculdade` | 0 | ensino superior | 12 |
-| `luz`, `fábrica`, `tabagismo`, `convênio`, `idosos` | 0 | energia elétrica, indústria, fumante, plano de saúde, 60 anos | 43, 248, 94, 101, 89 |
-
-Só entra par **medido** (`src/vocabulario.ts`, com as contagens no cabeçalho): a palavra
-perguntada ausente do catálogo, a palavra do IBGE presente. O que o IBGE não publica como
-agregado fica de fora e segue devolvendo zero — `turismo`, `aposentadoria`, `frota` — porque
-apelido para dado inexistente promete o que a fonte não tem. A mesma tabela alimenta o índice de
-`search` (Deep Research), que recebe a palavra de todo dia como keyword da tabela cujo nome traz
-a palavra do IBGE.
-
-### Mapas (malhas)
-
-| Você quer… | Use |
-|:-----------|:----|
-| Contornos administrativos (Brasil/região/UF/município) | `ibge_malhas` |
-| Áreas temáticas (biomas, Amazônia Legal, semiárido, regiões metropolitanas) | `ibge_malhas_tema` (WFS do IBGE Geosserviços — a API de Malhas não publica esses recortes) |
-
-## Instalação
-
-### Pré-requisitos
-
-- Node.js 22.x ou superior (`engines.node`)
-- npm ou yarn
-
-### Via npm (recomendado)
-
-```bash
-npm install -g ibge-br-mcp
-```
-
-### A partir do código-fonte
-
-```bash
-# Clone o repositório
-git clone https://github.com/SidneyBissoli/ibge-br-mcp.git
-cd ibge-br-mcp
-
-# Instale as dependências
-npm install
-
-# Compile o projeto
-npm run build
-```
-
-## Configuração
-
-### Endpoint remoto (sem instalar)
-
-O servidor também está hospedado, com as mesmas ferramentas, em Streamable HTTP e sem chave:
-
-```
-https://ibge.sidneybissoli.com/mcp
-```
-
-Serve para qualquer cliente que aceite servidor MCP remoto — conector personalizado no claude.ai (Configurações → Conectores → Adicionar conector personalizado), `claude mcp add --transport http ibge https://ibge.sidneybissoli.com/mcp` no Claude Code, app no ChatGPT, `mcp.json` do Cursor e do VS Code. O passo a passo de cada cliente está no [tutorial](https://sidneybissoli.com/blog/posts/sidra-via-mcp/). As seções abaixo cobrem a forma local, via `npx`.
-
-### Claude Desktop
-
-Adicione ao seu arquivo de configuração do Claude Desktop (`claude_desktop_config.json`):
-
-```json
-{
-  "mcpServers": {
-    "ibge-br-mcp": {
-      "command": "npx",
-      "args": ["-y", "ibge-br-mcp"]
-    }
-  }
-}
-```
-
-Ou se instalado a partir do código-fonte:
-
-```json
-{
-  "mcpServers": {
-    "ibge-br-mcp": {
-      "command": "node",
-      "args": ["/caminho/para/ibge-br-mcp/dist/index.js"]
-    }
-  }
-}
-```
-
-### Claude Code
-
-```json
-{
-  "mcpServers": {
-    "ibge-br-mcp": {
-      "command": "npx",
-      "args": ["-y", "ibge-br-mcp"]
-    }
-  }
-}
-```
-
-### ChatGPT (Deep Research)
-
-O Deep Research do ChatGPT (e o Company Knowledge, e os workflows de pesquisa da API Responses) só usa um servidor MCP que exponha exatamente `search` e `fetch` — este servidor expõe as duas, além das `ibge_*`. Aponte o conector para o endpoint hospedado, sem chave:
-
-```
-https://ibge.sidneybissoli.com/mcp
-```
-
-`search` ranqueia a consulta contra tabelas SIDRA, municípios e indicadores conhecidos e devolve `{ id, title, url }`; `fetch` devolve o documento em Markdown legível com a URL pública canônica (sidra.ibge.gov.br ou cidades.ibge.gov.br), que é o que o ChatGPT cita. As duas carregam o mesmo bloco de proveniência das demais ferramentas. No modo desenvolvedor do ChatGPT (Configurações → Segurança e login → Modo desenvolvedor) qualquer ferramenta pode ser chamada — para dados, as `ibge_*` continuam sendo as certas.
-
-## Exemplos de Uso das Ferramentas
-
-### ibge_estados
-
-Lista todos os estados brasileiros.
-
-```
-# Listar todos os estados
-ibge_estados
-
-# Estados da região Nordeste
-ibge_estados(regiao="NE")
-
-# Estados ordenados por sigla
-ibge_estados(ordenar="sigla")
-```
-
-### ibge_municipios
-
-Lista municípios brasileiros.
-
-```
-# Municípios do estado de São Paulo
-ibge_municipios(uf="SP")
-
-# Buscar municípios por nome
-ibge_municipios(busca="Campinas")
-
-# Municípios de MG contendo "Belo"
-ibge_municipios(uf="MG", busca="Belo")
-```
-
-### ibge_cidades
-
-Consulta indicadores municipais (similar ao portal Cidades@).
-
-```
-# Panorama de São Paulo
-ibge_cidades(tipo="panorama", municipio="3550308")
-
-# Histórico populacional
-ibge_cidades(tipo="historico", municipio="3550308", indicador="populacao")
-
-# Listar pesquisas disponíveis
-ibge_cidades(tipo="pesquisas")
-```
-
-**Indicadores disponíveis:** populacao, area, densidade, pib_per_capita, idh, escolarizacao, mortalidade, salario_medio, receitas, despesas
-
-### ibge_paises
-
-Consulta dados internacionais de países.
-
-```
-# Listar todos os países
-ibge_paises(tipo="listar")
-
-# Detalhes do Brasil
-ibge_paises(tipo="detalhes", pais="BR")
-
-# Buscar países
-ibge_paises(tipo="buscar", busca="Argentina")
-
-# Países das Américas
-ibge_paises(tipo="listar", regiao="americas")
-```
-
-**Regiões:** americas, europa, africa, asia, oceania
-
-### ibge_sidra
-
-Consulta tabelas SIDRA (Sistema IBGE de Recuperação Automática).
-
-```
-# População do Brasil em 2023
-ibge_sidra(tabela="6579", periodos="2023")
-
-# População por estado
-ibge_sidra(tabela="6579", nivel_territorial="3", periodos="2023")
-
-# Censo 2022 para o município de São Paulo
-ibge_sidra(tabela="9514", nivel_territorial="6", localidades="3550308")
-```
-
-**Tabelas comuns:**
-| Código | Descrição |
-|-------:|:----------|
-| 6579 | Estimativas populacionais (anual) |
-| 9514 | População Censo 2022 |
-| 4714 | Taxa de desemprego (PNAD) |
-| 6706 | PIB a preços correntes |
-
-**Níveis territoriais:**
-| Código | Nível |
-|-------:|:------|
-| 1 | Brasil |
-| 2 | Região (Norte, Nordeste, etc.) |
-| 3 | Estado (UF) |
-| 6 | Município |
-| 7 | Região Metropolitana |
-| 106 | Região de Saúde |
-| 127 | Amazônia Legal |
-| 128 | Semiárido |
-
-**Modo estatístico** (também em `ibge_censo`, `ibge_indicadores`,
-`ibge_datasaude`): para perguntas de maior/menor/média/mediana/distribuição/
-ranking, passe `estatisticas=true` — o servidor computa a distribuição completa
-(mínimo/máximo/média/mediana/desvio-padrão/percentis rotulados) sobre **todos**
-os registros, antes da paginação, e devolve rankings `top`/`bottom` (`topN`,
-padrão 10). `agruparPor="<rótulo da coluna>"` ranqueia os grupos por soma
-decrescente, cada um com sua mini-distribuição.
-
-```
-# Qual estado tem a maior população estimada?
-ibge_sidra(tabela="6579", nivel_territorial="3", estatisticas=true)
-
-# Distribuição da população do Censo 2022 agrupada por UF
-ibge_censo(ano="2022", tema="populacao", nivel_territorial="3", estatisticas=true, agruparPor="Unidade da Federação")
-```
-
-### ibge_censo
-
-Consulta dados censitários (1970-2022).
-
-```
-# População Censo 2022
-ibge_censo(ano="2022", tema="populacao")
-
-# Série histórica de população
-ibge_censo(ano="todos", tema="populacao")
-
-# Alfabetização por estado em 2010
-ibge_censo(ano="2010", tema="alfabetizacao", nivel_territorial="3")
-```
-
-**Temas disponíveis:** populacao, alfabetizacao, domicilios, idade_sexo, religiao, cor_raca, rendimento, migracao, educacao, trabalho
-
-### ibge_indicadores
-
-Consulta indicadores econômicos e sociais.
-
-```
-# PIB
-ibge_indicadores(indicador="pib")
-
-# IPCA últimos 12 meses
-ibge_indicadores(indicador="ipca", periodos="last 12")
-
-# Desemprego por estado
-ibge_indicadores(indicador="desemprego", nivel_territorial="3")
-
-# Listar todos os indicadores
-ibge_indicadores(indicador="listar")
-```
-
-**Indicadores disponíveis:**
-| Categoria | Indicadores |
-|:----------|:------------|
-| Econômicos | pib, pib_variacao, pib_per_capita, industria, comercio, servicos |
-| Preços | ipca, ipca_acumulado, inpc |
-| Trabalho | desemprego, ocupacao, rendimento, informalidade |
-| População | populacao, densidade |
-| Agropecuária | agricultura, pecuaria |
-
-### ibge_nomes
-
-Consulta frequência e rankings de nomes.
-
-```
-# Frequência de "Maria"
-ibge_nomes(tipo="frequencia", nomes="Maria")
-
-# Comparar nomes
-ibge_nomes(tipo="frequencia", nomes="João,José,Pedro")
-
-# Ranking de nomes nos anos 2000
-ibge_nomes(tipo="ranking", decada=2000)
-
-# Ranking de nomes femininos
-ibge_nomes(tipo="ranking", sexo="F")
-```
-
-### ibge_malhas
-
-Obtém malhas geográficas (mapas).
-
-```
-# Brasil com estados
-ibge_malhas(localidade="BR", resolucao="2")
-
-# São Paulo com municípios
-ibge_malhas(localidade="SP", resolucao="5")
-
-# Município específico
-ibge_malhas(localidade="3550308")
-
-# Formato SVG
-ibge_malhas(localidade="BR", formato="svg")
-```
-
-**Níveis de resolução:**
-| Valor | Divisões Internas |
-|:-----:|:------------------|
-| 0 | Sem divisões (apenas contorno) |
-| 2 | Estados |
-| 5 | Municípios |
-
-### ibge_datasaude
-
-Consulta indicadores de saúde servidos pelo SIDRA do IBGE (alguns originalmente do DataSUS, ex.: óbitos e nascidos vivos).
-
-```
-# Mortalidade infantil no Brasil
-ibge_datasaude(indicador="mortalidade_infantil")
-
-# Expectativa de vida por estado
-ibge_datasaude(indicador="esperanca_vida", nivel_territorial="3")
-
-# Listar indicadores
-ibge_datasaude(indicador="listar")
-```
-
-**Indicadores disponíveis:** mortalidade_infantil, esperanca_vida, nascidos_vivos, obitos, fecundidade, saneamento_agua, saneamento_esgoto, plano_saude
-
-## APIs Utilizadas
-
-### APIs do IBGE
-
-- **Localidades**: `servicodados.ibge.gov.br/api/v1/localidades`
-- **Nomes**: `servicodados.ibge.gov.br/api/v2/censos/nomes`
-- **Agregados/SIDRA**: `servicodados.ibge.gov.br/api/v3/agregados` (as tabelas do SIDRA são lidas aqui com `view=flat`; o `apisidra.ibge.gov.br` está atrás de um desafio do Cloudflare só para navegador desde 15/09/2026)
-- **Malhas**: `servicodados.ibge.gov.br/api/v3/malhas`
-- **Notícias**: `servicodados.ibge.gov.br/api/v3/noticias`
-- **População**: `servicodados.ibge.gov.br/api/v1/projecoes/populacao`
-- **CNAE**: `servicodados.ibge.gov.br/api/v2/cnae`
-- **Calendário**: `servicodados.ibge.gov.br/api/v3/calendario`
-- **Países**: `servicodados.ibge.gov.br/api/v1/paises`
-- **Pesquisas**: `servicodados.ibge.gov.br/api/v1/pesquisas`
-
-## Desenvolvimento
-
-```bash
-# Compilar
-npm run build
-
-# Modo watch
-npm run watch
-
-# Executar testes
-npm test
-
-# Executar testes em modo watch
-npm run test:watch
-
-# Executar testes com cobertura
-npm run test:coverage
-
-# Linter
-npm run lint
-
-# Formatar código
-npm run format
-
-# Testar com MCP inspector
-npm run inspector
-```
-
-## Estrutura do Projeto
-
-```
-ibge-br-mcp/
-├── src/
-│   ├── index.ts              # Servidor MCP principal
-│   ├── types.ts              # Tipos TypeScript
-│   ├── config.ts             # Configuração e constantes
-│   ├── cache.ts              # Sistema de cache de requisições
-│   ├── retry.ts              # Retry com backoff exponencial
-│   ├── errors.ts             # Tratamento de erros padronizado
-│   ├── validation.ts         # Helpers de validação de entrada
-│   ├── metrics.ts            # Métricas e logging
-│   ├── utils/
-│   │   └── formatters.ts     # Utilitários de formatação
-│   └── tools/
-│       ├── index.ts          # Exports das ferramentas
-│       ├── estados.ts        # ibge_estados
-│       ├── municipios.ts     # ibge_municipios
-│       ├── localidade.ts     # ibge_localidade
-│       ├── geocodigo.ts      # ibge_geocodigo
-│       ├── censo.ts          # ibge_censo
-│       ├── sidra.ts          # ibge_sidra
-│       ├── sidra-tabelas.ts  # ibge_sidra_tabelas
-│       ├── sidra-metadados.ts# ibge_sidra_metadados
-│       ├── indicadores.ts    # ibge_indicadores
-│       ├── cnae.ts           # ibge_cnae
-│       ├── calendario.ts     # ibge_calendario
-│       ├── comparar.ts       # ibge_comparar
-│       ├── malhas.ts         # ibge_malhas
-│       ├── malhas-tema.ts    # ibge_malhas_tema
-│       ├── vizinhos.ts       # ibge_vizinhos
-│       ├── datasaude.ts      # ibge_datasaude
-│       ├── pesquisas.ts      # ibge_pesquisas
-│       ├── nomes.ts          # ibge_nomes
-│       ├── noticias.ts       # ibge_noticias
-│       ├── paises.ts         # ibge_paises
-│       └── cidades.ts        # ibge_cidades
-├── tests/                    # Arquivos de teste
-├── dist/                     # Arquivos compilados
-├── package.json
-├── tsconfig.json
-├── vitest.config.ts
-└── README.md
-```
-
-## Testes
-
-O projeto inclui uma suíte de testes abrangente com 565 testes cobrindo:
-
-- Funções de validação
-- Mecanismo de retry
-- Utilitários de formatação
-- Tratamento de erros
-- Operações de cache
-- Testes de integração com mocks
-
-```bash
-npm test
-```
-
-## Garantia de Qualidade
-
-Este projeto mantém altos padrões de qualidade de código:
-
-- **565 testes automatizados** cobrindo validação, cache, retry, formatação e integrações
-- **88% de cobertura de testes no total** — os módulos cache e validation acima de 97%
-- **ESLint** para linting de código sem warnings
-- **Prettier** para formatação consistente
-- **TypeScript modo strict** para segurança de tipos
-- **CI/CD automatizado** via GitHub Actions
-
-Execute os testes localmente:
-```bash
-# Rodar todos os testes
-npm test
-
-# Rodar testes com cobertura
-npm run test:coverage
-
-# Rodar linter
-npm run lint
-```
-
-## Licença
-
-MIT
-
-## Autor
-
-Sidney da Silva Pereira Bissoli
-
-## Referências
-
-- [IBGE - Serviço de Dados](https://servicodados.ibge.gov.br/api/docs/)
-- [SIDRA - Sistema IBGE de Recuperação Automática](https://sidra.ibge.gov.br/)
-- [Model Context Protocol](https://modelcontextprotocol.io/)
-- [MCP TypeScript SDK](https://github.com/modelcontextprotocol/typescript-sdk)