Qual a diferença entre o Servidor MCP e a API do Chat da Brasil NFe?

São dois caminhos para integrar IA, ambos autenticados pelo mesmo token de empresa. No Servidor MCP, quem traz o modelo de IA é você (Claude, ChatGPT, Cursor, Copilot): a Brasil NFe expõe 34 ferramentas fiscais e você constrói o agente. Na API do Chat, quem traz a IA é a Brasil NFe — o Assistente Fiscal já pronto, com o cérebro fiscal embutido — e você constrói só a interface (UI), enviando mensagens em linguagem natural por REST (JSON) ou SSE. Use o MCP se já tem uma IA e quer dar a ela as ferramentas fiscais; use a API do Chat se quer a IA pronta respondendo o seu usuário.

Como funciona a cobrança da API do Chat da Brasil NFe?

Cada turno da API do Chat consome créditos da carteira da empresa do token, proporcional ao tamanho da resposta e às ferramentas usadas. O acesso via API consome apenas créditos comprados — não usa a cota grátis mensal do plano, que é exclusiva do chat do painel. Sem saldo, o turno é recusado com HTTP 402. O saldo pode ser consultado a qualquer momento em GET /quota. O MCP, por outro lado, não tem cobrança por chamada: está incluso no plano fiscal contratado.

A API do Chat da Brasil NFe suporta streaming em tempo real?

Sim. O cabeçalho Accept decide o formato da resposta: application/json devolve uma resposta única e consolidada; text/event-stream entrega via Server-Sent Events (SSE), igual ao chat do painel. No streaming, o cliente recebe eventos conforme a IA processa: text (deltas da resposta), tool_call_start e tool_result (ferramentas), artifact (documentos gerados como DANFE em PDF, XML e cupom HTML), usage e done. É ideal para exibir a resposta digitando em tempo real na interface.

IA Fiscal · MCP + API de Chat

Coloque IA na sua emissão fiscal

Dois caminhos, um único token. Conecte a sua IA às nossas ferramentas fiscais via Servidor MCP, ou use a nossa IA pronta pela API de Chat e monte só a interface. NF-e, NFC-e, NFS-e, CT-e, MDF-e e DC-e por linguagem natural.

MCP · Streamable HTTP Chat · REST + SSE Bearer token por empresa Auditoria por chamada

Ver a demo ao vivo Qual caminho é o meu?

// claude_desktop_config.json
{
  "mcpServers": {
    "brasilnfe": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://api.brasilnfe.com.br/services/Mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer SEU_TOKEN"
      }
    }
  }
}
                            

// .cursor/mcp.json
{
  "mcpServers": {
    "brasilnfe": {
      "url": "https://api.brasilnfe.com.br/services/Mcp",
      "headers": {
        "Authorization": "Bearer SEU_TOKEN"
      }
    }
  }
}
                            

# Listar tools disponíveis
curl -X POST "https://api.brasilnfe.com.br/services/Mcp" \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list"
  }'
                            

# Nossa IA responde e emite por você
curl -X POST ".../AiChatApi/sessions/TOKEN/messages" \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Emite uma NF-e de R$ 1.500 para o cliente X",
    "tipoAmbiente": 2
  }'
# → reply + toolCalls + artifacts (DANFE, XML)
                            

Escolha o seu caminho

Duas formas de colocar IA na emissão fiscal

São complementares e usam o mesmo token de empresa. A diferença é simples: quem traz o modelo de IA?

Recomendado para você

Caminho 1

Servidor MCP

Você já tem um LLM ou agente (Claude, ChatGPT, Cursor, Copilot). Conecte-o às nossas 34 ferramentas fiscais e ele passa a emitir por linguagem natural.

Quem traz a IA: você (o seu LLM/agente)

Você constrói: o agente inteiro

Transporte: MCP (JSON-RPC / Streamable HTTP)

Ideal para: copilotos, IDEs e automações internas

Ver o MCP Documentação

Recomendado para você

