MCP App Store
by KeenEthics
Nivro icon

Nivro MCP Server for ChatGPT

By Nivro

Overview

Nivro is a retail management system (ERP): sales and point of sale, stock with size/color variants, orders, customers, receivables, purchasing and invoicing for Brazilian stores. With this connector, Nivro users ask about their own store right in the conversation, and the answer comes from the company's data in Nivro. Examples: "how were sales this month?", "which products sold the most this quarter?", "who has an overdue installment?", "do I have the black T-shirt in M in stock?", "show me order 123", "how is cash flow this week?". Read-only: the connector never creates, changes or deletes anything in Nivro. It acts with the permissions of the person who connected, so nobody sees through the AI what they could not see on screen. Customer tax IDs are always masked; phone and email are shown in full only on a single customer's record. To connect, sign in with your Nivro account, pick the company and authorize. Disconnect anytime in Settings > Users and access > AI connections in Nivro. Requires a Nivro account (nivro.app). The product is in Brazilian Portuguese.

How to connect

  1. ChatGPT: Open the Nivro listing in the ChatGPT app directory and choose Connect. ChatGPT listing Nivro exposes 22 tools here.

Tools

buscar_clientes

ChatGPT
Lista ou procura clientes pelo nome, telefone ou e-mail (sem texto, lista toda a base). Devolve o TOTAL de clientes do filtro (use para "quantos clientes eu tenho"), e por página nome, tipo, cidade e se o cliente tem valor a receber em aberto. Documento, telefone e e-mail saem parcialmente ocultos; o contato completo de UM cliente está em obter_cliente. Somente leitura.

buscar_produtos

ChatGPT
Lista ou procura produtos e serviços do catálogo pelo nome, SKU ou marca (sem texto, lista o catálogo). Devolve o TOTAL do filtro (use para "quantos produtos eu tenho"), e por página preço, saldo em estoque, estoque mínimo e se tem grade (tamanho/cor). Para o saldo por tamanho/cor de um produto use consultar_estoque. O custo só aparece para quem a tela deixa ver. Somente leitura.

consultar_estoque

ChatGPT
Mostra o saldo em estoque de um produto, e o saldo de cada variação da grade (tamanho, cor, sabor...) quando o produto tem. Informe o nome, SKU ou o id do produto; se o texto casar com vários produtos (até 5), devolve cada um. Use para "quanto tenho da camiseta M". Somente leitura.

contas_a_receber

ChatGPT
Parcelas em aberto de vendas a prazo e crediário (quem deve, quanto, e desde quando), em ordem de vencimento, com juros e multa já calculados. Aceita filtrar por cliente e só as vencidas. Devolve também o total em aberto. Use para "quem está me devendo" ou "o que vence esta semana". Somente leitura.

criar_cliente

ChatGPT
Cadastra UM cliente novo na empresa (o mesmo cadastro da tela de Clientes). Só dono e gerente podem. ANTES, rode buscar_clientes com o nome: cliente repetido é o erro mais comum. Informe só o que o usuário disse (nome; opcionais: telefone, e-mail, endereço, observações); nunca invente nem complete dado. Se já houver cliente com nome igual ou parecido, NÃO cria e devolve possiveisDuplicados: pergunte ao usuário se é a mesma pessoa; só se ele disser que é outra pessoa chame de novo com confirmoQueENovo: true. Se a resposta vier com repetido: true, o cadastro já tinha sido feito há poucos minutos e nada foi duplicado. Para empresa informe tipo PJ e nomeOficial (razão social). Documentos de identificação não são recebidos por aqui: o usuário completa na tela de Clientes do Nivro. Dado cadastrado é dado de verdade da loja.

criar_pedido

ChatGPT
Cria o pedido que a prévia (previa_pedido) mostrou, DEPOIS de o usuário confirmar com um "sim" explícito. Envie os MESMOS argumentos da prévia e o campo confirmacao que ela devolveu; se o total passar de R$ 5.000, também totalConfirmado com o valor que o usuário confirmou. Se algo mudou desde a prévia (preço, produto), recusa com confirmacao_desatualizada: refaça a prévia e pergunte de novo. O pedido nasce confirmado e RESERVA o estoque dos itens; pode ser recusado por estoque insuficiente ou desconto acima do limite do usuário (não há como forçar por aqui). Não avisa o cliente e não envia link de aprovação: não faça isso. Repetir a chamada com o mesmo confirmacao devolve o mesmo pedido (repetido: true), sem criar outro. Não cancela nem altera pedido.

criar_venda

