brasil-data-mcp 0.1.0 → 0.3.0

package/README.md

@@ -1,12 +1,15 @@
 # brasil-data-mcp
 
 [![npm version](https://img.shields.io/npm/v/brasil-data-mcp.svg)](https://www.npmjs.com/package/brasil-data-mcp)
+[![npm downloads](https://img.shields.io/npm/dm/brasil-data-mcp.svg)](https://www.npmjs.com/package/brasil-data-mcp)
+[![CI](https://github.com/alanpcf/brasil-data-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/alanpcf/brasil-data-mcp/actions/workflows/ci.yml)
 [![license](https://img.shields.io/npm/l/brasil-data-mcp.svg)](./LICENSE)
 [![node](https://img.shields.io/node/v/brasil-data-mcp.svg)](https://nodejs.org)
+[![Glama MCP server](https://glama.ai/mcp/servers/alanpcf/brasil-data-mcp/badges/score.svg)](https://glama.ai/mcp/servers/alanpcf/brasil-data-mcp)
 
-> MCP server que expõe dados públicos brasileiros (CNPJ, CEP, bancos, feriados) como tools pra Claude Desktop, Claude Code, Cursor, Windsurf e qualquer cliente compatível com [Model Context Protocol](https://modelcontextprotocol.io).
+> MCP server que expõe dados públicos brasileiros (CNPJ, CEP, bancos, feriados, DDD, ISBN, taxas econômicas, câmbio, corretoras CVM, estados e municípios IBGE, domínios .br) como tools pra Claude Desktop, Claude Code, Cursor, Windsurf e qualquer cliente compatível com [Model Context Protocol](https://modelcontextprotocol.io). Inclui também **prompts MCP** (workflows guiados).
 >
-> _MCP server exposing Brazilian public data (CNPJ, CEP, banks, holidays) as tools for Claude Desktop, Claude Code, Cursor, Windsurf and any MCP-compatible client._
+> _MCP server exposing Brazilian public data (CNPJ, CEP, banks, holidays, area codes, ISBN, economic rates, exchange rates, CVM brokers, IBGE states/municipalities, .br domains) as tools for Claude Desktop, Claude Code, Cursor, Windsurf and any MCP-compatible client. Ships with MCP prompts for guided workflows._
 
 Powered by [BrasilAPI](https://brasilapi.com.br) — sem chave, sem auth, dados oficiais.
 
@@ -20,26 +23,52 @@ Conecte seu cliente de IA aos dados públicos brasileiros sem escrever uma linha
 - _"Esse CEP 01310-100 é em qual cidade?"_
 - _"Quem é o banco com código 341?"_
 - _"Quais os feriados nacionais de 2026?"_
+- _"Quais cidades têm DDD 41?"_
+- _"Me dá o livro do ISBN 9788532530802."_
+- _"Qual a SELIC hoje?"_
+- _"A corretora de CNPJ 02.332.886/0011-78 ainda tá ativa?"_
+- _"Quanto fechou o dólar sexta-feira?"_
+- _"Quais os municípios do Acre?"_
+- _"meuprojeto.com.br tá disponível?"_
 
 O Claude (ou outro cliente MCP) chama a tool, retorna o JSON estruturado, e você lê a resposta em português direto na conversa.
 
-### Tools disponíveis
-
-| Tool                  | O que faz                                                                       |
-| --------------------- | ------------------------------------------------------------------------------- |
-| `consultar_cnpj`      | Dados cadastrais de empresa: razão social, situação, endereço, sócios, CNAE     |
-| `consultar_cep`       | Endereço completo a partir de CEP (logradouro, bairro, cidade, UF, coordenadas) |
-| `consultar_banco`     | Nome e ISPB de banco brasileiro pelo código COMPE (ex: 341 = Itaú, 260 = Nubank) |
-| `listar_bancos`       | Lista completa de bancos brasileiros cadastrados no BACEN (~250 instituições)   |
-| `consultar_feriados`  | Feriados nacionais de um ano (datas, nome, tipo) — inclui Carnaval e Páscoa     |
+### Tools disponíveis (15)
+
+| Tool                   | O que faz                                                                          |
+| ---------------------- | ---------------------------------------------------------------------------------- |
+| `consultar_cnpj`       | Dados cadastrais de empresa: razão social, situação, endereço, sócios, CNAE        |
+| `consultar_cep`        | Endereço completo a partir de CEP (logradouro, bairro, cidade, UF, coordenadas)    |
+| `consultar_banco`      | Nome e ISPB de banco brasileiro pelo código COMPE (ex: 341 = Itaú, 260 = Nubank)   |
+| `listar_bancos`        | Lista completa de bancos brasileiros cadastrados no BACEN (~250 instituições)      |
+| `consultar_feriados`   | Feriados nacionais de um ano (datas, nome, tipo) — inclui Carnaval e Páscoa        |
+| `consultar_ddd`        | Estado e cidades atendidas por um código DDD (ex: 11 = SP capital + região metro)  |
+| `consultar_isbn`       | Metadados de livro pelo ISBN-10/13 (título, autor, editora, ano, idioma, páginas)  |
+| `consultar_taxa`       | Valor atual de taxa econômica (SELIC, CDI, IPCA) em % ao ano                       |
+| `listar_taxas`         | Panorama com todas as taxas econômicas vigentes                                    |
+| `consultar_corretora`  | Dados cadastrais de corretora de valores autorizada pela CVM (status, endereço)    |
+| `consultar_cambio`     | Cotação de câmbio (USD, EUR, +8 moedas) em BRL por data — boletins PTAX/BACEN      |
+| `listar_moedas`        | Moedas estrangeiras com cotação disponível (símbolo, nome, tipo)                   |
+| `listar_estados`       | As 27 UFs com código IBGE, nome, região e capital                                  |
+| `consultar_municipios` | Municípios de uma UF com nome e código IBGE de 7 dígitos                           |
+| `consultar_dominio_br` | Disponibilidade/status de domínio .br no registro.br (DNS, expiração, sugestões)   |
+
+### Prompts disponíveis (2)
+
+Prompts MCP são **workflows guiados** que aparecem como atalho no Claude Desktop. Você seleciona, preenche o argumento e o LLM segue o roteiro pré-definido (chama tools, interpreta, responde).
+
+| Prompt               | O que faz                                                                                |
+| -------------------- | ---------------------------------------------------------------------------------------- |
+| `analise-cnpj`       | Recebe um CNPJ, consulta na Receita e produz análise estruturada (setor, idade, porte)   |
+| `panorama-economico` | Combina taxas vigentes + próximos feriados nacionais em um snapshot conciso              |
 
 ---
 
 ## 🇺🇸 EN — What is it?
 
-Plug your AI client into Brazilian public data with zero code. Ask in natural language and the LLM picks the right tool, calls it, and answers you with structured data from official sources (Receita Federal, ViaCEP, BACEN).
+Plug your AI client into Brazilian public data with zero code. Ask in natural language and the LLM picks the right tool, calls it, and answers you with structured data from official sources (Receita Federal, ViaCEP, BACEN, CVM, BrasilAPI).
 
-Currently ships with `consultar_cnpj`. CEP, banks and holidays are landing next.
+15 tools covering CNPJ, CEP, banks, holidays, area codes (DDD), ISBN, economic rates (SELIC/CDI/IPCA), exchange rates (PTAX/BACEN), CVM brokers, IBGE states and municipalities, and .br domain availability — plus 2 MCP prompts (`analise-cnpj`, `panorama-economico`) for guided workflows.
 
 ---
 
@@ -122,8 +151,10 @@ Pra apontar seu cliente MCP pro build local em vez do pacote do npm:
 
 - [x] **Fase 1** — Esqueleto + cliente HTTP + `consultar_cnpj`
 - [x] **Fase 2** — `consultar_cep`, `consultar_banco`, `listar_bancos`, `consultar_feriados` + testes Vitest
-- [ ] **Fase 3** — CI (GitHub Actions), CONTRIBUTING.md, cobertura > 80%, publicação no npm
-- [ ] **Fase 4** — FIPE, DDD, ISBN, taxas (SELIC/CDI/IPCA), CVM, MCP prompts pra workflows
+- [x] **Fase 3** — CI (GitHub Actions), `CONTRIBUTING.md`, cobertura 94%/85%, publicação no [npm](https://www.npmjs.com/package/brasil-data-mcp), listagem no [Glama](https://glama.ai/mcp/servers/alanpcf/brasil-data-mcp)
+- [x] **Fase 4 (v0.2.0)** — `consultar_ddd`, `consultar_isbn`, `consultar_taxa` + `listar_taxas`, `consultar_corretora` (CVM) + MCP prompts (`analise-cnpj`, `panorama-economico`)
+- [x] **Fase 5 (v0.3.0)** — `consultar_cambio` + `listar_moedas` (PTAX/BACEN), `listar_estados` + `consultar_municipios` (IBGE), `consultar_dominio_br` (registro.br); versão single-source; registry declarativo de tools; testes do caminho de retry
+- [ ] **Próximo** — FIPE (aguardando upstream estabilizar, [BrasilAPI#805](https://github.com/BrasilAPI/BrasilAPI/issues/805)); Trusted Publishing (npm OIDC); mais prompts conforme demanda
 
 ---
 
@@ -141,7 +172,7 @@ Se você é dev brasileiro e usa LLM no dia a dia, esse server é pra você.
 
 Issues e PRs muito bem-vindos. Pra adicionar uma tool nova, siga o padrão de `src/tools/cnpj.ts` (schema Zod + descrição + handler) e registre em `src/index.ts`.
 
-Guia detalhado em `CONTRIBUTING.md` _(em breve)_.
+Guia detalhado em [CONTRIBUTING.md](./CONTRIBUTING.md).
 
 ---
 

package/dist/index.d.ts

@@ -6,17 +6,18 @@ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
  *
  * Boot:
  *   1. Cria um McpServer (high-level API do SDK 1.x).
- *   2. Registra cada tool via registerTool — o SDK deriva o JSON Schema do
+ *   2. Registra cada tool do array TOOLS — o SDK deriva o JSON Schema do
  *      schema Zod, então atendemos "validação dupla" (Zod runtime + JSON
  *      Schema na definição) com uma única declaração por tool.
- *   3. Conecta no StdioServerTransport e fica em loop atendendo requisições.
+ *   3. Registra prompts (workflows) via registerPrompt.
+ *   4. Conecta no StdioServerTransport e fica em loop atendendo requisições.
  *
  * REGRA CRÍTICA: nunca escrever em stdout fora do protocolo. Logs em stderr
  * via console.error. console.log corrompe o canal MCP.
  *
- * REGISTRY: adicionar tool nova = uma chamada de registerTool. O helper
- * wrapHandler aplica o try/catch defensivo padronizado (bug numa tool não
- * derruba o server).
+ * REGISTRY: adicionar tool nova = uma entrada no array TOOLS. O loop de
+ * registro aplica o wrapHandler (try/catch defensivo padronizado — bug numa
+ * tool não derruba o server) uniformemente, sem risco de esquecer.
  */
 
 declare function createServer(): McpServer;

package/dist/index.js

@@ -4,15 +4,108 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 
-// src/tools/banco.ts
+// src/prompts/analise-cnpj.ts
 import { z } from "zod";
+var analiseCnpjArgsSchema = {
+  cnpj: z.string().describe(
+    "CNPJ da empresa a analisar (com ou sem m\xE1scara). Ex: 33.000.167/0001-01"
+  )
+};
+var analiseCnpjPrompt = {
+  name: "analise-cnpj",
+  title: "Analisar empresa por CNPJ",
+  description: "Workflow guiado: consulta os dados cadastrais do CNPJ na Receita Federal e produz uma an\xE1lise interpretada \u2014 setor de atua\xE7\xE3o (CNAE principal), idade da empresa, situa\xE7\xE3o cadastral, porte, quadro societ\xE1rio e observa\xE7\xF5es relevantes.",
+  argsSchema: analiseCnpjArgsSchema
+};
+function analiseCnpjHandler(args) {
+  const cnpj = args.cnpj.trim();
+  return {
+    messages: [
+      {
+        role: "user",
+        content: {
+          type: "text",
+          text: [
+            `Fa\xE7a uma an\xE1lise completa da empresa de CNPJ ${cnpj}.`,
+            "",
+            "Passos:",
+            `1. Chame a tool consultar_cnpj com o CNPJ ${cnpj}.`,
+            "2. Com base nos dados retornados, produza uma an\xE1lise estruturada cobrindo:",
+            "   - **Identifica\xE7\xE3o**: raz\xE3o social, nome fantasia.",
+            "   - **Situa\xE7\xE3o cadastral**: ativa/baixada/suspensa, motivo se aplic\xE1vel, data.",
+            "   - **Idade**: anos desde a abertura (calcule a partir da data de in\xEDcio).",
+            "   - **Porte**: MEI/ME/EPP/Demais, capital social.",
+            "   - **Atividade**: CNAE principal traduzido em linguagem simples + secund\xE1rios relevantes.",
+            "   - **Localiza\xE7\xE3o**: cidade/UF.",
+            "   - **Quadro societ\xE1rio (QSA)**: n\xFAmero de s\xF3cios, principais.",
+            "   - **Observa\xE7\xF5es**: empresa Simples Nacional? MEI? Algo que chame aten\xE7\xE3o (situa\xE7\xE3o irregular, idade incomum, atividade restrita)?",
+            "",
+            "Seja objetivo. N\xE3o recomende decis\xF5es de neg\xF3cio \u2014 s\xF3 apresente os fatos extra\xEDdos."
+          ].join("\n")
+        }
+      }
+    ]
+  };
+}
+
+// src/prompts/panorama-economico.ts
+var panoramaEconomicoPrompt = {
+  name: "panorama-economico",
+  title: "Panorama econ\xF4mico e de feriados",
+  description: "Workflow guiado: lista as taxas econ\xF4micas atuais (SELIC, CDI, IPCA) e os feriados nacionais do ano corrente, e produz um resumo conciso \xFAtil pra planejamento de curto prazo (pr\xF3ximos feriados, juros vigentes)."
+  // argsSchema omitido = prompt sem argumentos.
+};
+function panoramaEconomicoHandler() {
+  const anoCorrente = (/* @__PURE__ */ new Date()).getFullYear();
+  return {
+    messages: [
+      {
+        role: "user",
+        content: {
+          type: "text",
+          text: [
+            "Monte um panorama econ\xF4mico e de calend\xE1rio do Brasil no momento.",
+            "",
+            "Passos:",
+            "1. Chame a tool listar_taxas pra obter SELIC, CDI e IPCA atuais.",
+            `2. Chame a tool consultar_feriados com ano=${anoCorrente}.`,
+            "3. Produza um resumo curto cobrindo:",
+            "   - **Taxas vigentes**: SELIC, CDI, IPCA (% ao ano), com uma frase de contexto cada (ex: 'SELIC \xE9 a taxa b\xE1sica de juros').",
+            "   - **Pr\xF3ximos feriados**: a partir de hoje, liste os 3-5 pr\xF3ximos feriados nacionais com data e dia da semana.",
+            "   - **Pontes em vista**: aponte feriados que caem em ter\xE7a/quinta (potencial emenda).",
+            "",
+            "Seja conciso. N\xE3o d\xEA recomenda\xE7\xE3o de investimento."
+          ].join("\n")
+        }
+      }
+    ]
+  };
+}
+
+// src/tools/banco.ts
+import { z as z2 } from "zod";
+
+// src/version.ts
+import { readFileSync } from "fs";
+function lerVersao() {
+  try {
+    const raw = readFileSync(
+      new URL("../package.json", import.meta.url),
+      "utf-8"
+    );
+    return JSON.parse(raw).version ?? "0.0.0";
+  } catch {
+    return "0.0.0";
+  }
+}
+var VERSION = lerVersao();
 
 // src/clients/brasilapi.ts
 var BASE_URL = "https://brasilapi.com.br/api";
 var DEFAULT_TIMEOUT_MS = 1e4;
 var DEFAULT_TTL_MS = 24 * 60 * 60 * 1e3;
 var MAX_RETRIES = 3;
-var USER_AGENT = "brasil-data-mcp/0.1.0 (+https://github.com/alanpcf/brasil-data-mcp)";
+var USER_AGENT = `brasil-data-mcp/${VERSION} (+https://github.com/alanpcf/brasil-data-mcp)`;
 var BrasilApiError = class extends Error {
   constructor(message, status, path, body) {
     super(message);
@@ -136,8 +229,8 @@ function traduzirErroBrasilApi(err, mapa) {
 }
 
 // src/tools/banco.ts
-var consultarBancoSchema = z.object({
-  codigo: z.union([z.string(), z.number()]).describe(
+var consultarBancoSchema = z2.object({
+  codigo: z2.union([z2.string(), z2.number()]).describe(
     "C\xF3digo COMPE/Febraban do banco (1 a 4 d\xEDgitos). Aceita string ou n\xFAmero. Ex: 341 (Ita\xFA), 260 (Nubank), 237 (Bradesco)."
   )
 });
@@ -192,7 +285,7 @@ async function consultarBancoHandler(input) {
     };
   }
 }
-var listarBancosSchema = z.object({});
+var listarBancosSchema = z2.object({});
 var listarBancosTool = {
   name: "listar_bancos",
   description: [
@@ -230,10 +323,174 @@ async function listarBancosHandler(_input) {
   }
 }
 
+// src/tools/cambio.ts
+import { z as z3 } from "zod";
+var MOEDAS_VALIDAS = /* @__PURE__ */ new Set([
+  "AUD",
+  "CAD",
+  "CHF",
+  "DKK",
+  "EUR",
+  "GBP",
+  "JPY",
+  "NOK",
+  "SEK",
+  "USD"
+]);
+function hojeSaoPaulo() {
+  return new Intl.DateTimeFormat("en-CA", {
+    timeZone: "America/Sao_Paulo"
+  }).format(/* @__PURE__ */ new Date());
+}
+function diaAnterior(iso) {
+  const d = /* @__PURE__ */ new Date(`${iso}T12:00:00Z`);
+  d.setUTCDate(d.getUTCDate() - 1);
+  return d.toISOString().slice(0, 10);
+}
+function normalizarData(entrada) {
+  const s = entrada.trim();
+  let iso;
+  const brasileira = /^(\d{2})\/(\d{2})\/(\d{4})$/.exec(s);
+  if (brasileira) {
+    iso = `${brasileira[3]}-${brasileira[2]}-${brasileira[1]}`;
+  } else if (/^\d{4}-\d{2}-\d{2}$/.test(s)) {
+    iso = s;
+  } else {
+    return null;
+  }
+  const d = /* @__PURE__ */ new Date(`${iso}T12:00:00Z`);
+  if (Number.isNaN(d.getTime()) || d.toISOString().slice(0, 10) !== iso) {
+    return null;
+  }
+  return iso;
+}
+var consultarCambioSchema = z3.object({
+  moeda: z3.string().describe(
+    "C\xF3digo da moeda (ISO 4217), case-insensitive. Aceitas: USD, EUR, GBP, JPY, CHF, CAD, AUD, DKK, NOK, SEK. Ex: 'USD'."
+  ),
+  data: z3.string().optional().describe(
+    "Data da cota\xE7\xE3o no formato YYYY-MM-DD (aceita tamb\xE9m DD/MM/YYYY). Se omitida, usa ontem (fuso de Bras\xEDlia) \u2014 a fonte n\xE3o exp\xF5e o dia corrente. Em data sem preg\xE3o (fim de semana, feriado) a API retorna as cota\xE7\xF5es do \xFAltimo dia \xFAtil anterior."
+  )
+});
+var consultarCambioTool = {
+  name: "consultar_cambio",
+  description: [
+    "Consulta a cota\xE7\xE3o de c\xE2mbio oficial de uma moeda estrangeira em rela\xE7\xE3o ao Real (BRL) numa data, via boletins PTAX do Banco Central (BrasilAPI).",
+    "",
+    "Retorna em JSON os boletins do dia (ABERTURA, INTERMEDI\xC1RIO, FECHAMENTO) com cota\xE7\xE3o de compra e venda em BRL, paridade e data_hora_cotacao. A fonte N\xC3O exp\xF5e o dia corrente: com data omitida a tool consulta ontem (a cota\xE7\xE3o mais recente dispon\xEDvel), e em data sem preg\xE3o a API retorna os boletins do \xFAltimo dia \xFAtil anterior.",
+    "",
+    "Use quando o usu\xE1rio perguntar 'quanto t\xE1 o d\xF3lar?' (retorna a cota\xE7\xE3o mais recente, do dia \xFAtil anterior), 'cota\xE7\xE3o do euro em 26/06', 'quanto fechou a libra sexta-feira' \u2014 qualquer pergunta sobre valor de moeda estrangeira em reais.",
+    "",
+    "N\xC3O use para: criptomoedas (n\xE3o est\xE1 nesta API), BRL (\xE9 a moeda base), s\xE9rie hist\xF3rica (uma data por chamada), ou moedas fora das 10 suportadas \u2014 pra descobrir as moedas dispon\xEDveis use listar_moedas."
+  ].join(" "),
+  inputSchema: consultarCambioSchema
+};
+async function consultarCambioHandler(input) {
+  const moeda = input.moeda.trim().toUpperCase();
+  if (!MOEDAS_VALIDAS.has(moeda)) {
+    return {
+      content: [
+        {
+          type: "text",
+          text: `Moeda n\xE3o suportada: '${input.moeda}'. Use uma de: ${[...MOEDAS_VALIDAS].join(", ")}.`
+        }
+      ],
+      isError: true
+    };
+  }
+  const hoje = hojeSaoPaulo();
+  const ontem = diaAnterior(hoje);
+  let data;
+  if (input.data === void 0) {
+    data = ontem;
+  } else {
+    const normalizada = normalizarData(input.data);
+    if (normalizada === null) {
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Data inv\xE1lida: '${input.data}'. Use o formato YYYY-MM-DD (ex: ${ontem}) ou DD/MM/YYYY.`
+          }
+        ],
+        isError: true
+      };
+    }
+    data = normalizada;
+  }
+  if (data >= hoje) {
+    return {
+      content: [
+        {
+          type: "text",
+          text: `A fonte n\xE3o fornece cota\xE7\xE3o do dia corrente nem de datas futuras ('${data}'). A cota\xE7\xE3o mais recente dispon\xEDvel \xE9 a de ${ontem} \u2014 omita 'data' pra us\xE1-la.`
+        }
+      ],
+      isError: true
+    };
+  }
+  try {
+    const dados = await brasilApi.get(
+      `/cambio/v1/cotacao/${moeda}/${data}`
+    );
+    return {
+      content: [{ type: "text", text: JSON.stringify(dados, null, 2) }]
+    };
+  } catch (err) {
+    return {
+      content: [
+        {
+          type: "text",
+          text: traduzirErroBrasilApi(err, {
+            notFound: `Cota\xE7\xE3o de ${moeda} n\xE3o encontrada para ${data}.`,
+            contextoErro: "Erro ao consultar c\xE2mbio"
+          })
+        }
+      ],
+      isError: true
+    };
+  }
+}
+var listarMoedasSchema = z3.object({});
+var listarMoedasTool = {
+  name: "listar_moedas",
+  description: [
+    "Lista as moedas estrangeiras com cota\xE7\xE3o dispon\xEDvel na BrasilAPI (boletins PTAX/BACEN).",
+    "",
+    "Retorna em JSON um array com s\xEDmbolo (ISO 4217), nome e tipo de cada moeda \u2014 10 moedas: USD, EUR, GBP, JPY, CHF, CAD, AUD, DKK, NOK, SEK.",
+    "",
+    "Use quando o usu\xE1rio quiser saber quais moedas t\xEAm cota\xE7\xE3o dispon\xEDvel ou n\xE3o souber o c\xF3digo da moeda.",
+    "",
+    "N\xC3O use para obter a cota\xE7\xE3o em si \u2014 use consultar_cambio."
+  ].join(" "),
+  inputSchema: listarMoedasSchema
+};
+async function listarMoedasHandler(_input) {
+  try {
+    const dados = await brasilApi.get("/cambio/v1/moedas");
+    return {
+      content: [{ type: "text", text: JSON.stringify(dados, null, 2) }]
+    };
+  } catch (err) {
+    return {
+      content: [
+        {
+          type: "text",
+          text: traduzirErroBrasilApi(err, {
+            notFound: "Lista de moedas n\xE3o dispon\xEDvel no momento.",
+            contextoErro: "Erro ao listar moedas"
+          })
+        }
+      ],
+      isError: true
+    };
+  }
+}
+
 // src/tools/cep.ts
-import { z as z2 } from "zod";
-var consultarCepSchema = z2.object({
-  cep: z2.string().describe(
+import { z as z4 } from "zod";
+var consultarCepSchema = z4.object({
+  cep: z4.string().describe(
     "CEP brasileiro com ou sem h\xEDfen. Aceita '01310-100' ou '01310100'. Deve ter 8 d\xEDgitos."
   )
 });
@@ -293,9 +550,21 @@ async function consultarCepHandler(input) {
 }
 
 // src/tools/cnpj.ts
-import { z as z3 } from "zod";
-var consultarCnpjSchema = z3.object({
-  cnpj: z3.string().describe(
+import { z as z5 } from "zod";
+
+// src/utils/cnpj.ts
+function limparCnpj(s) {
+  return s.replace(/\D/g, "");
+}
+function validarCnpj(s) {
+  if (!/^\d{14}$/.test(s)) return false;
+  if (/^(\d)\1{13}$/.test(s)) return false;
+  return true;
+}
+
+// src/tools/cnpj.ts
+var consultarCnpjSchema = z5.object({
+  cnpj: z5.string().describe(
     "CNPJ da empresa, com ou sem m\xE1scara. Aceita '12.345.678/0001-90' ou '12345678000190'. Deve ter 14 d\xEDgitos."
   )
 });
@@ -317,14 +586,6 @@ var consultarCnpjTool = {
   ].join(" "),
   inputSchema: consultarCnpjSchema
 };
-function limparCnpj(s) {
-  return s.replace(/\D/g, "");
-}
-function validarCnpj(s) {
-  if (!/^\d{14}$/.test(s)) return false;
-  if (/^(\d)\1{13}$/.test(s)) return false;
-  return true;
-}
 async function consultarCnpjHandler(input) {
   const cnpjLimpo = limparCnpj(input.cnpj);
   if (!validarCnpj(cnpjLimpo)) {
@@ -366,10 +627,191 @@ async function consultarCnpjHandler(input) {
   }
 }
 
+// src/tools/corretoras.ts
+import { z as z6 } from "zod";
+var consultarCorretoraSchema = z6.object({
+  cnpj: z6.string().describe(
+    "CNPJ da corretora, com ou sem m\xE1scara. 14 d\xEDgitos. Ex: '02.332.886/0011-78' (XP Investimentos)."
+  )
+});
+var consultarCorretoraTool = {
+  name: "consultar_corretora",
+  description: [
+    "Consulta dados cadastrais de uma corretora de valores autorizada pela CVM (Comiss\xE3o de Valores Mobili\xE1rios) via BrasilAPI.",
+    "",
+    "Retorna em JSON: CNPJ, nome social, nome comercial, status (em funcionamento, cancelada, etc), endere\xE7o completo, e-mail, telefone, data de in\xEDcio e patrim\xF4nio quando dispon\xEDvel.",
+    "",
+    "Use quando o usu\xE1rio fornecer um CNPJ e quiser saber se \xE9 uma corretora autorizada pela CVM, ou puxar os dados cadastrais.",
+    "",
+    "N\xC3O use para: empresas em geral (use consultar_cnpj), corretoras de seguros (CVM s\xF3 regula valores mobili\xE1rios), ou buscar por nome (a API s\xF3 aceita CNPJ)."
+  ].join(" "),
+  inputSchema: consultarCorretoraSchema
+};
+async function consultarCorretoraHandler(input) {
+  const cnpjLimpo = limparCnpj(input.cnpj);
+  if (!validarCnpj(cnpjLimpo)) {
+    return {
+      content: [
+        {
+          type: "text",
+          text: `CNPJ inv\xE1lido: '${input.cnpj}'. Deve conter 14 d\xEDgitos (com ou sem m\xE1scara) e n\xE3o pode ser uma sequ\xEAncia repetida.`
+        }
+      ],
+      isError: true
+    };
+  }
+  try {
+    const dados = await brasilApi.get(
+      `/cvm/corretoras/v1/${cnpjLimpo}`
+    );
+    return {
+      content: [{ type: "text", text: JSON.stringify(dados, null, 2) }]
+    };
+  } catch (err) {
+    return {
+      content: [
+        {
+          type: "text",
+          text: traduzirErroBrasilApi(err, {
+            notFound: `Corretora com CNPJ ${cnpjLimpo} n\xE3o encontrada no cadastro da CVM. Verifique se est\xE1 correto \u2014 s\xF3 corretoras de valores mobili\xE1rios autorizadas pela CVM aparecem aqui.`,
+            contextoErro: "Erro ao consultar corretora"
+          })
+        }
+      ],
+      isError: true
+    };
+  }
+}
+
+// src/tools/ddd.ts
+import { z as z7 } from "zod";
+var consultarDddSchema = z7.object({
+  ddd: z7.union([z7.string(), z7.number()]).describe(
+    "C\xF3digo DDD brasileiro (2 d\xEDgitos). Aceita string ou n\xFAmero. Ex: 11 (S\xE3o Paulo capital), 21 (Rio), 41 (Curitiba), 71 (Salvador)."
+  )
+});
+var consultarDddTool = {
+  name: "consultar_ddd",
+  description: [
+    "Lista as cidades atendidas por um c\xF3digo DDD brasileiro via BrasilAPI.",
+    "",
+    "Retorna em JSON: estado (UF) e lista de cidades que usam aquele DDD.",
+    "",
+    "Use quando o usu\xE1rio perguntar de onde \xE9 um DDD, quais cidades um DDD cobre, ou descobrir o estado de um n\xFAmero de telefone.",
+    "",
+    "N\xC3O use para: validar n\xFAmero de telefone completo, descobrir DDD a partir de cidade (a opera\xE7\xE3o s\xF3 \xE9 DDD \u2192 cidades), ou consultar DDDs internacionais."
+  ].join(" "),
+  inputSchema: consultarDddSchema
+};
+function normalizarDdd(ddd) {
+  const s = String(ddd).trim().replace(/\D/g, "");
+  if (!/^[1-9]\d$/.test(s)) return "";
+  return s;
+}
+async function consultarDddHandler(input) {
+  const ddd = normalizarDdd(input.ddd);
+  if (!ddd) {
+    return {
+      content: [
+        {
+          type: "text",
+          text: `DDD inv\xE1lido: '${input.ddd}'. Deve ter 2 d\xEDgitos, primeiro entre 1 e 9 (ex: 11, 21, 41).`
+        }
+      ],
+      isError: true
+    };
+  }
+  try {
+    const dados = await brasilApi.get(`/ddd/v1/${ddd}`);
+    return {
+      content: [{ type: "text", text: JSON.stringify(dados, null, 2) }]
+    };
+  } catch (err) {
+    return {
+      content: [
+        {
+          type: "text",
+          text: traduzirErroBrasilApi(err, {
+            notFound: `DDD ${ddd} n\xE3o encontrado no plano de numera\xE7\xE3o brasileiro.`,
+            contextoErro: "Erro ao consultar DDD"
+          })
+        }
+      ],
+      isError: true
+    };
+  }
+}
+
+// src/tools/dominio.ts
+import { z as z8 } from "zod";
+function normalizarDominio(entrada) {
+  const semProtocolo = entrada.trim().toLowerCase().replace(/^https?:\/\//, "");
+  const semPath = semProtocolo.split("/")[0] ?? "";
+  return semPath.replace(/^www\./, "");
+}
+function validarDominioBr(dominio) {
+  return /^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*\.br$/.test(
+    dominio
+  );
+}
+var consultarDominioBrSchema = z8.object({
+  dominio: z8.string().describe(
+    "Dom\xEDnio .br a verificar. Aceita URL completa ou dom\xEDnio puro \u2014 ser\xE1 normalizado (remove http(s)://, www. e caminho). Ex: 'exemplo.com.br' ou 'https://www.exemplo.com.br/pagina'."
+  )
+});
+var consultarDominioBrTool = {
+  name: "consultar_dominio_br",
+  description: [
+    "Consulta o status de registro de um dom\xEDnio .br direto na base do registro.br (via BrasilAPI).",
+    "",
+    "Retorna em JSON: status (AVAILABLE = dispon\xEDvel pra registro, REGISTERED = j\xE1 registrado), fqdn, hosts (servidores DNS) e expires-at quando registrado, e suggestions de extens\xF5es quando dispon\xEDvel. O resultado nunca \xE9 cacheado \u2014 \xE9 sempre o status atual.",
+    "",
+    "Use quando o usu\xE1rio perguntar 'o dom\xEDnio X.com.br t\xE1 livre?', 'quando expira Y.org.br?', 'quem responde pelo DNS de Z.br?'.",
+    "",
+    "N\xC3O use para: dom\xEDnios internacionais .com/.net/gTLDs (a base \xE9 s\xF3 .br), dados de titular/whois completo (a API n\xE3o exp\xF5e), ou hospedagem/conte\xFAdo do site."
+  ].join(" "),
+  inputSchema: consultarDominioBrSchema
+};
+async function consultarDominioBrHandler(input) {
+  const dominio = normalizarDominio(input.dominio);
+  if (!validarDominioBr(dominio)) {
+    return {
+      content: [
+        {
+          type: "text",
+          text: `Dom\xEDnio inv\xE1lido: '${input.dominio}'. Esta tool s\xF3 consulta dom\xEDnios .br (registro.br). Ex: 'exemplo.com.br'.`
+        }
+      ],
+      isError: true
+    };
+  }
+  try {
+    const dados = await brasilApi.get(`/registrobr/v1/${dominio}`, {
+      ttlMs: 0
+    });
+    return {
+      content: [{ type: "text", text: JSON.stringify(dados, null, 2) }]
+    };
+  } catch (err) {
+    return {
+      content: [
+        {
+          type: "text",
+          text: traduzirErroBrasilApi(err, {
+            notFound: `Dom\xEDnio ${dominio} n\xE3o encontrado na base do registro.br.`,
+            contextoErro: "Erro ao consultar dom\xEDnio"
+          })
+        }
+      ],
+      isError: true
+    };
+  }
+}
+
 // src/tools/feriados.ts
-import { z as z4 } from "zod";
-var consultarFeriadosSchema = z4.object({
-  ano: z4.number().int().describe(
+import { z as z9 } from "zod";
+var consultarFeriadosSchema = z9.object({
+  ano: z9.number().int().describe(
     "Ano dos feriados, 4 d\xEDgitos. Faixa aceita: 1900 a 2199. Ex: 2026."
   )
 });
@@ -422,8 +864,285 @@ async function consultarFeriadosHandler(input) {
   }
 }
 
+// src/tools/ibge.ts
+import { z as z10 } from "zod";
+var UFS_VALIDAS = /* @__PURE__ */ new Set([
+  "AC",
+  "AL",
+  "AP",
+  "AM",
+  "BA",
+  "CE",
+  "DF",
+  "ES",
+  "GO",
+  "MA",
+  "MT",
+  "MS",
+  "MG",
+  "PA",
+  "PB",
+  "PR",
+  "PE",
+  "PI",
+  "RJ",
+  "RN",
+  "RS",
+  "RO",
+  "RR",
+  "SC",
+  "SP",
+  "SE",
+  "TO"
+]);
+var listarEstadosSchema = z10.object({});
+var listarEstadosTool = {
+  name: "listar_estados",
+  description: [
+    "Lista as 27 unidades federativas do Brasil (26 estados + DF) com dados do IBGE, via BrasilAPI.",
+    "",
+    "Retorna em JSON um array com id (c\xF3digo IBGE), sigla, nome, regi\xE3o (Norte/Nordeste/Centro-Oeste/Sudeste/Sul) e capital de cada UF.",
+    "",
+    "Use quando o usu\xE1rio precisar do c\xF3digo IBGE de um estado, agrupar estados por regi\xE3o, validar siglas de UF ou saber a capital.",
+    "",
+    "N\xC3O use para: munic\xEDpios (use consultar_municipios), dados demogr\xE1ficos ou populacionais (n\xE3o est\xE3o nesta API)."
+  ].join(" "),
+  inputSchema: listarEstadosSchema
+};
+async function listarEstadosHandler(_input) {
+  try {
+    const dados = await brasilApi.get("/ibge/uf/v1");
+    return {
+      content: [{ type: "text", text: JSON.stringify(dados, null, 2) }]
+    };
+  } catch (err) {
+    return {
+      content: [
+        {
+          type: "text",
+          text: traduzirErroBrasilApi(err, {
+            notFound: "Lista de estados n\xE3o dispon\xEDvel no momento.",
+            contextoErro: "Erro ao listar estados"
+          })
+        }
+      ],
+      isError: true
+    };
+  }
+}
+var consultarMunicipiosSchema = z10.object({
+  uf: z10.string().describe(
+    "Sigla da unidade federativa, 2 letras, case-insensitive. Ex: 'SP', 'rj', 'DF'."
+  )
+});
+var consultarMunicipiosTool = {
+  name: "consultar_municipios",
+  description: [
+    "Lista todos os munic\xEDpios de uma UF brasileira com nome e c\xF3digo IBGE de 7 d\xEDgitos, via BrasilAPI.",
+    "",
+    "Retorna em JSON um array de {nome, codigo_ibge}. Aten\xE7\xE3o: estados grandes retornam listas longas (SP tem 645 munic\xEDpios, ~30KB) \u2014 prefira usar s\xF3 quando precisar da lista ou do c\xF3digo de um munic\xEDpio.",
+    "",
+    "Use quando o usu\xE1rio precisar do c\xF3digo IBGE de um munic\xEDpio ou listar as cidades de um estado.",
+    "",
+    "N\xC3O use para: buscar um munic\xEDpio por nome no pa\xEDs inteiro (a API s\xF3 filtra por UF \u2014 se souber o estado, consulte-o), endere\xE7os/CEP (use consultar_cep), ou dados populacionais."
+  ].join(" "),
+  inputSchema: consultarMunicipiosSchema
+};
+async function consultarMunicipiosHandler(input) {
+  const uf = input.uf.trim().toUpperCase();
+  if (!UFS_VALIDAS.has(uf)) {
+    return {
+      content: [
+        {
+          type: "text",
+          text: `UF inv\xE1lida: '${input.uf}'. Use uma sigla de estado brasileiro, ex: SP, RJ, MG.`
+        }
+      ],
+      isError: true
+    };
+  }
+  try {
+    const dados = await brasilApi.get(`/ibge/municipios/v1/${uf}`);
+    return {
+      content: [{ type: "text", text: JSON.stringify(dados, null, 2) }]
+    };
+  } catch (err) {
+    return {
+      content: [
+        {
+          type: "text",
+          text: traduzirErroBrasilApi(err, {
+            notFound: `Munic\xEDpios da UF ${uf} n\xE3o encontrados.`,
+            contextoErro: "Erro ao consultar munic\xEDpios"
+          })
+        }
+      ],
+      isError: true
+    };
+  }
+}
+
+// src/tools/isbn.ts
+import { z as z11 } from "zod";
+var consultarIsbnSchema = z11.object({
+  codigo: z11.string().describe(
+    "ISBN do livro, 10 ou 13 d\xEDgitos. Aceita com ou sem h\xEDfens. Ex: '978-85-325-3080-2' ou '9788532530802'."
+  )
+});
+var consultarIsbnTool = {
+  name: "consultar_isbn",
+  description: [
+    "Consulta metadados de um livro pelo ISBN via BrasilAPI (agrega CBL, Mercado Editorial, Open Library e Google Books).",
+    "",
+    "Retorna em JSON: t\xEDtulo, subt\xEDtulo, autores, editora, ano, idioma, n\xFAmero de p\xE1ginas, assunto/categoria, sinopse (quando dispon\xEDvel) e fonte do dado.",
+    "",
+    "Use quando o usu\xE1rio fornecer um ISBN e quiser saber sobre o livro (t\xEDtulo, autor, editora, ano).",
+    "",
+    "N\xC3O use para: buscar livro por t\xEDtulo ou autor (a opera\xE7\xE3o \xE9 s\xF3 ISBN \u2192 metadados), validar formato sem consultar (rejeite local se n\xE3o bater 10/13 d\xEDgitos), ou consultar pre\xE7o/disponibilidade. Aceita ISBN-10 e ISBN-13, com ou sem h\xEDfens."
+  ].join(" "),
+  inputSchema: consultarIsbnSchema
+};
+function limparIsbn(s) {
+  return s.replace(/[\s-]/g, "").toUpperCase();
+}
+function validarIsbn(s) {
+  if (/^\d{9}[\dX]$/.test(s)) return true;
+  if (/^\d{13}$/.test(s)) return true;
+  return false;
+}
+async function consultarIsbnHandler(input) {
+  const isbnLimpo = limparIsbn(input.codigo);
+  if (!validarIsbn(isbnLimpo)) {
+    return {
+      content: [
+        {
+          type: "text",
+          text: `ISBN inv\xE1lido: '${input.codigo}'. Deve ter 10 d\xEDgitos (\xFAltimo pode ser 'X') ou 13 d\xEDgitos. Aceita com ou sem h\xEDfens.`
+        }
+      ],
+      isError: true
+    };
+  }
+  try {
+    const dados = await brasilApi.get(`/isbn/v1/${isbnLimpo}`);
+    return {
+      content: [{ type: "text", text: JSON.stringify(dados, null, 2) }]
+    };
+  } catch (err) {
+    return {
+      content: [
+        {
+          type: "text",
+          text: traduzirErroBrasilApi(err, {
+            notFound: `ISBN ${isbnLimpo} n\xE3o encontrado nos provedores agregados (CBL, Mercado Editorial, Open Library, Google Books).`,
+            contextoErro: "Erro ao consultar ISBN"
+          })
+        }
+      ],
+      isError: true
+    };
+  }
+}
+
+// src/tools/taxas.ts
+import { z as z12 } from "zod";
+var TTL_TAXAS_MS = 60 * 60 * 1e3;
+var consultarTaxaSchema = z12.object({
+  sigla: z12.string().describe(
+    "Sigla da taxa, case-insensitive. Aceita: 'Selic' (taxa b\xE1sica de juros), 'CDI' (Certificado de Dep\xF3sito Interbanc\xE1rio), 'IPCA' (infla\xE7\xE3o oficial)."
+  )
+});
+var consultarTaxaTool = {
+  name: "consultar_taxa",
+  description: [
+    "Consulta o valor atual de uma taxa econ\xF4mica brasileira (SELIC, CDI, IPCA) via BrasilAPI.",
+    "",
+    "Retorna em JSON: nome da taxa e valor atual (% ao ano).",
+    "",
+    "Use quando o usu\xE1rio perguntar 'qual a SELIC hoje?', 'CDI atual?', 'infla\xE7\xE3o do IPCA?' \u2014 qualquer pergunta sobre o valor corrente de uma taxa espec\xEDfica.",
+    "",
+    "N\xC3O use para: s\xE9rie hist\xF3rica (a API devolve s\xF3 o \xFAltimo valor), outras taxas al\xE9m de SELIC/CDI/IPCA, ou consultar d\xF3lar/bolsa (n\xE3o est\xE1 nesta API). Pra panorama com todas as 3 taxas use listar_taxas."
+  ].join(" "),
+  inputSchema: consultarTaxaSchema
+};
+var SIGLAS_VALIDAS = /* @__PURE__ */ new Set(["SELIC", "CDI", "IPCA"]);
+function normalizarSigla(sigla) {
+  return sigla.trim().toUpperCase();
+}
+async function consultarTaxaHandler(input) {
+  const sigla = normalizarSigla(input.sigla);
+  if (!SIGLAS_VALIDAS.has(sigla)) {
+    return {
+      content: [
+        {
+          type: "text",
+          text: `Sigla inv\xE1lida: '${input.sigla}'. Use uma de: SELIC, CDI, IPCA.`
+        }
+      ],
+      isError: true
+    };
+  }
+  try {
+    const dados = await brasilApi.get(`/taxas/v1/${sigla}`, {
+      ttlMs: TTL_TAXAS_MS
+    });
+    return {
+      content: [{ type: "text", text: JSON.stringify(dados, null, 2) }]
+    };
+  } catch (err) {
+    return {
+      content: [
+        {
+          type: "text",
+          text: traduzirErroBrasilApi(err, {
+            notFound: `Taxa ${sigla} n\xE3o encontrada na BrasilAPI.`,
+            contextoErro: "Erro ao consultar taxa"
+          })
+        }
+      ],
+      isError: true
+    };
+  }
+}
+var listarTaxasSchema = z12.object({});
+var listarTaxasTool = {
+  name: "listar_taxas",
+  description: [
+    "Lista TODAS as taxas econ\xF4micas brasileiras dispon\xEDveis na BrasilAPI (SELIC, CDI, IPCA) com seus valores atuais.",
+    "",
+    "Retorna em JSON um array com nome e valor (% ao ano) de cada taxa.",
+    "",
+    "Use quando o usu\xE1rio quiser um panorama econ\xF4mico, comparar SELIC vs CDI vs IPCA, ou n\xE3o souber a sigla espec\xEDfica.",
+    "",
+    "N\xC3O use quando o usu\xE1rio j\xE1 sabe qual taxa quer \u2014 use consultar_taxa que \xE9 semanticamente mais direto. Hoje s\xE3o s\xF3 3 taxas; o payload \xE9 pequeno."
+  ].join(" "),
+  inputSchema: listarTaxasSchema
+};
+async function listarTaxasHandler(_input) {
+  try {
+    const dados = await brasilApi.get("/taxas/v1", {
+      ttlMs: TTL_TAXAS_MS
+    });
+    return {
+      content: [{ type: "text", text: JSON.stringify(dados, null, 2) }]
+    };
+  } catch (err) {
+    return {
+      content: [
+        {
+          type: "text",
+          text: traduzirErroBrasilApi(err, {
+            notFound: "Lista de taxas n\xE3o dispon\xEDvel no momento.",
+            contextoErro: "Erro ao listar taxas"
+          })
+        }
+      ],
+      isError: true
+    };
+  }
+}
+
 // src/index.ts
-var VERSION = "0.1.0";
 function wrapHandler(toolName, handler) {
   return async (input) => {
     try {
@@ -442,50 +1161,55 @@ function wrapHandler(toolName, handler) {
     }
   };
 }
+var TOOLS = [
+  { tool: consultarCnpjTool, handler: consultarCnpjHandler },
+  { tool: consultarCepTool, handler: consultarCepHandler },
+  { tool: consultarBancoTool, handler: consultarBancoHandler },
+  { tool: listarBancosTool, handler: listarBancosHandler },
+  { tool: consultarFeriadosTool, handler: consultarFeriadosHandler },
+  { tool: consultarDddTool, handler: consultarDddHandler },
+  { tool: consultarIsbnTool, handler: consultarIsbnHandler },
+  { tool: consultarTaxaTool, handler: consultarTaxaHandler },
+  { tool: listarTaxasTool, handler: listarTaxasHandler },
+  { tool: consultarCorretoraTool, handler: consultarCorretoraHandler },
+  // Fase 5 (v0.3.0):
+  { tool: consultarCambioTool, handler: consultarCambioHandler },
+  { tool: listarMoedasTool, handler: listarMoedasHandler },
+  { tool: listarEstadosTool, handler: listarEstadosHandler },
+  { tool: consultarMunicipiosTool, handler: consultarMunicipiosHandler },
+  { tool: consultarDominioBrTool, handler: consultarDominioBrHandler }
+];
 function createServer() {
   const server = new McpServer({
     name: "brasil-data-mcp",
     version: VERSION
   });
-  server.registerTool(
-    consultarCnpjTool.name,
-    {
-      description: consultarCnpjTool.description,
-      inputSchema: consultarCnpjSchema.shape
-    },
-    wrapHandler(consultarCnpjTool.name, consultarCnpjHandler)
-  );
-  server.registerTool(
-    consultarCepTool.name,
-    {
-      description: consultarCepTool.description,
-      inputSchema: consultarCepSchema.shape
-    },
-    wrapHandler(consultarCepTool.name, consultarCepHandler)
-  );
-  server.registerTool(
-    consultarBancoTool.name,
-    {
-      description: consultarBancoTool.description,
-      inputSchema: consultarBancoSchema.shape
-    },
-    wrapHandler(consultarBancoTool.name, consultarBancoHandler)
-  );
-  server.registerTool(
-    listarBancosTool.name,
+  for (const { tool, handler } of TOOLS) {
+    server.registerTool(
+      tool.name,
+      {
+        description: tool.description,
+        inputSchema: tool.inputSchema.shape
+      },
+      wrapHandler(tool.name, handler)
+    );
+  }
+  server.registerPrompt(
+    analiseCnpjPrompt.name,
     {
-      description: listarBancosTool.description,
-      inputSchema: listarBancosSchema.shape
+      title: analiseCnpjPrompt.title,
+      description: analiseCnpjPrompt.description,
+      argsSchema: analiseCnpjArgsSchema
     },
-    wrapHandler(listarBancosTool.name, listarBancosHandler)
+    analiseCnpjHandler
   );
-  server.registerTool(
-    consultarFeriadosTool.name,
+  server.registerPrompt(
+    panoramaEconomicoPrompt.name,
     {
-      description: consultarFeriadosTool.description,
-      inputSchema: consultarFeriadosSchema.shape
+      title: panoramaEconomicoPrompt.title,
+      description: panoramaEconomicoPrompt.description
     },
-    wrapHandler(consultarFeriadosTool.name, consultarFeriadosHandler)
+    panoramaEconomicoHandler
   );
   return server;
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "brasil-data-mcp",
-  "version": "0.1.0",
-  "description": "MCP server providing access to Brazilian public data (CNPJ, CEP, banks, holidays) via BrasilAPI. For use with Claude Desktop, Claude Code, Cursor, and other MCP-compatible clients.",
+  "version": "0.3.0",
+  "description": "MCP server providing access to Brazilian public data (CNPJ, CEP, banks, holidays, DDD, ISBN, economic rates, exchange rates, CVM brokers, IBGE states/municipalities, .br domains) via BrasilAPI. Ships with MCP prompts for guided workflows. For use with Claude Desktop, Claude Code, Cursor, and other MCP-compatible clients.",
   "keywords": [
     "mcp",
     "model-context-protocol",
@@ -10,6 +10,15 @@
     "brazil",
     "cnpj",
     "cep",
+    "ddd",
+    "isbn",
+    "selic",
+    "cdi",
+    "ipca",
+    "cambio",
+    "ibge",
+    "registro-br",
+    "cvm",
     "brasilapi",
     "ai-tools"
   ],