Caminho 2

API do Chat

Você não quer montar um agente. Use a nossa IA (com o cérebro fiscal pronto) por HTTP e construa só a interface do seu usuário.

Quem traz a IA: nós (o Assistente Fiscal pronto)

Você constrói: só a interface (UI)

Transporte: REST (JSON) ou SSE (streaming)

Ideal para: chats no seu app, portais e SaaS

Ver a API do Chat Documentação

Caminho 1 · Servidor MCP

O que é MCP (Model Context Protocol) e por que importa para a sua operação fiscal

O Model Context Protocol (MCP) é o protocolo aberto criado pela Anthropic em novembro de 2024 que padroniza a forma como agentes de IA descobrem e usam ferramentas externas. Em poucos meses, virou o “USB-C dos agentes”: foi adotado por OpenAI, Google, Microsoft Copilot, Cursor, Windsurf, Zed, JetBrains, GitHub Copilot e Continue.dev. Hoje, qualquer modelo (Claude, ChatGPT, Gemini, Copilot) consegue conversar com qualquer servidor MCP — sem integração custom, sem SDK proprietário, sem lock-in.

A operação fiscal brasileira é especialmente difícil para uma IA improvisar: 5.500+ municípios com regras próprias para NFS-e, 543 códigos de rejeição da SEFAZ, ICMS/IPI/PIS/COFINS/ST/DIFAL/FCP, CFOP por operação, CST por regime, prazos legais de cancelamento, certificado digital A1, contingência. Sem uma camada que entenda esse contexto, qualquer agente erra. O MCP Server da Brasil NFe é essa camada: expõe 34 tools fiscais, 5 prompts prontos e 5 resources com snapshot da empresa, regime tributário e estado de contingência.

Com MCP plugado, o desenvolvedor descreve em português: “emita uma NF-e de R$ 1.500 para o CNPJ 12.345.678/0001-00 com um notebook”. O agente lê brasilnfe://empresa/atual para confirmar emitente, chama sefaz_status para conferir SEFAZ, e dispara nfe_emitir com os dados certos. Em 3 segundos, retorna chave de acesso, protocolo e DANFE em PDF. Brasil NFe é a primeira API fiscal nacional com servidor MCP nativo, disponível desde julho de 2025.

Para times de produto e engenharia, isso muda o game: chatbots internos de NF-e sem integração custom, copilotos contábeis que cancelam e corrigem nota direto do Cursor, automações no Claude Desktop para o financeiro emitir relatório do período, scripts no ChatGPT que fazem diagnóstico de emissão antes do fechamento. Tudo isso plugando um único servidor MCP no cliente de IA que sua equipe já usa.

Como funciona

Conecte sua IA à SEFAZ em três passos

Sem SDK, sem servidor intermediário, sem proxy. O cliente MCP fala direto com a Brasil NFe.

Pegue seu token

Crie uma conta no painel Brasil NFe (grátis em homologação) e copie o token de empresa. Esse mesmo token autentica chamadas MCP e REST.

Configure o cliente MCP

Adicione o servidor https://api.brasilnfe.com.br/services/Mcp ao Claude Desktop, Cursor, Windsurf ou Copilot, com Authorization: Bearer SEU_TOKEN. Reinicie o cliente.

Converse com sua IA

O agente descobre as 34 tools automaticamente. Peça em português: “emite uma NF-e”, “cancela essa nota”, “faz um relatório do mês”. A SEFAZ responde em segundos.

Catálogo de tools

34 tools fiscais prontas para chamadas de IA

Cada tool tem inputSchema/outputSchema gerados a partir dos contratos C# da API e anotações readOnly, destructive, idempotent que o cliente MCP usa para pedir confirmação ao usuário em operações sensíveis.

NF-e / NFC-e

nfe_emitir

Emite NF-e (modelo 55) ou NFC-e (modelo 65). Retorna chave, protocolo, XML e DANFE em base64.

nfe_emitir_complementar