ChatGPT
Registra a venda que a prévia (previa_venda) mostrou, DEPOIS de o usuário confirmar com um "sim" explícito. Envie os MESMOS argumentos da prévia e o campo confirmacao que ela devolveu; se o total passar de R$ 5.000, também totalConfirmado com o valor que o usuário confirmou. Se algo mudou desde a prévia (preço, produto, pagamentos), recusa com confirmacao_desatualizada: refaça a prévia e pergunte de novo. A venda é feita AGORA, em nome do usuário, baixa o estoque e registra os pagamentos; pode ser recusada por estoque, limite de crédito ou desconto acima do limite do usuário (não há como forçar por aqui). A nota fiscal só é emitida se o usuário respondeu emitirNota: true na prévia (o mesmo "sim" cobre a venda e a nota); a nota nunca sai sozinha e, se ela falhar, a venda continua registrada e a resposta diz o motivo. Repetir a chamada com o mesmo confirmacao devolve a mesma venda (repetido: true), sem criar outra nem emitir outra nota. Não cancela nem altera venda: se o usuário desistir, o cancelamento é pela tela do Nivro.

emitir_nota_da_venda

ChatGPT
Emite a nota fiscal (NFC-e ou NF-e, conforme a regra da empresa) de uma venda que já foi registrada. USE SÓ quando o usuário pedir a nota desta venda: antes, chame obter_venda e leia o bloco notaFiscal (se a venda já tem nota, se dá para emitir, qual modelo e se o ambiente é de homologação, onde a nota NÃO tem valor fiscal), diga ao usuário o que vai acontecer e só chame esta ferramenta com um "sim" explícito dele. Informe o id (UUID) da venda, de listar_vendas ou obter_venda. A emissão é um ato fiscal e pode gerar cobrança conforme o plano. Não aconselhe o usuário a emitir ou não: essa decisão e as questões de tributo são dele e do contador. Se a venda já tem nota, devolve a nota que existe, sem emitir outra. Se faltar cadastro (cliente, produto, empresa), a nota não sai e nenhum número é gasto: explique o que falta; corrigir é pela tela do Nivro (nunca preencha dado fiscal). Se a nota ficar em processamento, não repita a chamada: consulte obter_venda mais tarde. Só dono e gerente, e só venda de balcão ou pedido faturado (venda de ordem de serviço é pela tela). Não cancela nota.

faturar_pedido

ChatGPT
Fatura o pedido (cria a venda, baixa o estoque reservado e registra os pagamentos) que a prévia (previa_faturamento) mostrou, DEPOIS de o usuário confirmar com um "sim" explícito. Envie os MESMOS argumentos da prévia e o campo confirmacao que ela devolveu; se o total passar de R$ 5.000, também totalConfirmado com o valor que o usuário confirmou. Se algo mudou desde a prévia (separação, adiantamento, preço), recusa com confirmacao_desatualizada: refaça a prévia e pergunte de novo. A nota fiscal só é emitida se o usuário respondeu emitirNota: true na prévia (o mesmo "sim" cobre a venda e a nota); a nota nunca sai sozinha e, se falhar, a venda continua registrada e a resposta diz o motivo. Repetir a chamada, ou faturar um pedido que já foi faturado, devolve a mesma venda (repetido: true) sem criar outra nem emitir outra nota. Não cancela nem estorna venda.

fluxo_de_caixa

ChatGPT
Entradas, saídas e saldo do caixa num período (valores já confirmados: o que realmente entrou e saiu), com o saldo inicial e o saldo atual. Períodos de até 62 dias vêm dia a dia; maiores vêm mês a mês. Use para "quanto entrou e saiu este mês". Informe o período. Somente leitura.

listar_pedidos

ChatGPT
Lista os pedidos da empresa (orçamentos e pedidos de venda), do mais novo para o mais antigo, com situação, cliente e valor. Use para perguntas como "quais foram os pedidos de hoje" ou "o que está para entregar". Aceita filtro por situação, período e busca (código ou número do pedido, nome do cliente). Para ver os itens de um pedido, use obter_pedido. Somente leitura.

listar_vendas

ChatGPT
Lista as vendas já feitas (balcão, pedidos faturados, etc.), da mais nova para a mais antiga, com cliente, valor, quanto foi pago e a situação (Pago, Pendente ou Cancelada). Use para "quais foram as vendas de ontem" ou "vendas pendentes do cliente X". Para totais e ticket médio de um período use resumo_vendas. Somente leitura.

obter_cliente

ChatGPT
Mostra a ficha de UM cliente (contato, endereço e o documento parcialmente oculto), quanto ele já comprou e o que tem a receber em aberto (parcelas, vencidas ou não). Informe o id do cliente (obtido em buscar_clientes). Somente leitura.

obter_pedido

ChatGPT
Mostra um pedido completo: itens (com variação/grade, quantidade, preço e o que já foi separado), cliente, situação, entrega, adiantamento recebido e histórico de situações. Aceita o id do pedido ou o código/número que aparece na tela (ex.: 00123). Somente leitura.

obter_venda

ChatGPT
Mostra uma venda completa: itens (com variação/grade e número de série quando houver), formas de pagamento, parcelas a receber, cliente e vendedor. Informe o id da venda (obtido em listar_vendas). Somente leitura.

