ibge-br-mcp 3.0.2 → 3.1.0

package/README.md

@@ -4,11 +4,16 @@
 
 [![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)
 [![Tests](https://img.shields.io/badge/tests-456%20passed-brightgreen.svg)](https://github.com/SidneyBissoli/ibge-br-mcp)
 [![Coverage](https://img.shields.io/badge/coverage-core%2097%25-brightgreen.svg)](https://github.com/SidneyBissoli/ibge-br-mcp)
+[![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)
-[![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)
 
 **Live, exact Brazilian public data for your AI assistant — with provenance, not guesswork.**
 
@@ -18,6 +23,16 @@ Ask an LLM _"what was Belo Horizonte's population in the 2022 Census?"_ and you
 
 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).
 
+## See it in action
+
+Ask your assistant, in plain Portuguese:
+
+- *"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 per capita das capitais do Sudeste."* → `ibge_comparar`
+
+The answers come live from the official IBGE APIs — exact figures with the table and period they came from, not numbers guessed from training data.
+
 ## Features
 
 - **22 specialized tools** covering all major IBGE data domains

package/README.pt-BR.md

@@ -4,11 +4,16 @@
 
 [![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)
 [![Tests](https://img.shields.io/badge/tests-456%20passed-brightgreen.svg)](https://github.com/SidneyBissoli/ibge-br-mcp)
 [![Coverage](https://img.shields.io/badge/coverage-core%2097%25-brightgreen.svg)](https://github.com/SidneyBissoli/ibge-br-mcp)
+[![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)
-[![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)
 
 **Dados públicos brasileiros ao vivo e exatos para o seu assistente de IA — com procedência, não chute.**
 
@@ -18,6 +23,16 @@ Pergunte a um LLM _"qual era a população de Belo Horizonte no Censo 2022?"_ e
 
 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 per capita 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.
+
 ## Recursos
 
 - **22 ferramentas especializadas** cobrindo todos os principais domínios de dados do IBGE

package/dist/index.js

@@ -1,21 +1,17 @@
 #!/usr/bin/env node
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { serveStdio } from "@modelcontextprotocol/server/stdio";
 import { createServer, SERVER_NAME, SERVER_VERSION } from "./server.js";
 /**
  * Entry point: build the IBGE MCP Server and serve it over STDIO.
  *
  * Server construction lives in `server.ts` (side-effect-free, testable); this
- * file only wires it to the STDIO transport — stdout is the MCP protocol
+ * file only wires it to the STDIO transport. `serveStdio` owns the connection:
+ * it pins one server instance from the factory per connection and serves both
+ * the modern and the 2025-era protocol openings. stdout is the MCP protocol
  * channel, so all logging goes to stderr.
  */
-async function main() {
-    const server = createServer();
-    const transport = new StdioServerTransport();
-    await server.connect(transport);
-    console.error(`${SERVER_NAME} v${SERVER_VERSION} started`);
-}
-main().catch((error) => {
-    console.error("Fatal error:", error);
-    process.exit(1);
+serveStdio(() => createServer(), {
+    onerror: (error) => console.error("Transport error:", error),
 });
+console.error(`${SERVER_NAME} v${SERVER_VERSION} started`);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAExE;;;;;;GAMG;AACH,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAE9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,OAAO,CAAC,KAAK,CAAC,GAAG,WAAW,KAAK,cAAc,UAAU,CAAC,CAAC;AAC7D,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAEhE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAExE;;;;;;;;GAQG;AACH,UAAU,CAAC,GAAG,EAAE,CAAC,YAAY,EAAE,EAAE;IAC/B,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,kBAAkB,EAAE,KAAK,CAAC;CAC7D,CAAC,CAAC;AAEH,OAAO,CAAC,KAAK,CAAC,GAAG,WAAW,KAAK,cAAc,UAAU,CAAC,CAAC"}

package/dist/prompts.d.ts

@@ -6,7 +6,7 @@
  * building a demographic profile — so users don't have to remember which tools
  * to chain.
  */
-import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { McpServer } from "@modelcontextprotocol/server";
 /** Registers all analysis-template prompts on the server. */
 export declare function registerPrompts(server: McpServer): void;
 //# sourceMappingURL=prompts.d.ts.map

package/dist/prompts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAczE,6DAA6D;AAC7D,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA6DvD"}
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAc9D,6DAA6D;AAC7D,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA6DvD"}

package/dist/prompts.js

@@ -24,7 +24,7 @@ export function registerPrompts(server) {
     server.registerPrompt("comparar-municipios", {
         title: "Comparar municípios",
         description: "Compara 2 a 10 localidades (municípios ou UFs) em um indicador e produz um ranking comentado.",
-        argsSchema: {
+        argsSchema: z.object({
             localidades: z
                 .string()
                 .describe("Localidades separadas por vírgula — códigos IBGE ou nomes (ex.: 'São Paulo, Rio de Janeiro, Belo Horizonte')"),
@@ -32,7 +32,7 @@ export function registerPrompts(server) {
                 .string()
                 .optional()
                 .describe("Indicador a comparar (ex.: populacao, pib, densidade, alfabetizacao). Padrão: populacao"),
-        },
+        }),
     }, ({ localidades, indicador }) => {
         const ind = indicador?.trim() || "populacao";
         return userMessage(`Compare as seguintes localidades pelo indicador "${ind}": ${localidades}.
@@ -47,11 +47,11 @@ Passos:
     server.registerPrompt("perfil-demografico", {
         title: "Perfil demográfico",
         description: "Monta um perfil demográfico de uma localidade combinando população, censo e indicadores socioeconômicos.",
-        argsSchema: {
+        argsSchema: z.object({
             localidade: z
                 .string()
                 .describe("Município ou UF — código IBGE ou nome (ex.: '3550308' ou 'São Paulo')"),
-        },
+        }),
     }, ({ localidade }) => userMessage(`Monte um perfil demográfico da localidade: ${localidade}.
 
 Passos:

package/dist/prompts.js.map

@@ -1 +1 @@
-{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,6EAA6E;AAC7E,SAAS,WAAW,CAAC,IAAY;IAC/B,OAAO;QACL,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAe;gBACrB,OAAO,EAAE,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE;aACzC;SACF;KACF,CAAC;AACJ,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,eAAe,CAAC,MAAiB;IAC/C,iDAAiD;IACjD,MAAM,CAAC,cAAc,CACnB,qBAAqB,EACrB;QACE,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EACT,+FAA+F;QACjG,UAAU,EAAE;YACV,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,QAAQ,CACP,8GAA8G,CAC/G;YACH,SAAS,EAAE,CAAC;iBACT,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,yFAAyF,CAC1F;SACJ;KACF,EACD,CAAC,EAAE,WAAW,EAAE,SAAS,EAAE,EAAE,EAAE;QAC7B,MAAM,GAAG,GAAG,SAAS,EAAE,IAAI,EAAE,IAAI,WAAW,CAAC;QAC7C,OAAO,WAAW,CAChB,oDAAoD,GAAG,MAAM,WAAW;;;;6FAIa,GAAG;;0FAEN,CACnF,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,+CAA+C;IAC/C,MAAM,CAAC,cAAc,CACnB,oBAAoB,EACpB;QACE,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EACT,0GAA0G;QAC5G,UAAU,EAAE;YACV,UAAU,EAAE,CAAC;iBACV,MAAM,EAAE;iBACR,QAAQ,CAAC,uEAAuE,CAAC;SACrF;KACF,EACD,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CACjB,WAAW,CACT,8CAA8C,UAAU;;;;;;;iJAOiF,CAC1I,CACJ,CAAC;AACJ,CAAC"}
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,6EAA6E;AAC7E,SAAS,WAAW,CAAC,IAAY;IAC/B,OAAO;QACL,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAe;gBACrB,OAAO,EAAE,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE;aACzC;SACF;KACF,CAAC;AACJ,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,eAAe,CAAC,MAAiB;IAC/C,iDAAiD;IACjD,MAAM,CAAC,cAAc,CACnB,qBAAqB,EACrB;QACE,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EACT,+FAA+F;QACjG,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;YACnB,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,QAAQ,CACP,8GAA8G,CAC/G;YACH,SAAS,EAAE,CAAC;iBACT,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,yFAAyF,CAC1F;SACJ,CAAC;KACH,EACD,CAAC,EAAE,WAAW,EAAE,SAAS,EAAE,EAAE,EAAE;QAC7B,MAAM,GAAG,GAAG,SAAS,EAAE,IAAI,EAAE,IAAI,WAAW,CAAC;QAC7C,OAAO,WAAW,CAChB,oDAAoD,GAAG,MAAM,WAAW;;;;6FAIa,GAAG;;0FAEN,CACnF,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,+CAA+C;IAC/C,MAAM,CAAC,cAAc,CACnB,oBAAoB,EACpB;QACE,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EACT,0GAA0G;QAC5G,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;YACnB,UAAU,EAAE,CAAC;iBACV,MAAM,EAAE;iBACR,QAAQ,CAAC,uEAAuE,CAAC;SACrF,CAAC;KACH,EACD,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CACjB,WAAW,CACT,8CAA8C,UAAU;;;;;;;iJAOiF,CAC1I,CACJ,CAAC;AACJ,CAAC"}

package/dist/resources.d.ts

@@ -6,7 +6,7 @@
  * codes, biome codes — without guessing or spending a tool round-trip. Each is
  * a static `ibge://catalogos/...` resource returning JSON.
  */
-import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { McpServer } from "@modelcontextprotocol/server";
 /** Registers all reference-catalog resources on the server. */
 export declare function registerResources(server: McpServer): void;
 //# sourceMappingURL=resources.d.ts.map

package/dist/resources.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAwFzE,+DAA+D;AAC/D,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAmEzD"}
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAwF9D,+DAA+D;AAC/D,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAmEzD"}

package/dist/server.d.ts

@@ -1,6 +1,6 @@
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { McpServer } from "@modelcontextprotocol/server";
 export declare const SERVER_NAME = "ibge-br-mcp";
-export declare const SERVER_VERSION = "3.0.2";
+export declare const SERVER_VERSION: string;
 /**
  * Builds and configures the IBGE MCP Server with all tools, resources, and
  * prompts registered. Side-effect-free: it does NOT connect a transport, so it
@@ -10,11 +10,19 @@ export declare const SERVER_VERSION = "3.0.2";
  * Statistics) APIs (health data is served via IBGE's SIDRA).
  */
 export declare function createServer(): McpServer;
+/**
+ * Optional per-tool usage hook: called with `tool_call` on every invocation and
+ * additionally with `tool_error` when the call fails (error result or throw).
+ * The STDIO entry passes nothing; the Cloudflare Worker passes its Durable
+ * Object recorder (fire-and-forget telemetry — names and counts only, never
+ * tool arguments or results).
+ */
+export type ToolUsageRecorder = (kind: "tool_call" | "tool_error", name: string) => void;
 /**
  * Registers every tool, resource, and prompt onto a given `McpServer`. Kept
  * separate from `createServer` so an alternative transport (e.g. the Cloudflare
  * Worker in `worker/`, which builds its own `McpServer` with hosted metadata)
  * can reuse the exact same registrations.
  */
-export declare function registerAll(server: McpServer): void;
+export declare function registerAll(server: McpServer, record?: ToolUsageRecorder): void;
 //# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAkFpE,eAAO,MAAM,WAAW,gBAAgB,CAAC;AACzC,eAAO,MAAM,cAAc,UAAU,CAAC;AAgBtC;;;;;;;GAOG;AACH,wBAAgB,YAAY,IAAI,SAAS,CAOxC;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAg0BnD"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAwB,MAAM,8BAA8B,CAAC;AAoF/E,eAAO,MAAM,WAAW,gBAAgB,CAAC;AACzC,eAAO,MAAM,cAAc,QAAc,CAAC;AAgB1C;;;;;;;GAOG;AACH,wBAAgB,YAAY,IAAI,SAAS,CAOxC;AAED;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,IAAI,EAAE,WAAW,GAAG,YAAY,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;AAEzF;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAoyB/E"}

package/dist/server.js

@@ -1,4 +1,7 @@
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { McpServer } from "@modelcontextprotocol/server";
+// Version sourced from package.json (single source of truth — avoids drift).
+// Node ESM reads it via the import attribute; esbuild inlines it for the Worker build.
+import pkg from "../package.json" with { type: "json" };
 import { toMcpResult } from "./structured.js";
 import { estadosSchema, estadosOutputSchema, ibgeEstados, municipiosSchema, municipiosOutputSchema, ibgeMunicipios, localidadeSchema, localidadeOutputSchema, ibgeLocalidade, populacaoSchema, populacaoOutputSchema, ibgePopulacao, sidraSchema, sidraOutputSchema, ibgeSidra, nomesSchema, nomesOutputSchema, ibgeNomes, noticiasSchema, noticiasOutputSchema, ibgeNoticias, sidraTabelasSchema, sidraTabelasOutputSchema, ibgeSidraTabelas, sidraMetadadosSchema, sidraMetadadosOutputSchema, ibgeSidraMetadados, malhasSchema, malhasOutputSchema, ibgeMalhas, pesquisasSchema, pesquisasOutputSchema, ibgePesquisas, censoSchema, censoOutputSchema, ibgeCenso, 
 // Phase 1 tools (v1.4.0)
@@ -13,7 +16,7 @@ import { registerResources } from "./resources.js";
 import { registerPrompts } from "./prompts.js";
 // Server metadata
 export const SERVER_NAME = "ibge-br-mcp";
-export const SERVER_VERSION = "3.0.2";
+export const SERVER_VERSION = pkg.version;
 /**
  * Every tool here is a read-only query against a public REST API: it never
  * mutates state (`readOnlyHint`), repeating a call yields the same effect
@@ -49,7 +52,22 @@ export function createServer() {
  * Worker in `worker/`, which builds its own `McpServer` with hosted metadata)
  * can reuse the exact same registrations.
  */
-export function registerAll(server) {
+export function registerAll(server, record) {
+    /** Wraps a tool impl into the registered handler, instrumented via `record`. */
+    const handle = (name, fn) => async (args) => {
+        try {
+            const result = toMcpResult(await fn(args));
+            record?.("tool_call", name);
+            if (result.isError === true)
+                record?.("tool_error", name);
+            return result;
+        }
+        catch (error) {
+            record?.("tool_call", name);
+            record?.("tool_error", name);
+            throw error;
+        }
+    };
     // Register ibge_estados tool
     server.registerTool("ibge_estados", {
         description: `Lists all Brazilian states from IBGE.
@@ -69,12 +87,10 @@ Use a different tool when:
 - Details/hierarchy of one locality by code → ibge_localidade
 
 Behavior: read-only and idempotent — a live GET against the public IBGE Localidades API. Returns a Markdown table.`,
-        inputSchema: estadosSchema.shape,
-        outputSchema: estadosOutputSchema.shape,
+        inputSchema: estadosSchema,
+        outputSchema: estadosOutputSchema,
         annotations: READ_ONLY,
-    }, async (args) => {
-        return toMcpResult(await ibgeEstados(args));
-    });
+    }, handle("ibge_estados", ibgeEstados));
     // Register ibge_municipios tool
     server.registerTool("ibge_municipios", {
         description: `Lists Brazilian municipalities from IBGE.
@@ -96,12 +112,10 @@ Use a different tool when:
 - Neighboring municipalities → ibge_vizinhos
 
 Behavior: read-only and idempotent — a live GET against the public IBGE Localidades API. Returns a Markdown table.`,
-        inputSchema: municipiosSchema.shape,
-        outputSchema: municipiosOutputSchema.shape,
+        inputSchema: municipiosSchema,
+        outputSchema: municipiosOutputSchema,
         annotations: READ_ONLY,
-    }, async (args) => {
-        return toMcpResult(await ibgeMunicipios(args));
-    });
+    }, handle("ibge_municipios", ibgeMunicipios));
     // Register ibge_localidade tool
     server.registerTool("ibge_localidade", {
         description: `Returns details of a specific locality by IBGE code.
@@ -123,12 +137,10 @@ Use a different tool when:
 - You want to decompose/understand a code's structure → ibge_geocodigo
 
 Behavior: read-only and idempotent — a live GET against the public IBGE Localidades API. Returns a Markdown record.`,
-        inputSchema: localidadeSchema.shape,
-        outputSchema: localidadeOutputSchema.shape,
+        inputSchema: localidadeSchema,
+        outputSchema: localidadeOutputSchema,
         annotations: READ_ONLY,
-    }, async (args) => {
-        return toMcpResult(await ibgeLocalidade(args));
-    });
+    }, handle("ibge_localidade", ibgeLocalidade));
     // Register ibge_populacao tool
     server.registerTool("ibge_populacao", {
         description: `Returns real-time Brazilian population projection.
@@ -151,12 +163,10 @@ Use a different tool when:
 - An arbitrary SIDRA table → ibge_sidra
 
 Behavior: read-only and idempotent — a live GET against the public IBGE population-projection API. Returns Markdown plus a typed structuredContent payload.`,
-        inputSchema: populacaoSchema.shape,
-        outputSchema: populacaoOutputSchema.shape,
+        inputSchema: populacaoSchema,
+        outputSchema: populacaoOutputSchema,
         annotations: READ_ONLY,
-    }, async (args) => {
-        return toMcpResult(await ibgePopulacao(args));
-    });
+    }, handle("ibge_populacao", ibgePopulacao));
     // Register ibge_sidra tool
     server.registerTool("ibge_sidra", {
         description: `Queries SIDRA tables (IBGE's Automatic Recovery System).
@@ -192,12 +202,10 @@ ibge_sidra is the low-level engine. Prefer a friendlier wrapper when it fits:
 Use ibge_sidra_tabelas and ibge_sidra_metadados to find a table code and its structure before querying.
 
 Behavior: read-only and idempotent — a live GET against the public IBGE SIDRA API. Returns Markdown plus a typed structuredContent payload.`,
-        inputSchema: sidraSchema.shape,
-        outputSchema: sidraOutputSchema.shape,
+        inputSchema: sidraSchema,
+        outputSchema: sidraOutputSchema,
         annotations: READ_ONLY,
-    }, async (args) => {
-        return toMcpResult(await ibgeSidra(args));
-    });
+    }, handle("ibge_sidra", ibgeSidra));
     // Register ibge_nomes tool
     server.registerTool("ibge_nomes", {
         description: `Queries name frequency and rankings in Brazil (IBGE).
@@ -221,12 +229,10 @@ Examples:
 - Female names: tipo="ranking", sexo="F"
 
 Behavior: read-only and idempotent — a live GET against the public IBGE Nomes (Censo) API. Returns a Markdown table.`,
-        inputSchema: nomesSchema.shape,
-        outputSchema: nomesOutputSchema.shape,
+        inputSchema: nomesSchema,
+        outputSchema: nomesOutputSchema,
         annotations: READ_ONLY,
-    }, async (args) => {
-        return toMcpResult(await ibgeNomes(args));
-    });
+    }, handle("ibge_nomes", ibgeNomes));
     // Register ibge_noticias tool
     server.registerTool("ibge_noticias", {
         description: `Searches and lists already-published IBGE news articles and press releases.
@@ -252,12 +258,10 @@ Use a different tool when:
 - Scheduled/upcoming release dates (not yet published) → ibge_calendario
 
 Behavior: read-only and idempotent — a live GET against the public IBGE Notícias API. Returns a Markdown list.`,
-        inputSchema: noticiasSchema.shape,
-        outputSchema: noticiasOutputSchema.shape,
+        inputSchema: noticiasSchema,
+        outputSchema: noticiasOutputSchema,
         annotations: READ_ONLY,
-    }, async (args) => {
-        return toMcpResult(await ibgeNoticias(args));
-    });
+    }, handle("ibge_noticias", ibgeNoticias));
     // Register ibge_sidra_tabelas tool
     server.registerTool("ibge_sidra_tabelas", {
         description: `Lists and searches available SIDRA tables.
@@ -284,12 +288,10 @@ This is step 1 of the SIDRA workflow: find a table code → ibge_sidra_metadados
 For common data, a wrapper is usually easier: ibge_censo, ibge_indicadores, ibge_comparar, ibge_cidades.
 
 Behavior: read-only and idempotent — a live GET against the public IBGE SIDRA API. Returns a Markdown table.`,
-        inputSchema: sidraTabelasSchema.shape,
-        outputSchema: sidraTabelasOutputSchema.shape,
+        inputSchema: sidraTabelasSchema,
+        outputSchema: sidraTabelasOutputSchema,
         annotations: READ_ONLY,
-    }, async (args) => {
-        return toMcpResult(await ibgeSidraTabelas(args));
-    });
+    }, handle("ibge_sidra_tabelas", ibgeSidraTabelas));
     // Register ibge_sidra_metadados tool
     server.registerTool("ibge_sidra_metadados", {
         description: `Returns metadata for a specific SIDRA table.
@@ -311,12 +313,10 @@ Examples:
 Use this after finding a table code (ibge_sidra_tabelas) and before querying with ibge_sidra.
 
 Behavior: read-only and idempotent — a live GET against the public IBGE SIDRA API. Returns Markdown.`,
-        inputSchema: sidraMetadadosSchema.shape,
-        outputSchema: sidraMetadadosOutputSchema.shape,
+        inputSchema: sidraMetadadosSchema,
+        outputSchema: sidraMetadadosOutputSchema,
         annotations: READ_ONLY,
-    }, async (args) => {
-        return toMcpResult(await ibgeSidraMetadados(args));
-    });
+    }, handle("ibge_sidra_metadados", ibgeSidraMetadados));
     // Register ibge_malhas tool
     server.registerTool("ibge_malhas", {
         description: `Gets geographic meshes (maps) from IBGE in GeoJSON, TopoJSON, or SVG format.
@@ -347,12 +347,10 @@ Use a different tool when:
 - Thematic meshes (biomes, Legal Amazon, semi-arid, metropolitan regions) → ibge_malhas_tema
 
 Behavior: read-only and idempotent — a live GET against the public IBGE Malhas API. Returns the mesh in the requested format (GeoJSON, TopoJSON, or SVG).`,
-        inputSchema: malhasSchema.shape,
-        outputSchema: malhasOutputSchema.shape,
+        inputSchema: malhasSchema,
+        outputSchema: malhasOutputSchema,
         annotations: READ_ONLY,
-    }, async (args) => {
-        return toMcpResult(await ibgeMalhas(args));
-    });
+    }, handle("ibge_malhas", ibgeMalhas));
     // Register ibge_pesquisas tool
     server.registerTool("ibge_pesquisas", {
         description: `Lists available IBGE surveys and their tables.
@@ -378,12 +376,10 @@ Examples:
 This lists surveys, not data. To find table codes use ibge_sidra_tabelas; to query data use ibge_sidra (or a wrapper: ibge_censo, ibge_indicadores, ibge_comparar, ibge_cidades).
 
 Behavior: read-only and idempotent — a live GET against the public IBGE SIDRA/Pesquisas API. Returns a Markdown list.`,
-        inputSchema: pesquisasSchema.shape,
-        outputSchema: pesquisasOutputSchema.shape,
+        inputSchema: pesquisasSchema,
+        outputSchema: pesquisasOutputSchema,
         annotations: READ_ONLY,
-    }, async (args) => {
-        return toMcpResult(await ibgePesquisas(args));
-    });
+    }, handle("ibge_pesquisas", ibgePesquisas));
     // Register ibge_censo tool
     server.registerTool("ibge_censo", {
         description: `Queries IBGE Demographic Census data (1970-2022).
@@ -416,12 +412,10 @@ Use a different tool when:
 - An arbitrary SIDRA table → ibge_sidra
 
 Behavior: read-only and idempotent — a live GET against the public IBGE SIDRA API. Returns Markdown plus a typed structuredContent payload.`,
-        inputSchema: censoSchema.shape,
-        outputSchema: censoOutputSchema.shape,
+        inputSchema: censoSchema,
+        outputSchema: censoOutputSchema,
         annotations: READ_ONLY,
-    }, async (args) => {
-        return toMcpResult(await ibgeCenso(args));
-    });
+    }, handle("ibge_censo", ibgeCenso));
     // Register ibge_indicadores tool (Phase 1)
     server.registerTool("ibge_indicadores", {
         description: `Queries IBGE economic and social indicators.
@@ -463,12 +457,10 @@ Use a different tool when:
 - One municipality's panel → ibge_cidades
 
 Behavior: read-only and idempotent — a live GET against the public IBGE SIDRA API. Returns Markdown plus a typed structuredContent payload.`,
-        inputSchema: indicadoresSchema.shape,
-        outputSchema: indicadoresOutputSchema.shape,
+        inputSchema: indicadoresSchema,
+        outputSchema: indicadoresOutputSchema,
         annotations: READ_ONLY,
-    }, async (args) => {
-        return toMcpResult(await ibgeIndicadores(args));
-    });
+    }, handle("ibge_indicadores", ibgeIndicadores));
     // Register ibge_cnae tool (Phase 1)
     server.registerTool("ibge_cnae", {
         description: `Queries CNAE (National Classification of Economic Activities) from IBGE.
@@ -495,12 +487,10 @@ Examples:
 - List divisions: nivel="divisoes"
 
 Behavior: read-only and idempotent — a live GET against the public IBGE CNAE API. Returns Markdown.`,
-        inputSchema: cnaeSchema.shape,
-        outputSchema: cnaeOutputSchema.shape,
+        inputSchema: cnaeSchema,
+        outputSchema: cnaeOutputSchema,
         annotations: READ_ONLY,
-    }, async (args) => {
-        return toMcpResult(await ibgeCnae(args));
-    });
+    }, handle("ibge_cnae", ibgeCnae));
     // Register ibge_geocodigo tool (Phase 1)
     server.registerTool("ibge_geocodigo", {
         description: `Decodes IBGE codes or searches codes by locality name.
@@ -529,12 +519,10 @@ Use a different tool when:
 - You want the full detailed record of one locality → ibge_localidade
 
 Behavior: read-only and idempotent — a live GET against the public IBGE Localidades API. Returns Markdown.`,
-        inputSchema: geocodigoSchema.shape,
-        outputSchema: geocodigoOutputSchema.shape,
+        inputSchema: geocodigoSchema,
+        outputSchema: geocodigoOutputSchema,
         annotations: READ_ONLY,
-    }, async (args) => {
-        return toMcpResult(await ibgeGeocodigo(args));
-    });
+    }, handle("ibge_geocodigo", ibgeGeocodigo));
     // Register ibge_calendario tool (Phase 2)
     server.registerTool("ibge_calendario", {
         description: `Queries IBGE release and collection calendar.
@@ -559,12 +547,10 @@ Use a different tool when:
 - Already-published news and releases → ibge_noticias
 
 Behavior: read-only and idempotent — a live GET against the public IBGE Calendário API. Returns a Markdown list.`,
-        inputSchema: calendarioSchema.shape,
-        outputSchema: calendarioOutputSchema.shape,
+        inputSchema: calendarioSchema,
+        outputSchema: calendarioOutputSchema,
         annotations: READ_ONLY,
-    }, async (args) => {
-        return toMcpResult(await ibgeCalendario(args));
-    });
+    }, handle("ibge_calendario", ibgeCalendario));
     // Register ibge_comparar tool (Phase 2)
     server.registerTool("ibge_comparar", {
         description: `Compares data between localities (municipalities or states).
@@ -594,12 +580,10 @@ Use this tool ONLY to rank/compare 2–10 localities on one indicator.
 For a single locality, use ibge_cidades (municipal panel), ibge_censo, or ibge_sidra.
 
 Behavior: read-only and idempotent — a live GET against the public IBGE APIs (SIDRA and Localidades). Returns Markdown plus a typed structuredContent payload.`,
-        inputSchema: compararSchema.shape,
-        outputSchema: compararOutputSchema.shape,
+        inputSchema: compararSchema,
+        outputSchema: compararOutputSchema,
         annotations: READ_ONLY,
-    }, async (args) => {
-        return toMcpResult(await ibgeComparar(args));
-    });
+    }, handle("ibge_comparar", ibgeComparar));
     // Register ibge_malhas_tema tool (Phase 3)
     server.registerTool("ibge_malhas_tema", {
         description: `Gets thematic geographic meshes from IBGE.
@@ -633,12 +617,10 @@ Use a different tool when:
 - Administrative meshes (Brazil/region/state/municipality outlines) → ibge_malhas
 
 Behavior: read-only and idempotent — a live GET against the public IBGE Malhas API. Returns the mesh in the requested format (GeoJSON, TopoJSON, or SVG).`,
-        inputSchema: malhasTemaSchema.shape,
-        outputSchema: malhasTemaOutputSchema.shape,
+        inputSchema: malhasTemaSchema,
+        outputSchema: malhasTemaOutputSchema,
         annotations: READ_ONLY,
-    }, async (args) => {
-        return toMcpResult(await ibgeMalhasTema(args));
-    });
+    }, handle("ibge_malhas_tema", ibgeMalhasTema));
     // Register ibge_vizinhos tool (Phase 3)
     server.registerTool("ibge_vizinhos", {
         description: `Finds nearby/neighboring municipalities.
@@ -660,12 +642,10 @@ Note: proximity is approximated by shared mesoregion (not exact spatial adjacenc
 For listing/searching municipalities, use ibge_municipios.
 
 Behavior: read-only and idempotent — a live GET against the public IBGE Localidades API. Returns a Markdown list.`,
-        inputSchema: vizinhosSchema.shape,
-        outputSchema: vizinhosOutputSchema.shape,
+        inputSchema: vizinhosSchema,
+        outputSchema: vizinhosOutputSchema,
         annotations: READ_ONLY,
-    }, async (args) => {
-        return toMcpResult(await ibgeVizinhos(args));
-    });
+    }, handle("ibge_vizinhos", ibgeVizinhos));
     // Register ibge_datasaude tool (Phase 3)
     server.registerTool("ibge_datasaude", {
         description: `Queries Brazil health indicators, served through IBGE's SIDRA (some originally produced by DataSUS, e.g. mortality and births).
@@ -701,12 +681,10 @@ Use a different tool when:
 - Population/demographic counts (not health-specific) → ibge_censo or ibge_sidra
 
 Behavior: read-only and idempotent — a live GET against the public IBGE SIDRA API. Returns Markdown plus a typed structuredContent payload.`,
-        inputSchema: datasaudeSchema.shape,
-        outputSchema: datasaudeOutputSchema.shape,
+        inputSchema: datasaudeSchema,
+        outputSchema: datasaudeOutputSchema,
         annotations: READ_ONLY,
-    }, async (args) => {
-        return toMcpResult(await ibgeDatasaude(args));
-    });
+    }, handle("ibge_datasaude", ibgeDatasaude));
     // Register ibge_paises tool (Phase 4)
     server.registerTool("ibge_paises", {
         description: `Queries international country data via IBGE.
@@ -729,12 +707,10 @@ Examples:
 - Available indicators: tipo="indicadores"
 
 Behavior: read-only and idempotent — a live GET against the public IBGE Países API. Returns Markdown.`,
-        inputSchema: paisesSchema.shape,
-        outputSchema: paisesOutputSchema.shape,
+        inputSchema: paisesSchema,
+        outputSchema: paisesOutputSchema,
         annotations: READ_ONLY,
-    }, async (args) => {
-        return toMcpResult(await ibgePaises(args));
-    });
+    }, handle("ibge_paises", ibgePaises));
     // Register ibge_cidades tool (Phase 4)
     server.registerTool("ibge_cidades", {
         description: `Queries municipal indicators from IBGE (similar to Cidades@ portal).
@@ -762,12 +738,10 @@ Use a different tool when:
 - A macro indicator time series → ibge_indicadores
 
 Behavior: read-only and idempotent — a live GET against the public IBGE APIs (Cidades@/agregados). Returns Markdown plus a typed structuredContent payload.`,
-        inputSchema: cidadesSchema.shape,
-        outputSchema: cidadesOutputSchema.shape,
+        inputSchema: cidadesSchema,
+        outputSchema: cidadesOutputSchema,
         annotations: READ_ONLY,
-    }, async (args) => {
-        return toMcpResult(await ibgeCidades(args));
-    });
+    }, handle("ibge_cidades", ibgeCidades));
     // Reference catalogs (roadmap 1.6) and analysis templates
     registerResources(server);
     registerPrompts(server);