NF-e complementar (finalidade=2) referenciando uma nota original já autorizada.

nfe_previsualizarRead

Pré-visualização do DANFE em PDF, sem enviar para a SEFAZ.

NFS-e

nfse_emitir

Emite NFS-e via Portal Nacional ou prefeitura específica conforme cadastro.

nfse_consultarRead

Consulta status e dados de uma NFS-e por número, série e ambiente.

CT-e · MDF-e · DC-e · NF-EnerCom

cte_emitir

Emite CT-e (Conhecimento de Transporte Eletrônico).

cte_desacordo

Registra desacordo do tomador (evento tipo 4 do CT-e). Prazo: 45 dias.

mdfe_emitir

Emite MDF-e agrupando vários CT-e/NF-e no mesmo transporte.

mdfe_encerrar

Encerra MDF-e autorizado (evento tipo 3). Obrigatório ao fim do transporte.

dce_emitir

Emite DC-e (Declaração de Conteúdo) para PF/MEI.

nfenercom_emitir

Emite NF-EnerCom (Nota Fiscal de Energia Comercializada).

Eventos fiscais

evento_cancelarDestructive

Cancela NF-e, NFC-e, NFS-e, CT-e, MDF-e ou DC-e. Prazo: 24h após autorização (algumas UFs mais).

evento_carta_correcao

CC-e em NF-e ou CT-e (evento tipo 2). Limite: 20 CC-e por nota.

evento_manifestar

Manifestação do destinatário (ciência, confirmação, desconhecimento, não realizada).

evento_inutilizarDestructive

Inutiliza faixa de numeração não utilizada. Não pode ser desfeito.

Consultas SEFAZ e cadastros

sefaz_statusRead

Status do serviço de autorização da SEFAZ por UF e ambiente.

cadastro_consultarRead

Consulta dados cadastrais de contribuinte na SEFAZ por CPF/CNPJ/IE e UF.

cliente_consultarRead

Pesquisa unificada de cliente/fornecedor no cadastro local. Faz fallback para BrasilAPI (Receita Federal) com CNPJ.

produto_consultarRead

Pesquisa produto no cadastro por código, NCM, GTIN/EAN ou descrição. Paginação suportada.

tributacao_consultarRead

Lista regras de tributação (CFOP + CSTs + alíquotas ICMS/PIS/COFINS/IPI/IBS/CBS).

nota_listarRead

Lista NF-e/NFC-e/NFS-e emitidas ou recebidas em um período.

imposto_calcularRead

Simula cálculo de ICMS, PIS, COFINS, IPI, ST sem emitir nota.

Cadastros

cliente_criar

Cadastra novo cliente (destinatário/fornecedor/transportadora). Recusa duplicata por CpfCnpj.

cliente_editar

Atualiza cliente existente. Exige Id; envie payload completo (campos omitidos são zerados).

produto_criar

Cadastra novo produto. NCM com 7 ou 8 dígitos (zero-pad automático); EAN/GTIN validado por DV.

produto_editar

Atualiza produto existente. Exige Id; envie payload completo.

tributacao_criar

Cadastra regra de tributação (CFOP + CSTs + alíquotas). CstIbsCbs obrigatório (Reforma Tributária).

tributacao_editar

Atualiza regra de tributação existente. Exige Id; envie payload completo.

Arquivos · Downloads

arquivo_baixarRead

XML ou PDF/DANFE de uma nota por chave de acesso. Retorna em base64.

arquivo_baixar_eventoRead

Arquivo de evento (CC-e, cancelamento, manifestação) por chave + sequencial.

arquivo_baixar_periodoReadLong

Exporta XMLs/PDFs de um período em um único ZIP base64.

fci_gerar

Gera FCI (Ficha de Conteúdo de Importação) para operações interestaduais.

nfenercom_gerar_arquivo

Gera arquivo NF-EnerCom como pré-requisito para emissão.

healthRead

Health-check da API: status, timestamp e versão.