pdf_do_pedido

ChatGPT
Gera o PDF de um pedido ou orçamento (o mesmo documento do botão de PDF da tela do Nivro) para o usuário baixar ou enviar ao cliente. Aceita o id do pedido ou o código/número que aparece na tela (ex.: 00123). Devolve um LINK temporário que vale 10 minutos: o usuário precisa abrir o link no navegador, o conteúdo do PDF não vem na resposta. O PDF tem os dados do cliente. Use quando o usuário pedir o PDF, o orçamento em arquivo ou algo para mandar ao cliente. Somente leitura: não envia nada a ninguém.

previa_faturamento

ChatGPT
PRIMEIRO PASSO para faturar um pedido (transformá-lo em venda): mostra o que a venda terá (itens separados, total, faltas, adiantamento já recebido, o que falta pagar), confere as formas de pagamento e a nota fiscal, e devolve o resumo com um confirmacao. NÃO fatura nada. Informe o id do pedido, os pagamentos (forma e valor, ditos pelo usuário: a soma tem de ser igual ao que falta pagar; a parte que fica para depois é A_PRAZO) e, se a nota fiscal estiver disponível, emitirNota (pergunte; sem padrão). Se faltar pagamento ou a resposta da nota, devolve informacao_faltando com o valor que falta pagar: pergunte tudo ao usuário de uma vez. Mostre o resumo ao usuário e só com um "sim" explícito chame faturar_pedido. Recusa: pedido cancelado, orçamento vencido, nada separado, cobrança na entrega, item com IMEI/série, loja com controle de caixa ligado. Pedido já faturado devolve a venda. Pode ser feito só por gerente ou dono.

previa_pedido

ChatGPT
PRIMEIRO PASSO para criar um pedido (orçamento/pedido de venda): confere cliente, produtos, variações e quantidades, calcula o preço de cada item como o PDV (tabela de preço do cliente) e o total, e devolve o resumo com um confirmacao. NÃO cria nada. Use SÓ ids de buscar_clientes e buscar_produtos (nunca nomes); se faltar algo (cliente, quantidade, variação de um produto com grade), devolve informacao_faltando: pergunte ao usuário tudo de uma vez. Mostre ao usuário o resumo (cliente, cada item com preço e de onde veio o preço, total) e pergunte se confirma; só com um "sim" explícito chame criar_pedido. Não faz parte da prévia: o estoque e o teto de desconto, conferidos só ao criar. Item com IMEI/série não é aceito.

previa_venda

ChatGPT
PRIMEIRO PASSO para registrar uma venda de balcão (venda agora, à vista ou parte a prazo): confere cliente, produtos, variações, quantidades, estoque, pagamentos e nota fiscal, calcula o preço de cada item como o PDV (tabela de preço do cliente) e o total, e devolve o resumo com um confirmacao. NÃO registra nada. Use SÓ ids de buscar_clientes e buscar_produtos (nunca nomes). Os pagamentos são ditos pelo usuário (forma e valor): a soma tem de ser IGUAL ao total; a parte que o cliente pagará depois é A_PRAZO (exige cliente). Não há troco. Se faltar algo (produto, quantidade, variação, forma de pagamento, resposta da nota fiscal), devolve informacao_faltando: pergunte tudo ao usuário de uma vez. Mostre o resumo (cliente, itens com preço e de onde veio, total, pagamentos, vencimento) e só com um "sim" explícito chame criar_venda. Recusa: loja com controle de caixa ligado, teste da empresa encerrado, estoque insuficiente, item com IMEI/série, cliente acima do limite de crédito. Não faz parte da prévia: o teto de desconto do usuário, conferido só ao registrar.

produtos_mais_vendidos

ChatGPT
Ranking dos produtos que mais venderam num período, por faturamento ou por quantidade, descontando devoluções e vendas canceladas. O faturamento é preço x quantidade das linhas, antes do desconto dado no total da venda. Informe o período. Somente leitura.

quem_sou_eu

ChatGPT
Diz com qual usuário e em qual empresa do Nivro esta conversa está conectada, e qual é o papel dele (dono, gerente, operador, leitor ou contador). Use no começo da conversa para confirmar com o usuário que é a empresa certa, e quando uma consulta for recusada por falta de permissão. Lista também quais consultas este usuário pode fazer. Somente leitura.

resumo_vendas

ChatGPT
Resumo do desempenho de um período: faturamento, número de vendas, ticket médio, formas de pagamento, valores a receber gerados e recebidos, lucro bruto, melhores vendedores, melhores clientes e os 5 produtos que mais venderam. Use para "como foram as vendas do mês". Informe o período. Venda cancelada não conta. Somente leitura.

Capabilities

Writes

Example Prompts

Click any prompt to copy it.

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/nivro"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/nivro)