@conflaro/mcp 1.9.0 → 1.11.0

package/README.md

@@ -96,7 +96,7 @@ faltou, sem erro de versão duplicada.
 recusam quando divergem. O servidor lê a dele do `package.json`.
 
 O npm publica por **Trusted Publisher** (OIDC): o vínculo é com
-`conflaro/conttrole` + `mcp-publish.yml`, configurado nas Settings do pacote no
+`conflaro/app` + `mcp-publish.yml`, configurado nas Settings do pacote no
 npmjs.com. Renomear o workflow quebra a publicação.
 🔴 Pacote novo não aceita Trusted Publisher antes de existir: a 1ª versão do
 `@conflaro/mcp` sai à mão (`npm publish` no terminal, com a passkey), que depois é apagado (ver o

package/dist/index.js

@@ -77,13 +77,24 @@ const server = new McpServer({ name: "conflaro", version });
 // ── Empresa ────────────────────────────────────────────────────────────────
 server.tool("get_company", "Mostra os dados da empresa dona da chave de API configurada (razão social, CNPJ, IE/IM, regime tributário, endereço).", {}, tool(() => api("GET", "/v1/company")));
 // ── Documentos fiscais ─────────────────────────────────────────────────────
+// Sem `companyId`: a empresa da chave. Com `companyId`: uma empresa da
+// CARTEIRA do escritório (chave `ok_`) — escrever exige ainda que a empresa
+// tenha liberado a emissão pelo contador.
+const FD_COMPANY = z
+    .string()
+    .optional()
+    .describe("SÓ no modo contador (chave do escritório `ok_`): a empresa da carteira (id de list_portfolio_companies). Omita com a chave de uma empresa.");
+const fdBase = (companyId) => companyId
+    ? `/v1/accounting/companies/${encodeURIComponent(String(companyId))}/fiscal-documents`
+    : "/v1/fiscal-documents";
 server.tool("list_fiscal_documents", "Lista os documentos fiscais (NF-e/NFC-e/NFS-e) da empresa, com paginação e filtros por status e tipo.", {
     page: z.number().int().positive().optional().describe("Página (default 1)"),
     pageSize: z.number().int().positive().max(100).optional().describe("Itens por página (default 20, máx 100)"),
     status: z.string().optional().describe("Filtra por status (ex.: AUTHORIZED, DRAFT, REJECTED)"),
     type: z.string().optional().describe("Filtra por tipo (NFE, NFCE, NFSE)"),
-}, tool((a) => api("GET", "/v1/fiscal-documents", { query: a })));
-server.tool("get_fiscal_document", "Detalha um documento fiscal pelo id (status, número, chave de acesso, itens, etc.).", { id: z.string().describe("ID do documento fiscal") }, tool((a) => api("GET", `/v1/fiscal-documents/${a.id}`)));
+    companyId: FD_COMPANY,
+}, tool(({ companyId, ...query }) => api("GET", fdBase(companyId), { query })));
+server.tool("get_fiscal_document", "Detalha um documento fiscal pelo id (status, número, chave de acesso, itens, etc.).", { id: z.string().describe("ID do documento fiscal"), companyId: FD_COMPANY }, tool((a) => api("GET", `${fdBase(a.companyId)}/${a.id}`)));
 /**
  * 🔴 Estes shapes são um RECORTE da API pública, não um espelho dela.
  *
@@ -310,6 +321,7 @@ const itemShape = z.object({
 }).passthrough();
 server.tool("create_fiscal_document", "Cria um documento fiscal (rascunho). Use emit=true para já enfileirar a emissão. Impostos são resolvidos pela regra tributária quando não informados.", {
     type: z.enum(["NFE", "NFCE", "NFSE"]).describe("Tipo do documento"),
+    companyId: FD_COMPANY,
     clientId: z
         .string()
         .optional()
@@ -472,22 +484,24 @@ server.tool("create_fiscal_document", "Cria um documento fiscal (rascunho). Use
     // `z.object` fechado, então campo não declarado seria DESCARTADO em
     // silêncio — o pior desfecho, porque a nota sai sem ele e nada avisa.
     // O declarado vence o `extra` quando os dois trazem a mesma chave.
-    const { extra, ...campos } = a;
+    const { extra, companyId, ...campos } = a;
     const declarados = Object.fromEntries(Object.entries(campos).filter(([, v]) => v !== undefined));
-    return api("POST", "/v1/fiscal-documents", {
+    return api("POST", fdBase(companyId), {
         body: { ...(extra ?? {}), ...declarados },
     });
 }));
-server.tool("emit_fiscal_document", "Dispara a emissão (assíncrona) de um documento fiscal já criado. Acompanhe o status com get_fiscal_document.", { id: z.string().describe("ID do documento fiscal") }, tool((a) => api("POST", `/v1/fiscal-documents/${a.id}/emit`)));
+server.tool("emit_fiscal_document", "Dispara a emissão (assíncrona) de um documento fiscal já criado. Acompanhe o status com get_fiscal_document.", { id: z.string().describe("ID do documento fiscal"), companyId: FD_COMPANY }, tool((a) => api("POST", `${fdBase(a.companyId)}/${a.id}/emit`)));
 server.tool("cancel_fiscal_document", "Cancela um documento fiscal AUTORIZADO, com justificativa.", {
     id: z.string().describe("ID do documento fiscal"),
     reason: z.string().min(15).describe("Justificativa do cancelamento (mín. 15 caracteres)"),
-}, tool((a) => api("POST", `/v1/fiscal-documents/${a.id}/cancel`, { body: { reason: a.reason } })));
+    companyId: FD_COMPANY,
+}, tool((a) => api("POST", `${fdBase(a.companyId)}/${a.id}/cancel`, { body: { reason: a.reason } })));
 server.tool("correct_fiscal_document", "Emite uma Carta de Correção (CC-e) para um documento fiscal autorizado.", {
     id: z.string().describe("ID do documento fiscal"),
     text: z.string().min(15).describe("Texto da correção (mín. 15 caracteres)"),
-}, tool((a) => api("POST", `/v1/fiscal-documents/${a.id}/correction`, { body: { text: a.text } })));
-server.tool("get_fiscal_document_xml", "Baixa o XML autorizado de um documento fiscal (retorna o XML como texto).", { id: z.string().describe("ID do documento fiscal") }, tool((a) => api("GET", `/v1/fiscal-documents/${a.id}/xml`)));
+    companyId: FD_COMPANY,
+}, tool((a) => api("POST", `${fdBase(a.companyId)}/${a.id}/correction`, { body: { text: a.text } })));
+server.tool("get_fiscal_document_xml", "Baixa o XML autorizado de um documento fiscal (retorna o XML como texto).", { id: z.string().describe("ID do documento fiscal"), companyId: FD_COMPANY }, tool((a) => api("GET", `${fdBase(a.companyId)}/${a.id}/xml`)));
 // ── GNRE por operação (docs/plans/gnre.md §8) ──
 server.tool("get_fiscal_document_gnre", "GNRE da nota (guia de recolhimento do DIFAL, FCP e ICMS-ST devidos a OUTRA UF): o que a NF-e autorizada exige (`assessment`, pelo XML), as guias geradas (status, valor, vencimento, `digitableLine` para pagar) e a cota do mês. `noGuideReason` explica quando NÃO há guia devida. Valores em string decimal.", { id: z.string().describe("ID do documento fiscal (NF-e)") }, tool((a) => api("GET", `/v1/fiscal-documents/${encodeURIComponent(String(a.id))}/gnre`)));
 server.tool("generate_fiscal_document_gnre", "Gera (ou regera) as guias GNRE da nota no Portal GNRE — fala com o fisco, consome a cota do plano e cria obrigação de pagamento: confirme com o usuário antes. Idempotente (guia emitida não é refeita). O resultado sai em ≥ 30 s: depois consulte get_fiscal_document_gnre (ou refresh_fiscal_document_gnre). `blocked` = falta dado que só a pessoa resolve; o motivo fica na guia. Exige o módulo GNRE (403 `feature_not_enabled`).", { id: z.string().describe("ID do documento fiscal (NF-e autorizada)") }, tool((a) => api("POST", `/v1/fiscal-documents/${encodeURIComponent(String(a.id))}/gnre`)));
@@ -794,6 +808,14 @@ server.tool("get_simples_das_forecast", "Previsão do DAS do MÊS CORRENTE se o
         : "/v1/simples/forecast";
     return api("GET", path);
 }));
+server.tool("get_simples_monophasic_recovery", "PIS/COFINS monofásico que a empresa do Simples PODE ter pago a mais no DAS nos últimos 60 meses: revenda de NCM monofásico emitida sem o CST 04 de PIS, com o PIS/COFINS da alíquota efetiva do Anexo I de cada mês. É INDÍCIO a confirmar com o contador (só houve pagamento a mais se o PGDAS-D não segregou a receita) — diga isso. `monthsWithoutRate` ficou FORA do total. Escopo `simples:read`.", {
+    companyId: RD_COMPANY,
+}, tool((a) => {
+    const path = a.companyId
+        ? `/v1/accounting/companies/${encodeURIComponent(String(a.companyId))}/simples/monophasic-recovery`
+        : "/v1/simples/monophasic-recovery";
+    return api("GET", path);
+}));
 server.tool("get_product_tax_in_price", "Quanto do preço de um produto é imposto (empresa do Simples): alíquota efetiva do DAS do anexo do produto, imposto no preço, margem e o PREÇO MÍNIMO para a margem desejada. Valores em string decimal (\"40.00\"). `minimumPrice: null` = imposto + despesas + margem passam de 100%. Nada é gravado. Escopo `simples:read`.", {
     productId: z.string().describe("Id do produto (list_products)"),
     cost: z.string().describe("Custo unitário, decimal em string"),
@@ -814,6 +836,13 @@ server.tool("list_portfolio_companies", "MODO CONTADOR: as empresas-cliente com
     page: z.number().int().positive().optional(),
     pageSize: z.number().int().positive().max(100).optional(),
 }, tool((a) => api("GET", "/v1/accounting/companies", { query: a })));
+server.tool("list_portfolio_company_clients", "MODO CONTADOR: os clientes cadastrados numa empresa da carteira — o `clientId` para criar nota por ela (create_fiscal_document com `companyId`).", {
+    companyId: z.string().describe("Empresa da carteira (id de list_portfolio_companies)"),
+    search: z.string().optional().describe("Nome, documento, email ou nome fantasia"),
+    page: z.number().int().positive().optional(),
+    pageSize: z.number().int().positive().max(100).optional(),
+}, tool(({ companyId, ...query }) => api("GET", `/v1/accounting/companies/${encodeURIComponent(String(companyId))}/clients`, { query })));
+server.tool("get_portfolio_nfse_readiness", "MODO CONTADOR: a empresa da carteira consegue emitir NFS-e agora? (certificado, configuração do município, cota do plano) — sem criar nota. Use antes de propor uma NFS-e.", { companyId: z.string().describe("Empresa da carteira (id de list_portfolio_companies)") }, tool((a) => api("GET", `/v1/accounting/companies/${encodeURIComponent(String(a.companyId))}/nfse-readiness`)));
 server.tool("list_closing_eligible_companies", "MODO CONTADOR: empresas da carteira com nota de PRODUÇÃO autorizada ou cancelada no mês (BRT) — as que o fechamento vai processar. Mês é 1–12.", {
     year: z.number().int().describe("Ano (ex.: 2026)"),
     month: z.number().int().min(1).max(12).describe("Mês, 1–12"),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@conflaro/mcp",
-  "version": "1.9.0",
+  "version": "1.11.0",
   "description": "Servidor MCP da Conflaro — emissão fiscal (NF-e, NFC-e, NFS-e) por IA",
   "mcpName": "io.conttrole/mcp",
   "type": "module",