Resources MCP

5 resources via URI `brasilnfe://`

Resources são leituras estáveis que o agente consome para tomar decisões antes de emitir.

brasilnfe://empresa/atual

Snapshot da empresa do token: razão social, CNPJ, IE, regime tributário, estado de contingência. O agente lê antes de emitir para confirmar emitente.

brasilnfe://nfe/{chave}/xml

XML autorizado pela SEFAZ de uma NF-e/NFC-e emitida pela empresa. Substitua {chave} pela chave de 44 dígitos.

brasilnfe://nfe/{chave}/danfe

DANFE em PDF para impressão ou envio ao cliente.

brasilnfe://nfe-entrada/{chave}/xml

XML de NF-e recebida (entrada). Disponível quando a empresa baixa notas dos fornecedores.

brasilnfe://evento/{chave}/{tipoArquivo}

XML (1) ou PDF (2) de evento fiscal: CC-e, cancelamento, manifestação, encerramento.

Prompts prontos

5 fluxos guiados que sua IA já sabe executar

Prompts MCP descrevem para o agente como usar as tools no contexto fiscal correto. O cliente MCP os exibe como ações de um clique no usuário final.

emitir_nfe_simples

Emitir NF-e simples

Guia o agente para emitir uma NF-e modelo 55 com um produto, calculando impostos pelo grupo tributário.

cnpjCliente* descricaoProduto* valor* ambiente naturezaOperacao

cancelar_nota

Cancelar nota fiscal

Cancela NF-e, NFC-e, CT-e, MDF-e, DC-e ou NFS-e. Valida prazo legal e tamanho da justificativa.

chave numeroNFSe justificativa*

diagnostico_emissao

Diagnóstico de emissão

Verifica se a empresa está apta a emitir agora: SEFAZ, certificado, contingência. Conclui com PRONTO ou ATENÇÃO.

relatorio_periodo

Relatório do período

Gera relatório de NF-e/NFC-e do período com totais, status e top 5 destinatários por valor.

dataInicio* dataFim* modeloDocumento

carta_correcao

Carta de Correção (CC-e)

Envia CC-e em NF-e ou CT-e autorizada. Valida o que pode e não pode ser corrigido.

chave* correcao*

Compatibilidade

Funciona com todos os clientes MCP do mercado

Transport Streamable HTTP padrão (spec 2025-11-25). Qualquer cliente que fale MCP, conecta.

Claude Desktop Anthropic

ChatGPT Apps OpenAI · MCP

Cursor Cursor AI

Windsurf Codeium

GitHub Copilot VS Code

Zed Zed Industries

JetBrains AI Junie · IDE

Continue · Cline Open source

Caminho 2 · API do Chat

A nossa IA pronta por HTTP — você monta só a interface

A API do Chat expõe o Assistente Fiscal da Brasil NFe (a nossa IA, com o cérebro fiscal pronto) por HTTP. O seu app manda mensagens em linguagem natural — “emite uma NF-e para o cliente X de R$ 1.500” — e a IA responde, executa a operação e devolve os documentos (DANFE em PDF, XML, cupom HTML). É a mesma engine do chat do painel, autenticada pelo mesmo token de empresa.

Diferente do MCP, você não constrói o agente: o modelo, o contexto fiscal e as ferramentas são nossos. Você cuida só da tela. Ideal para colocar um assistente fiscal dentro do seu SaaS, portal ou app em horas, não semanas.

Endpoint base

https://api.brasilnfe.com.br/services/AiChatApi

Mesmo token de empresa

Authorization: Bearer SEU_TOKEN — o mesmo da REST API e do MCP. CNPJ, regime e certificado são resolvidos a cada turno.

Fluxo geral

Da sessão ao documento, em 4 passos

A sessão guarda o histórico no servidor. Você não reenvia a conversa a cada mensagem — só o sessionToken.

Crie uma sessão

POST /sessions retorna um sessionToken que identifica a conversa.

