brasil-data-mcp 0.1.0 → 0.2.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, corretoras CVM) 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, CVM brokers) 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,44 @@ 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?"_
 
 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
+### Tools disponíveis (10)
 
-| 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     |
+| 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)    |
+
+### 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.
+10 tools covering CNPJ, CEP, banks, holidays, area codes (DDD), ISBN, economic rates (SELIC/CDI/IPCA) and CVM brokers — plus 2 MCP prompts (`analise-cnpj`, `panorama-economico`) for guided workflows.
 
 ---
 
@@ -122,8 +143,9 @@ 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`)
+- [ ] **Próximo** — FIPE (aguardando upstream estabilizar, [BrasilAPI#805](https://github.com/BrasilAPI/BrasilAPI/issues/805)); Trusted Publishing (npm OIDC); mais prompts conforme demanda
 
 ---
 

package/dist/index.d.ts

@@ -9,7 +9,8 @@ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
  *   2. Registra cada tool via registerTool — 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.

package/dist/index.js

@@ -4,15 +4,93 @@
 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/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/0.2.0 (+https://github.com/alanpcf/brasil-data-mcp)";
 var BrasilApiError = class extends Error {
   constructor(message, status, path, body) {
     super(message);
@@ -136,8 +214,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 +270,7 @@ async function consultarBancoHandler(input) {
     };
   }
 }
-var listarBancosSchema = z.object({});
+var listarBancosSchema = z2.object({});
 var listarBancosTool = {
   name: "listar_bancos",
   description: [
@@ -231,9 +309,9 @@ async function listarBancosHandler(_input) {
 }
 
 // src/tools/cep.ts
-import { z as z2 } from "zod";
-var consultarCepSchema = z2.object({
-  cep: z2.string().describe(
+import { z as z3 } from "zod";
+var consultarCepSchema = z3.object({
+  cep: z3.string().describe(
     "CEP brasileiro com ou sem h\xEDfen. Aceita '01310-100' ou '01310100'. Deve ter 8 d\xEDgitos."
   )
 });
@@ -293,9 +371,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 z4 } 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 = z4.object({
+  cnpj: z4.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 +407,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 +448,125 @@ async function consultarCnpjHandler(input) {
   }
 }
 
+// src/tools/corretoras.ts
+import { z as z5 } from "zod";
+var consultarCorretoraSchema = z5.object({
+  cnpj: z5.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 z6 } from "zod";
+var consultarDddSchema = z6.object({
+  ddd: z6.union([z6.string(), z6.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/feriados.ts
-import { z as z4 } from "zod";
-var consultarFeriadosSchema = z4.object({
-  ano: z4.number().int().describe(
+import { z as z7 } from "zod";
+var consultarFeriadosSchema = z7.object({
+  ano: z7.number().int().describe(
     "Ano dos feriados, 4 d\xEDgitos. Faixa aceita: 1900 a 2199. Ex: 2026."
   )
 });
@@ -422,8 +619,168 @@ async function consultarFeriadosHandler(input) {
   }
 }
 
+// src/tools/isbn.ts
+import { z as z8 } from "zod";
+var consultarIsbnSchema = z8.object({
+  codigo: z8.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 z9 } from "zod";
+var TTL_TAXAS_MS = 60 * 60 * 1e3;
+var consultarTaxaSchema = z9.object({
+  sigla: z9.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 = z9.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";
+var VERSION = "0.2.0";
 function wrapHandler(toolName, handler) {
   return async (input) => {
     try {
@@ -487,6 +844,63 @@ function createServer() {
     },
     wrapHandler(consultarFeriadosTool.name, consultarFeriadosHandler)
   );
+  server.registerTool(
+    consultarDddTool.name,
+    {
+      description: consultarDddTool.description,
+      inputSchema: consultarDddSchema.shape
+    },
+    wrapHandler(consultarDddTool.name, consultarDddHandler)
+  );
+  server.registerTool(
+    consultarIsbnTool.name,
+    {
+      description: consultarIsbnTool.description,
+      inputSchema: consultarIsbnSchema.shape
+    },
+    wrapHandler(consultarIsbnTool.name, consultarIsbnHandler)
+  );
+  server.registerTool(
+    consultarTaxaTool.name,
+    {
+      description: consultarTaxaTool.description,
+      inputSchema: consultarTaxaSchema.shape
+    },
+    wrapHandler(consultarTaxaTool.name, consultarTaxaHandler)
+  );
+  server.registerTool(
+    listarTaxasTool.name,
+    {
+      description: listarTaxasTool.description,
+      inputSchema: listarTaxasSchema.shape
+    },
+    wrapHandler(listarTaxasTool.name, listarTaxasHandler)
+  );
+  server.registerTool(
+    consultarCorretoraTool.name,
+    {
+      description: consultarCorretoraTool.description,
+      inputSchema: consultarCorretoraSchema.shape
+    },
+    wrapHandler(consultarCorretoraTool.name, consultarCorretoraHandler)
+  );
+  server.registerPrompt(
+    analiseCnpjPrompt.name,
+    {
+      title: analiseCnpjPrompt.title,
+      description: analiseCnpjPrompt.description,
+      argsSchema: analiseCnpjArgsSchema
+    },
+    analiseCnpjHandler
+  );
+  server.registerPrompt(
+    panoramaEconomicoPrompt.name,
+    {
+      title: panoramaEconomicoPrompt.title,
+      description: panoramaEconomicoPrompt.description
+    },
+    panoramaEconomicoHandler
+  );
   return server;
 }
 async function main() {

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.2.0",
+  "description": "MCP server providing access to Brazilian public data (CNPJ, CEP, banks, holidays, DDD, ISBN, economic rates, CVM brokers) 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,12 @@
     "brazil",
     "cnpj",
     "cep",
+    "ddd",
+    "isbn",
+    "selic",
+    "cdi",
+    "ipca",
+    "cvm",
     "brasilapi",
     "ai-tools"
   ],