@brazil-mcp/cnpj 1.0.0

package/README.md

@@ -0,0 +1,75 @@
+# 🇧🇷 CNPJ MCP Server
+
+MCP server para consulta de CNPJ, sócios e atividades de empresas brasileiras.
+
+Parte do [Brazil MCP Bundle](https://github.com/acaua/brazil-mcp) — ferramentas brasileiras para Claude Code, Cursor e qualquer cliente MCP.
+
+---
+
+## Instalação
+
+```bash
+# Claude Code
+claude mcp add cnpj -- npx @brazil-mcp/cnpj
+
+# claude_desktop_config.json / Cursor / VS Code
+{
+  "mcpServers": {
+    "cnpj": {
+      "command": "npx",
+      "args": ["@brazil-mcp/cnpj"]
+    }
+  }
+}
+```
+
+## Tools Disponíveis
+
+| Tool | Descrição |
+|------|-----------|
+| `cnpj_lookup` | Dados completos da empresa (razão social, endereço, capital social, sócios, CNAEs) |
+| `cnpj_validate` | Valida dígitos verificadores (local, sem API) |
+| `cnpj_partners` | Lista de sócios (QSA) com qualificação |
+| `cnpj_activities` | Atividades econômicas (CNAE principal e secundárias) |
+| `cnpj_address` | Endereço completo registrado na Receita Federal |
+
+## Exemplos de Uso
+
+No Claude Code ou Cursor, simplesmente peça:
+
+- *"Quem são os sócios do CNPJ 33.000.167/0001-01?"*
+- *"Valide o CNPJ 12345678000195"*
+- *"Qual o endereço da empresa com CNPJ 33000167000101?"*
+- *"Liste as atividades econômicas do CNPJ 33.000.167/0001-01"*
+
+## APIs Utilizadas
+
+- [BrasilAPI](https://brasilapi.com.br/) (principal — gratuita, sem auth)
+- [ReceitaWS](https://receitaws.com.br/) (fallback — gratuita, 3 req/min)
+
+Cache em memória com TTL de 24h para reduzir chamadas.
+
+## Desenvolvimento
+
+```bash
+npm install
+npm run dev          # Roda em modo dev
+npm test             # Testes unitários
+npm run test:integration  # Testes com APIs reais
+npm run build        # Compila TypeScript
+npm run inspect      # Abre MCP Inspector
+```
+
+## Licença
+
+MIT
+
+---
+
+# 🇧🇷 CNPJ MCP Server (English)
+
+MCP server for querying Brazilian company data (CNPJ), partners, and economic activities.
+
+Part of the [Brazil MCP Bundle](https://github.com/acaua/brazil-mcp) — Brazilian business tools for Claude Code, Cursor, and any MCP client.
+
+All tool responses are in Portuguese (Brazilian data from Receita Federal).

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createServer } from "./server.js";
+async function main() {
+    const { server } = createServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("[cnpj-mcp] Server iniciado via stdio");
+}
+main().catch((err) => {
+    console.error("[cnpj-mcp] Erro fatal:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,KAAK,UAAU,IAAI;IACjB,MAAM,EAAE,MAAM,EAAE,GAAG,YAAY,EAAE,CAAC;IAClC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC;AACxD,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,wBAAwB,EAAE,GAAG,CAAC,CAAC;IAC7C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/providers/brasil-api.d.ts

@@ -0,0 +1,11 @@
+import type { CnpjData, CnpjProvider } from "../types.js";
+/**
+ * Provider que consulta a BrasilAPI (gratuita, sem autenticação).
+ * Docs: https://brasilapi.com.br/docs#tag/CNPJ
+ */
+export declare class BrasilApiProvider implements CnpjProvider {
+    name: string;
+    private baseUrl;
+    fetchCnpj(cnpj: string): Promise<CnpjData>;
+    private normalize;
+}

package/dist/providers/brasil-api.js

@@ -0,0 +1,69 @@
+/**
+ * Provider que consulta a BrasilAPI (gratuita, sem autenticação).
+ * Docs: https://brasilapi.com.br/docs#tag/CNPJ
+ */
+export class BrasilApiProvider {
+    name = "BrasilAPI";
+    baseUrl = "https://brasilapi.com.br/api/cnpj/v1";
+    async fetchCnpj(cnpj) {
+        const url = `${this.baseUrl}/${cnpj}`;
+        const response = await fetch(url, {
+            headers: { Accept: "application/json" },
+            signal: AbortSignal.timeout(10_000),
+        });
+        if (!response.ok) {
+            const status = response.status;
+            if (status === 404) {
+                throw new Error(`CNPJ ${cnpj} não encontrado na base da Receita Federal.`);
+            }
+            if (status === 429) {
+                throw new Error("Rate limit atingido na BrasilAPI. Tente novamente em alguns segundos.");
+            }
+            throw new Error(`BrasilAPI retornou status ${status}`);
+        }
+        const raw = await response.json();
+        return this.normalize(raw);
+    }
+    normalize(raw) {
+        const socios = (raw.qsa || []).map((s) => ({
+            nome: s.nome_socio || s.nome || "",
+            qualificacao: s.qualificacao_socio || s.qual || "",
+            data_entrada: s.data_entrada_sociedade || "",
+            cpf_cnpj: s.cnpj_cpf_do_socio || "",
+            faixa_etaria: s.faixa_etaria || "",
+        }));
+        const atividadePrincipal = {
+            codigo: String(raw.cnae_fiscal || ""),
+            descricao: raw.cnae_fiscal_descricao || "",
+        };
+        const atividadesSecundarias = (raw.cnaes_secundarios || []).map((a) => ({
+            codigo: String(a.codigo || ""),
+            descricao: a.descricao || "",
+        }));
+        return {
+            cnpj: raw.cnpj || "",
+            razao_social: raw.razao_social || "",
+            nome_fantasia: raw.nome_fantasia || "",
+            situacao_cadastral: raw.descricao_situacao_cadastral || "",
+            data_situacao_cadastral: raw.data_situacao_cadastral || "",
+            data_abertura: raw.data_inicio_atividade || "",
+            natureza_juridica: raw.natureza_juridica || "",
+            capital_social: raw.capital_social || 0,
+            porte: raw.porte || raw.descricao_porte || "",
+            tipo: raw.descricao_tipo_de_logradouro || "",
+            logradouro: raw.logradouro || "",
+            numero: raw.numero || "",
+            complemento: raw.complemento || "",
+            bairro: raw.bairro || "",
+            municipio: raw.municipio || "",
+            uf: raw.uf || "",
+            cep: raw.cep || "",
+            telefone: raw.ddd_telefone_1 || "",
+            email: raw.email || "",
+            atividade_principal: atividadePrincipal,
+            atividades_secundarias: atividadesSecundarias,
+            socios,
+        };
+    }
+}
+//# sourceMappingURL=brasil-api.js.map

package/dist/providers/brasil-api.js.map

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

package/dist/providers/index.d.ts

@@ -0,0 +1,19 @@
+import type { CnpjData, CnpjProvider } from "../types.js";
+import { MemoryCache } from "../utils/cache.js";
+/**
+ * Orquestrador de providers CNPJ com fallback automático e cache.
+ *
+ * Fluxo:
+ * 1. Verifica cache (TTL 24h)
+ * 2. Tenta BrasilAPI (principal)
+ * 3. Se falhar, tenta ReceitaWS (fallback)
+ * 4. Se ambos falharem, retorna erro descritivo
+ */
+export declare class CnpjService {
+    private providers;
+    private cache;
+    constructor(providers?: CnpjProvider[], cache?: MemoryCache<CnpjData>);
+    lookup(cnpj: string): Promise<CnpjData>;
+    clearCache(): void;
+    get cacheSize(): number;
+}

package/dist/providers/index.js

@@ -0,0 +1,56 @@
+import { MemoryCache } from "../utils/cache.js";
+import { BrasilApiProvider } from "./brasil-api.js";
+import { ReceitaWsProvider } from "./receita-ws.js";
+/**
+ * Orquestrador de providers CNPJ com fallback automático e cache.
+ *
+ * Fluxo:
+ * 1. Verifica cache (TTL 24h)
+ * 2. Tenta BrasilAPI (principal)
+ * 3. Se falhar, tenta ReceitaWS (fallback)
+ * 4. Se ambos falharem, retorna erro descritivo
+ */
+export class CnpjService {
+    providers;
+    cache;
+    constructor(providers, cache) {
+        this.providers = providers ?? [
+            new BrasilApiProvider(),
+            new ReceitaWsProvider(),
+        ];
+        this.cache = cache ?? new MemoryCache(86_400_000); // 24h
+    }
+    async lookup(cnpj) {
+        // 1. Verifica cache
+        const cached = this.cache.get(cnpj);
+        if (cached) {
+            console.error(`[cnpj-mcp] Cache hit para ${cnpj}`);
+            return cached;
+        }
+        // 2. Tenta cada provider em ordem
+        const errors = [];
+        for (const provider of this.providers) {
+            try {
+                console.error(`[cnpj-mcp] Consultando ${provider.name} para ${cnpj}`);
+                const data = await provider.fetchCnpj(cnpj);
+                this.cache.set(cnpj, data);
+                return data;
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                console.error(`[cnpj-mcp] ${provider.name} falhou: ${message}`);
+                errors.push(`${provider.name}: ${message}`);
+            }
+        }
+        // 3. Todos falharam
+        throw new Error(`Não foi possível consultar o CNPJ ${cnpj}. ` +
+            `Erros: ${errors.join(" | ")}`);
+    }
+    clearCache() {
+        this.cache.clear();
+    }
+    get cacheSize() {
+        return this.cache.size;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD;;;;;;;;GAQG;AACH,MAAM,OAAO,WAAW;IACd,SAAS,CAAiB;IAC1B,KAAK,CAAwB;IAErC,YACE,SAA0B,EAC1B,KAA6B;QAE7B,IAAI,CAAC,SAAS,GAAG,SAAS,IAAI;YAC5B,IAAI,iBAAiB,EAAE;YACvB,IAAI,iBAAiB,EAAE;SACxB,CAAC;QACF,IAAI,CAAC,KAAK,GAAG,KAAK,IAAI,IAAI,WAAW,CAAW,UAAU,CAAC,CAAC,CAAC,MAAM;IACrE,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAY;QACvB,oBAAoB;QACpB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,CAAC,KAAK,CAAC,6BAA6B,IAAI,EAAE,CAAC,CAAC;YACnD,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,kCAAkC;QAClC,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACtC,IAAI,CAAC;gBACH,OAAO,CAAC,KAAK,CAAC,0BAA0B,QAAQ,CAAC,IAAI,SAAS,IAAI,EAAE,CAAC,CAAC;gBACtE,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;gBAC5C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;gBAC3B,OAAO,IAAI,CAAC;YACd,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACjE,OAAO,CAAC,KAAK,CAAC,cAAc,QAAQ,CAAC,IAAI,YAAY,OAAO,EAAE,CAAC,CAAC;gBAChE,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC,CAAC;YAC9C,CAAC;QACH,CAAC;QAED,oBAAoB;QACpB,MAAM,IAAI,KAAK,CACb,qCAAqC,IAAI,IAAI;YAC3C,UAAU,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CACjC,CAAC;IACJ,CAAC;IAED,UAAU;QACR,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;CACF"}

package/dist/providers/receita-ws.d.ts

@@ -0,0 +1,12 @@
+import type { CnpjData, CnpjProvider } from "../types.js";
+/**
+ * Provider que consulta a ReceitaWS (gratuita, limite 3 req/min).
+ * Usado como fallback quando BrasilAPI está indisponível.
+ * Docs: https://receitaws.com.br/api
+ */
+export declare class ReceitaWsProvider implements CnpjProvider {
+    name: string;
+    private baseUrl;
+    fetchCnpj(cnpj: string): Promise<CnpjData>;
+    private normalize;
+}

package/dist/providers/receita-ws.js

@@ -0,0 +1,66 @@
+/**
+ * Provider que consulta a ReceitaWS (gratuita, limite 3 req/min).
+ * Usado como fallback quando BrasilAPI está indisponível.
+ * Docs: https://receitaws.com.br/api
+ */
+export class ReceitaWsProvider {
+    name = "ReceitaWS";
+    baseUrl = "https://receitaws.com.br/v1/cnpj";
+    async fetchCnpj(cnpj) {
+        const url = `${this.baseUrl}/${cnpj}`;
+        const response = await fetch(url, {
+            headers: { Accept: "application/json" },
+            signal: AbortSignal.timeout(15_000), // ReceitaWS é mais lenta
+        });
+        if (!response.ok) {
+            throw new Error(`ReceitaWS retornou status ${response.status}`);
+        }
+        const raw = await response.json();
+        if (raw.status === "ERROR") {
+            throw new Error(raw.message || "Erro ao consultar ReceitaWS");
+        }
+        return this.normalize(raw);
+    }
+    normalize(raw) {
+        const socios = (raw.qsa || []).map((s) => ({
+            nome: s.nome || "",
+            qualificacao: s.qual || "",
+            data_entrada: "",
+            cpf_cnpj: "",
+            faixa_etaria: "",
+        }));
+        const parseActivity = (a) => ({
+            codigo: a.code || "",
+            descricao: a.text || "",
+        });
+        const atividadePrincipal = raw.atividade_principal?.length > 0
+            ? parseActivity(raw.atividade_principal[0])
+            : { codigo: "", descricao: "" };
+        const atividadesSecundarias = (raw.atividades_secundarias || []).map(parseActivity);
+        return {
+            cnpj: (raw.cnpj || "").replace(/[^\d]/g, ""),
+            razao_social: raw.nome || "",
+            nome_fantasia: raw.fantasia || "",
+            situacao_cadastral: raw.situacao || "",
+            data_situacao_cadastral: raw.data_situacao || "",
+            data_abertura: raw.abertura || "",
+            natureza_juridica: raw.natureza_juridica || "",
+            capital_social: parseFloat(raw.capital_social || "0"),
+            porte: raw.porte || "",
+            tipo: raw.tipo || "",
+            logradouro: raw.logradouro || "",
+            numero: raw.numero || "",
+            complemento: raw.complemento || "",
+            bairro: raw.bairro || "",
+            municipio: raw.municipio || "",
+            uf: raw.uf || "",
+            cep: (raw.cep || "").replace(/[^\d]/g, ""),
+            telefone: raw.telefone || "",
+            email: raw.email || "",
+            atividade_principal: atividadePrincipal,
+            atividades_secundarias: atividadesSecundarias,
+            socios,
+        };
+    }
+}
+//# sourceMappingURL=receita-ws.js.map

package/dist/providers/receita-ws.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,16 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { CnpjService } from "./providers/index.js";
+import { DailyRateLimiter } from "./utils/rate-limiter.js";
+/**
+ * Cria e configura o MCP Server com todas as tools.
+ * No tier free, aplica rate limit de 50 calls/dia nas tools que consultam API.
+ * cnpj_validate não consome quota (é local).
+ */
+export declare function createServer(opts?: {
+    service?: CnpjService;
+    rateLimiter?: DailyRateLimiter | null;
+}): {
+    server: McpServer;
+    cnpjService: CnpjService;
+    rateLimiter: DailyRateLimiter | null;
+};

package/dist/server.js

@@ -0,0 +1,57 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { CnpjService } from "./providers/index.js";
+import { handleCnpjLookup, handleCnpjValidate, handleCnpjPartners, handleCnpjActivities, handleCnpjAddress, } from "./tools/handlers.js";
+import { DailyRateLimiter, rateLimitMessage } from "./utils/rate-limiter.js";
+/**
+ * Cria e configura o MCP Server com todas as tools.
+ * No tier free, aplica rate limit de 50 calls/dia nas tools que consultam API.
+ * cnpj_validate não consome quota (é local).
+ */
+export function createServer(opts) {
+    const cnpjService = opts?.service ?? new CnpjService();
+    // null = sem rate limit (modo pro). undefined = cria default (modo free).
+    const limiter = opts?.rateLimiter === null
+        ? null
+        : opts?.rateLimiter ?? new DailyRateLimiter(50);
+    const server = new McpServer({
+        name: "cnpj-mcp",
+        version: "1.0.0",
+        description: "Consulta CNPJ, sócios e atividades de empresas brasileiras via Receita Federal. " +
+            "Plano gratuito: 50 consultas/dia. Ilimitado com @brazil-mcp/bundle-pro.",
+    });
+    function withLimit(fn, toolLabel) {
+        if (limiter && !limiter.tryConsume()) {
+            return Promise.resolve({
+                content: [{ type: "text", text: rateLimitMessage(toolLabel, limiter.limit) }],
+            });
+        }
+        return fn();
+    }
+    // ─── Tools ────────────────────────────────────────────
+    server.registerTool("cnpj_lookup", {
+        description: "Consulta dados completos de uma empresa brasileira pelo CNPJ. " +
+            "Retorna razão social, nome fantasia, endereço, capital social, sócios e CNAEs.",
+        inputSchema: {
+            cnpj: z.string().describe("CNPJ da empresa (com ou sem formatação)"),
+        },
+    }, async ({ cnpj }) => withLimit(() => handleCnpjLookup(cnpj, cnpjService), "CNPJ"));
+    server.registerTool("cnpj_validate", {
+        description: "Valida dígitos verificadores de um CNPJ (local, sem API, sem consumir quota).",
+        inputSchema: { cnpj: z.string().describe("CNPJ para validar") },
+    }, async ({ cnpj }) => handleCnpjValidate(cnpj)); // sem rate limit — é local
+    server.registerTool("cnpj_partners", {
+        description: "Lista sócios (QSA) de uma empresa pelo CNPJ.",
+        inputSchema: { cnpj: z.string().describe("CNPJ da empresa") },
+    }, async ({ cnpj }) => withLimit(() => handleCnpjPartners(cnpj, cnpjService), "CNPJ"));
+    server.registerTool("cnpj_activities", {
+        description: "Retorna CNAEs (atividades econômicas) de uma empresa pelo CNPJ.",
+        inputSchema: { cnpj: z.string().describe("CNPJ da empresa") },
+    }, async ({ cnpj }) => withLimit(() => handleCnpjActivities(cnpj, cnpjService), "CNPJ"));
+    server.registerTool("cnpj_address", {
+        description: "Retorna endereço registrado na Receita Federal para um CNPJ.",
+        inputSchema: { cnpj: z.string().describe("CNPJ da empresa") },
+    }, async ({ cnpj }) => withLimit(() => handleCnpjAddress(cnpj, cnpjService), "CNPJ"));
+    return { server, cnpjService, rateLimiter: limiter };
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/tools/format.d.ts

@@ -0,0 +1,17 @@
+import type { CnpjData } from "../types.js";
+/**
+ * Formata os dados de uma empresa em relatório textual legível.
+ */
+export declare function formatCompanyReport(data: CnpjData): string;
+/**
+ * Formata a lista de sócios de uma empresa.
+ */
+export declare function formatPartnersList(razaoSocial: string, cnpj: string, socios: CnpjData["socios"]): string;
+/**
+ * Formata as atividades econômicas de uma empresa.
+ */
+export declare function formatActivities(razaoSocial: string, cnpj: string, principal: CnpjData["atividade_principal"], secundarias: CnpjData["atividades_secundarias"]): string;
+/**
+ * Formata o endereço de uma empresa.
+ */
+export declare function formatAddress(data: CnpjData): string;

package/dist/tools/format.js

@@ -0,0 +1,94 @@
+import { formatCnpj } from "../utils/cnpj.js";
+/**
+ * Formata os dados de uma empresa em relatório textual legível.
+ */
+export function formatCompanyReport(data) {
+    const lines = [
+        `Empresa: ${data.razao_social}`,
+        data.nome_fantasia ? `Nome Fantasia: ${data.nome_fantasia}` : "",
+        `CNPJ: ${formatCnpj(data.cnpj)}`,
+        `Situação: ${data.situacao_cadastral}`,
+        `Data Abertura: ${data.data_abertura}`,
+        `Natureza Jurídica: ${data.natureza_juridica}`,
+        `Capital Social: R$ ${data.capital_social.toLocaleString("pt-BR", { minimumFractionDigits: 2 })}`,
+        data.porte ? `Porte: ${data.porte}` : "",
+        "",
+        "Endereço:",
+        `  ${[data.logradouro, data.numero ? `nº ${data.numero}` : "", data.complemento].filter(Boolean).join(", ")}`,
+        `  ${data.bairro} - ${data.municipio}/${data.uf}`,
+        `  CEP: ${data.cep}`,
+        "",
+        data.telefone ? `Telefone: ${data.telefone}` : "",
+        data.email ? `E-mail: ${data.email}` : "",
+        "",
+        `Atividade Principal: ${data.atividade_principal.codigo} - ${data.atividade_principal.descricao}`,
+    ];
+    if (data.atividades_secundarias.length > 0) {
+        lines.push(`Atividades Secundárias (${data.atividades_secundarias.length}):`, ...data.atividades_secundarias.map((a) => `  ${a.codigo} - ${a.descricao}`));
+    }
+    if (data.socios.length > 0) {
+        lines.push("", `Sócios (${data.socios.length}):`, ...data.socios.map((s) => `  - ${s.nome}${s.qualificacao ? ` (${s.qualificacao})` : ""}`));
+    }
+    return lines.filter((l) => l !== "").join("\n");
+}
+/**
+ * Formata a lista de sócios de uma empresa.
+ */
+export function formatPartnersList(razaoSocial, cnpj, socios) {
+    const lines = [
+        `Sócios de ${razaoSocial} (${formatCnpj(cnpj)}):`,
+        "",
+        ...socios.map((s, i) => {
+            const parts = [`${i + 1}. ${s.nome}`];
+            if (s.qualificacao)
+                parts.push(`   Qualificação: ${s.qualificacao}`);
+            if (s.data_entrada)
+                parts.push(`   Entrada: ${s.data_entrada}`);
+            return parts.join("\n");
+        }),
+    ];
+    return lines.join("\n");
+}
+/**
+ * Formata as atividades econômicas de uma empresa.
+ */
+export function formatActivities(razaoSocial, cnpj, principal, secundarias) {
+    const lines = [
+        `Atividades econômicas de ${razaoSocial} (${formatCnpj(cnpj)}):`,
+        "",
+        `Atividade Principal:`,
+        `  ${principal.codigo} - ${principal.descricao}`,
+    ];
+    if (secundarias.length > 0) {
+        lines.push("", "Atividades Secundárias:");
+        secundarias.forEach((a) => {
+            lines.push(`  ${a.codigo} - ${a.descricao}`);
+        });
+    }
+    return lines.join("\n");
+}
+/**
+ * Formata o endereço de uma empresa.
+ */
+export function formatAddress(data) {
+    const addressParts = [
+        data.logradouro,
+        data.numero ? `nº ${data.numero}` : "",
+        data.complemento,
+    ]
+        .filter(Boolean)
+        .join(", ");
+    const lines = [
+        `Endereço de ${data.razao_social} (${formatCnpj(data.cnpj)}):`,
+        "",
+        addressParts,
+        `${data.bairro} - ${data.municipio}/${data.uf}`,
+        `CEP: ${data.cep}`,
+    ];
+    if (data.telefone)
+        lines.push(`Telefone: ${data.telefone}`);
+    if (data.email)
+        lines.push(`E-mail: ${data.email}`);
+    return lines.join("\n");
+}
+//# sourceMappingURL=format.js.map

package/dist/tools/format.js.map

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

package/dist/tools/handlers.d.ts

@@ -0,0 +1,14 @@
+import { CnpjService } from "../providers/index.js";
+/** Tipo padrão de retorno dos handlers MCP. */
+export interface ToolResult {
+    [key: string]: unknown;
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+}
+export declare function handleCnpjLookup(cnpj: string, service: CnpjService): Promise<ToolResult>;
+export declare function handleCnpjValidate(cnpj: string): Promise<ToolResult>;
+export declare function handleCnpjPartners(cnpj: string, service: CnpjService): Promise<ToolResult>;
+export declare function handleCnpjActivities(cnpj: string, service: CnpjService): Promise<ToolResult>;
+export declare function handleCnpjAddress(cnpj: string, service: CnpjService): Promise<ToolResult>;

package/dist/tools/handlers.js

@@ -0,0 +1,77 @@
+import { cleanCnpj, formatCnpj, isValidCnpj } from "../utils/cnpj.js";
+import { formatCompanyReport, formatPartnersList, formatActivities, formatAddress, } from "./format.js";
+function textResult(text) {
+    return { content: [{ type: "text", text }] };
+}
+function errorResult(prefix, err) {
+    const message = err instanceof Error ? err.message : String(err);
+    return textResult(`❌ ${prefix}: ${message}`);
+}
+// ─── cnpj_lookup ──────────────────────────────────────────
+export async function handleCnpjLookup(cnpj, service) {
+    const clean = cleanCnpj(cnpj);
+    if (!isValidCnpj(clean)) {
+        return textResult(`❌ CNPJ inválido: ${cnpj}. Verifique se todos os dígitos estão corretos.`);
+    }
+    try {
+        const data = await service.lookup(clean);
+        return textResult(formatCompanyReport(data));
+    }
+    catch (err) {
+        return errorResult("Erro ao consultar CNPJ", err);
+    }
+}
+// ─── cnpj_validate ────────────────────────────────────────
+export async function handleCnpjValidate(cnpj) {
+    const clean = cleanCnpj(cnpj);
+    const valid = isValidCnpj(clean);
+    return textResult(valid
+        ? `✅ CNPJ ${formatCnpj(clean)} é válido (dígitos verificadores corretos).`
+        : `❌ CNPJ ${cnpj} é inválido. Os dígitos verificadores não conferem.`);
+}
+// ─── cnpj_partners ────────────────────────────────────────
+export async function handleCnpjPartners(cnpj, service) {
+    const clean = cleanCnpj(cnpj);
+    if (!isValidCnpj(clean)) {
+        return textResult(`❌ CNPJ inválido: ${cnpj}`);
+    }
+    try {
+        const data = await service.lookup(clean);
+        if (!data.socios || data.socios.length === 0) {
+            return textResult(`Nenhum sócio encontrado para ${formatCnpj(clean)} (${data.razao_social}).`);
+        }
+        return textResult(formatPartnersList(data.razao_social, clean, data.socios));
+    }
+    catch (err) {
+        return errorResult("Erro", err);
+    }
+}
+// ─── cnpj_activities ──────────────────────────────────────
+export async function handleCnpjActivities(cnpj, service) {
+    const clean = cleanCnpj(cnpj);
+    if (!isValidCnpj(clean)) {
+        return textResult(`❌ CNPJ inválido: ${cnpj}`);
+    }
+    try {
+        const data = await service.lookup(clean);
+        return textResult(formatActivities(data.razao_social, clean, data.atividade_principal, data.atividades_secundarias));
+    }
+    catch (err) {
+        return errorResult("Erro", err);
+    }
+}
+// ─── cnpj_address ─────────────────────────────────────────
+export async function handleCnpjAddress(cnpj, service) {
+    const clean = cleanCnpj(cnpj);
+    if (!isValidCnpj(clean)) {
+        return textResult(`❌ CNPJ inválido: ${cnpj}`);
+    }
+    try {
+        const data = await service.lookup(clean);
+        return textResult(formatAddress(data));
+    }
+    catch (err) {
+        return errorResult("Erro", err);
+    }
+}
+//# sourceMappingURL=handlers.js.map