Envie a mensagem

POST /sessions/{token}/messages com o texto do usuário em linguagem natural.

A IA executa

Responde em texto, chama ferramentas (emitir, consultar, baixar) e gera os artefatos.

Renderize

Mostre o DANFE (PDF), o XML ou o cupom (HTML) pelas URLs que vêm na resposta.

Endpoints

REST simples, 7 rotas

Todas exigem Authorization: Bearer SEU_TOKEN.

Método	Rota	Descrição
POST	`/sessions`	Cria uma sessão de chat. Retorna `sessionToken`.
POST	`/sessions/{token}/messages`	Envia uma mensagem. Modo JSON ou streaming (SSE).
GET	`/sessions/{token}/messages`	Histórico da conversa.
GET	`/sessions/{token}/artifacts`	Lista os artefatos gerados na sessão.
GET	`/sessions/{token}/artifacts/{messageId}/{kind}`	Baixa um artefato inline (`pdf`, `xml`, `html`).
GET	`/sessions/{token}/artifacts/{messageId}/download`	Baixa um anexo (`Content-Disposition: attachment`).
GET	`/quota`	Saldo de créditos disponível.

Resposta

JSON consolidado ou streaming em tempo real

O cabeçalho Accept decide o formato: application/json devolve tudo de uma vez; text/event-stream entrega via SSE, igual ao chat do painel.

# Accept: application/json (padrão)
{
  "reply": "Pronto! Emiti a NF-e 1234.",
  "stopReason": "end_turn",
  "toolCalls": [
    { "name": "nfe_emitir", "ok": true }
  ],
  "artifacts": [
    {
      "messageId": 88,
      "kind": "pdf",
      "url": ".../artifacts/88/pdf"
    }
  ],
  "usage": { "quotaSource": "credits" }
}
                        

# Accept: text/event-stream
event: text
data: {"delta":"Vou emitir a NF-e..."}

event: tool_call_start
data: {"callId":"c1","name":"nfe_emitir"}

event: tool_result
data: {"callId":"c1","ok":true}

event: artifact
data: {"kind":"pdf","url":"..."}

event: done
data: {"reason":"end_turn"}
                        

Evento SSE	Quando
`text`	a IA escreve a resposta
`tool_call_start`	a IA começa uma ferramenta
`tool_call_delta`	argumentos chegando
`tool_call_end`	argumentos completos
`tool_result`	a ferramenta terminou
`artifact`	um documento foi gerado
`usage`	fim do turno (cota)
`done`	turno encerrado
`error`	falha no turno
`session_changed`	sessão reiniciada por inatividade

Artefatos

Documentos prontos para renderizar

Quando a IA emite, ela gera um artefato binário com messageId, kind e uma url já pronta. Você decide como mostrar.

PDF — kind: "pdf" O DANFE pronto. Renderize num <iframe> ou ofereça download.

XML — kind: "xml" O XML autorizado pela SEFAZ. Útil para guardar ou processar.

HTML — kind: "html" O cupom da NFC-e. Embeda direto na sua tela.

Cobrança & erros

Créditos por turno, status previsíveis

Cada turno consome créditos da carteira da empresa do token (proporcional ao tamanho da resposta e às ferramentas usadas). O acesso via API usa apenas créditos comprados — não a cota grátis do painel.

HTTP	`code`	Significado
`401`	`missing_token` / `invalid_token`	Token ausente ou inválido.
`403`	`no_owner` / `session_blocked`	Empresa sem dono, ou sessão bloqueada.
`400`	`missing_message`	O campo `message` não foi enviado.
`402`	`credits_empty`	Sem créditos. Compre mais no painel.
`429`	`rate_limited`	Excedeu o rate-limit. Veja `Retry-After`.
`409`	`session_stale_empresa`	A empresa mudou; recrie a sessão.
`502`	`server_exception`	Falha temporária. Tente novamente.

Ver a demo ao vivo Referência completa da API Guia de integração

Vale para os dois caminhos

Sua IA emite com as mesmas garantias da API REST

MCP e API do Chat herdam a stack de produção da Brasil NFe: token isolado por empresa, rate-limit, auditoria por chamada e hints que pedem confirmação ao usuário em operações destrutivas.

Bearer token por empresa

Cada empresa tem token isolado. Authorization: Bearer ou header Token:. Sessões usam Mcp-Session-Id.

Rate-limit configurável

Default 60 req/min por empresa, ajustável via Mcp:RateLimit:RequestsPerMinute. Headers X-RateLimit-* em toda resposta.

Auditoria por chamada

Cada tools/call, resources/read e prompts/get registra empresa, sessão, tool, latência, sucesso e código de erro.

Hints de operações destrutivas

Tools como evento_cancelar e evento_inutilizar têm destructiveHint: true. Clientes MCP pedem confirmação obrigatória.

Homologação por padrão

Use tipoAmbiente: 2 para testes. Os prompts prontos defaultam para homologação até que o usuário troque para produção.

CORS e isolamento

CORS configurado por origem, sessões com cleanup automático, suporte a DELETE /services/Mcp para encerrar explicitamente.

FAQ

Perguntas frequentes sobre IA fiscal

Tudo que times técnicos e contábeis querem saber antes de plugar a IA na SEFAZ — pelo MCP ou pela API do Chat.

MCP é o protocolo aberto criado pela Anthropic em novembro de 2024 e adotado pela OpenAI, Google, Microsoft Copilot, Cursor, Windsurf, JetBrains e Zed em 2025. Funciona como o “USB-C dos agentes de IA”: padroniza como um modelo (Claude, ChatGPT, Gemini, Copilot) descobre e usa ferramentas externas (tools), recursos (resources) e prompts. O servidor MCP da Brasil NFe expõe 34 tools fiscais e 5 prompts prontos, permitindo que qualquer cliente compatível com MCP emita NF-e, NFC-e, NFS-e, CT-e, MDF-e e DC-e por linguagem natural.

O endpoint principal é https://api.brasilnfe.com.br/services/Mcp (transport Streamable HTTP, spec 2025-11-25). Discovery: GET /services/Mcp/info retorna nome, versão, lista de tools e sessões ativas; GET /.well-known/mcp retorna o manifesto padrão MCP. Versões de protocolo suportadas: 2025-11-25 (atual), 2025-06-18, 2025-03-26 e 2024-11-05 (negociadas no initialize).

Qualquer cliente que implemente a spec MCP funciona: Claude Desktop e Claude.ai (Anthropic), ChatGPT Apps via MCP (OpenAI), Cursor, Windsurf, Zed, JetBrains AI Assistant, GitHub Copilot (VS Code), Continue.dev, Cline, e SDKs MCP em Python, TypeScript, C#, Rust e Java. Como o transport é Streamable HTTP padrão, basta apontar o cliente para o endpoint e enviar o token de autenticação.

A autenticação é feita pelo token de empresa gerado no painel Brasil NFe, enviado em um destes dois cabeçalhos: Authorization: Bearer SEU_TOKEN ou Token: SEU_TOKEN. O token identifica a empresa emitente: o servidor automaticamente resolve CNPJ, regime tributário, certificado digital e contingência da empresa em cada chamada. Cada token é isolado e tem rate-limit próprio (60 requisições/minuto por padrão).

Sim, com as proteções certas. O servidor MCP da Brasil NFe inclui: (1) tools marcadas com destructiveHint (ex: cancelamento, inutilização) que clientes MCP exibem com confirmação obrigatória ao usuário; (2) recurso brasilnfe://empresa/atual que o agente lê antes de emitir para confirmar emitente e regime; (3) prompt diagnostico_emissao que valida SEFAZ e contingência antes de operações em massa; (4) auditoria por chamada (timestamp, request id, sessão, tool, latência, erro); (5) rate limit por empresa; (6) suporte a tipoAmbiente=2 (homologação) para testes. Para produção, recomendamos sempre revisão humana em emissões de alto valor e cancelamentos.

NF-e/NFC-e: nfe_emitir, nfe_emitir_complementar, nfe_previsualizar. NF-EnerCom: nfenercom_gerar_arquivo, nfenercom_emitir. NFS-e: nfse_emitir, nfse_consultar. CT-e: cte_emitir, cte_desacordo. MDF-e: mdfe_emitir, mdfe_encerrar. DC-e: dce_emitir. Eventos: evento_cancelar, evento_carta_correcao, evento_manifestar, evento_inutilizar. Consultas SEFAZ e cadastros: sefaz_status, cadastro_consultar, cliente_consultar, produto_consultar, tributacao_consultar, nota_listar, imposto_calcular. Cadastros: cliente_criar, cliente_editar, produto_criar, produto_editar, tributacao_criar, tributacao_editar. Arquivos: arquivo_baixar, arquivo_baixar_evento, arquivo_baixar_periodo. Auxiliares: fci_gerar, health.

Sim. O servidor MCP é a mesma camada da API REST da Brasil NFe (mesma autenticação, mesma SEFAZ, mesmos contratos). Em produção, recomendamos: usar tipoAmbiente: 2 (homologação) para todos os testes; configurar rate-limit conforme volume; ler brasilnfe://empresa/atual antes de emitir; usar o prompt diagnostico_emissao antes de operações em massa; manter o log de auditoria do MCP integrado ao seu SIEM. O claim OpenWorldHint=true nas tools que tocam SEFAZ avisa o cliente MCP que o resultado depende de sistemas externos.

O servidor MCP é gratuito e está incluído em qualquer plano ativo da API Brasil NFe (NF-e/NFC-e a partir de R$ 49,90/mês, NFS-e, CT-e, MDF-e, DC-e). Não há cobrança por chamada MCP, por sessão ou por tool. O que conta é a contratação do serviço fiscal correspondente. Em homologação (testes), o uso é totalmente gratuito e ilimitado, sem cartão de crédito.

São dois caminhos para integrar IA, e usam o mesmo token de empresa. No Servidor MCP, quem traz o modelo de IA é você (Claude, ChatGPT, Cursor, Copilot): nós expomos 34 ferramentas fiscais e você constrói o agente. Na API do Chat, quem traz a IA somos nós — o Assistente Fiscal da Brasil NFe já pronto — e você constrói só a interface (UI). Resumo: já tem uma IA e quer dar a ela as ferramentas fiscais? Use o MCP. Quer a nossa IA respondendo o seu usuário e vai montar só a tela? Use a API do Chat.

Cada turno da API do Chat consome créditos da carteira da empresa do token, proporcional ao tamanho da resposta e às ferramentas usadas. O acesso via API consome apenas créditos comprados — não usa a cota grátis mensal do plano (essa é exclusiva do chat do painel). Sem saldo, o turno é recusado com HTTP 402. Consulte o saldo a qualquer momento em GET /quota. O MCP, por outro lado, não tem cobrança por chamada: está incluso no plano fiscal.

Sim. O cabeçalho Accept decide o formato da resposta: application/json (ou ausente) devolve uma resposta única e consolidada; text/event-stream entrega via Server-Sent Events (SSE), igual ao chat do painel. No streaming você recebe eventos conforme a IA processa: text (deltas da resposta), tool_call_start/tool_result (ferramentas), artifact (documentos gerados), usage e done. Ideal para mostrar a resposta digitando em tempo real na sua interface.

Era da IA fiscal

Pronto para colocar IA na sua emissão fiscal?

Plugue a sua IA via MCP, ou use a nossa pela API do Chat. Mesmo token, mesma SEFAZ. Teste na demo ao vivo sem instalar nada — em 30 segundos sua IA fala com a SEFAZ.

Ver a demo ao vivo Ver documentação Falar com a equipe