fiscal

{
  "id": "aix_a61eb8cb35",
  "name": "fiscal",
  "operator": "(unclaimed - source: registry-official · publisher: br.com.brasilnfe)",
  "description": "Brazilian fiscal MCP server - issue NF-e, NFC-e, NFS-e, CT-e, MDF-e and DC-e via SEFAZ.",
  "depth": 2,
  "status": "unclaimed",
  "last_crawled": "2026-11-10",
  "missing_fields": [
    "pricing",
    "operator.identity"
  ],
  "skills": [
    "pdf-to-json"
  ],
  "protocols": {
    "mcp": "https://api.brasilnfe.com.br/services/Mcp",
    "a2a": null
  },
  "pricing": null,
  "regions": [
    "global"
  ],
  "languages": [
    "en"
  ],
  "reputation": {
    "tasks_completed": null,
    "dispute_rate": null,
    "p95_latency_ms": 5043,
    "uptime_30d": 0.9971098265895953,
    "onchain_volume_30d_usd": null
  },
  "aix_score": 39,
  "verification": {
    "identity": "none",
    "health": "probe/24h",
    "pricing": "unknown",
    "last_check": "2026-11-10T11:01:09.337Z"
  },
  "pricing_model": "unknown",
  "links": [
    {
      "label": "homepage",
      "url": "https://www.brasilnfe.com.br/mcp"
    },
    {
      "label": "repository",
      "url": "https://github.com/BrasilNFe/brasilnfe-mcp"
    }
  ],
  "avatar": "https://github.com/BrasilNFe.png?size=160",
  "socials": [
    {
      "label": "github",
      "url": "https://github.com/BrasilNFe"
    }
  ],
  "profile": {
    "mcp_server": "BrasilNFe MCP",
    "mcp_version": "1.0.0",
    "tool_count": 36,
    "tools": [
      {
        "name": "nfe_emitir",
        "description": "Emite uma NF-e (modelo 55) ou NFC-e (modelo 65) na SEFAZ. Use modeloDocumento=55 para NF-e (B2B com destinatário CPF/CNPJ) ou modeloDocumento=65 para NFC-e (consumidor final). Retorna chave de acesso (44 dígitos), número, protocolo, status e XML/DANFE em base64. Operação síncrona (pode levar 5-30s). Use tipoAmbiente=2 (homologação) para testes. TRANSMITE DE VERDADE: só chame depois que o usuário aprovou a pré-visualização final (nfe_previsualizar) e confirmou a emissão; envie confirmacaoUsuario=true (conexões OAuth são recusadas sem ele)."
      },
      {
        "name": "nfe_emitir_complementar",
        "description": "Emite uma NF-e complementar referenciando uma NF-e já autorizada. Usado para complementar valores, impostos ou itens (finalidade=2). Informe a chave da nota original em NFReferencia."
      },
      {
        "name": "nfe_previsualizar",
        "description": "Gera o DANFE em PDF e o XML como pré-visualização, sem enviar para a SEFAZ. Envie a nota completa em 'notaFiscal' (mesmo formato de nfe_emitir) com TipoEnvio=1 e TipoArquivo=2 (PDF + XML juntos). O resultado abre num painel ao lado da conversa: chame de novo a cada alteração pedida pelo usuário (CFOP, itens, destinatário, valores) para o painel refletir a nota atual. Erros de validação voltam em 'Error'/'Avisos'."
      },
      {
        "name": "nfcom_emitir",
        "description": "Emite a NFCom (modelo 62, Nota Fiscal Fatura de Serviço de Comunicação Eletrônica) de provedor de internet, TV por assinatura ou telefonia: assinante, itens com cClass e fatura. Requer serviço NFCom habilitado e a empresa credenciada na SEFAZ. Cancelamento por evento_cancelar com a chave."
      },
      {
        "name": "nfse_emitir",
        "description": "Emite NFS-e (Nota Fiscal de Serviços Eletrônica). Cada município brasileiro tem regras e webservices próprios - confira o município emissor antes. Pode usar Portal Nacional NFS-e ou prefeitura específica conforme cadastro da empresa."
      },
      {
        "name": "nfse_consultar",
        "description": "Consulta status e dados de uma NFS-e já enviada por número, série e ambiente."
      },
      {
        "name": "cte_emitir",
        "description": "Emite CT-e (Conhecimento de Transporte Eletrônico). Requer serviço CT-e habilitado no cadastro da empresa e certificado digital A1 ou A3 configurado."
      },
      {
        "name": "cte_desacordo",
        "description": "Registra desacordo do tomador com um CT-e recebido (evento tipo 4 do CT-e). Prazo: 45 dias da emissão."
      },
      {
        "name": "mdfe_emitir",
        "description": "Emite MDF-e (Manifesto Eletrônico de Documentos Fiscais), agrupando vários CT-e/NF-e em um único transporte. Obrigatório para transportadores com vários DFs no mesmo veículo."
      },
      {
        "name": "mdfe_encerrar",
        "description": "Encerra um MDF-e já autorizado (evento tipo 3). Obrigatório ao final de cada transporte. Sem encerramento, novos MDF-e podem ser bloqueados pela SEFAZ."
      },
      {
        "name": "dce_emitir",
        "description": "Emite DC-e (Declaração de Conteúdo Eletrônica) para transporte de itens não-fiscais por pessoa física ou MEI. Requer serviço DC-e habilitado no cadastro."
      },
      {
        "name": "gnre_emitir",
        "description": "Gera a GNRE (guia de ICMS para outra UF, ex.: DIFAL ou ICMS-ST de uma NF-e) no Portal GNRE. O portal processa em segundo plano: o retorno vem com status 3 e o resultado sai em gnre_consultar. Consulte gnre_configuracao antes para saber os campos que a UF exige. Requer serviço GNRE habilitado no cadastro."
      },
      {
        "name": "gnre_consultar",
        "description": "Consulta uma GNRE pelo Id ou pelo identificador interno: situação, linha digitável, PIX copia e cola e o PDF oficial em base64."
      },
      {
        "name": "gnre_configuracao",
        "description": "Lista as receitas que a UF aceita na GNRE e os campos que cada uma exige (documento de origem, referência, valores, campos adicionais)."
      },
      {
        "name": "evento_cancelar",
        "description": "Cancela um documento fiscal autorizado (NF-e, NFC-e, NFS-e, CT-e, MDF-e, DC-e, NFCom). Informe a chave de 44 dígitos e a justificativa (mínimo 15 caracteres). Para NFS-e use TipoDocumento=1 e informe NumeroNFSe ao invés de chave. Prazo SEFAZ NF-e: 24h após autorização (algumas UFs mais). NFCom: até 120h após o último dia do mês da autorização."
      },
      {
        "name": "evento_carta_correcao",
        "description": "Envia Carta de Correção (CC-e) para uma NF-e ou CT-e já autorizada (evento tipo 2). Não pode corrigir: valores, datas de emissão/saída, partes envolvidas (CNPJ/CPF), regimes tributários ou número/série do documento. Limite: 20 CC-e por NF-e."
      },
      {
        "name": "evento_manifestar",
        "description": "Registra a manifestação do destinatário sobre uma NF-e. TipoManifestacao: 1=confirmação da operação, 2=ciência da operação, 3=desconhecimento, 4=operação não realizada (exige Justificativa com 15+ caracteres)."
      },
      {
        "name": "evento_inutilizar",
        "description": "Inutiliza uma faixa de numeração não utilizada na SEFAZ. Útil quando há quebra de sequência por erro de emissão. Não pode ser desfeito. Operação rara - confirme com o usuário antes."
      },
      {
        "name": "sefaz_status",
        "description": "Consulta o status do serviço de autorização da SEFAZ para uma UF e ambiente. Use antes de uma emissão em lote ou quando suspeitar de instabilidade."
      },
      {
        "name": "cadastro_consultar",
        "description": "Consulta a Inscrição Estadual (IE) de um contribuinte na SEFAZ estadual (mundo NF-e/ICMS), por CNPJ/CPF/IE + UF. ATENÇÃO: muitas UFs NÃO oferecem este serviço (ex: RJ) e prestadores de serviço normalmente NÃO têm IE - nesses casos a IE não vem, e ISSO NÃO SIGNIFICA QUE O CNPJ ESTEJA INATIVO. Quando a SEFAZ não retorna e o documento é CNPJ, há fallback automático na Receita Federal (campo 'fonte'='receita') trazendo razão social, situação cadastral e endereço - sempre leia o campo 'mensagem'. Para apenas saber se um CNPJ está ativo ou pegar seus dados cadastrais (sem precisar da IE), prefira cl"
      },
      {
        "name": "cliente_consultar",
        "description": "Pesquisa unificada de cliente/fornecedor. Tenta primeiro o cadastro local da empresa logada e, se nao achar e o termo for um CNPJ valido, consulta a BrasilAPI (Receita Federal) - razao social, endereco, situacao cadastral. E a tool CORRETA pra saber se um CNPJ esta ativo e pegar seus dados (razao social, endereco) - nao confunda com cadastro_consultar, que so traz Inscricao Estadual (IE) da SEFAZ. Use ANTES de pedir CNPJ ao usuario; geralmente o usuario informa nome ou apelido (ex: 'TNT', 'Correios'). Obs: consulta na Receita so funciona por CNPJ - CPF nao tem base publica. Para obter a Inscri"
      },
      {
        "name": "cliente_criar",
        "description": "Cadastra um novo Cliente no sistema da empresa logada (CNPJ ou CPF, razao social, endereco, IE). Use depois de cliente_consultar quando o usuario confirmar que quer salvar o cadastro. Se ja existir cliente com mesmo CpfCnpj devolve erro com Id existente - use cliente_editar."
      },
      {
        "name": "cliente_editar",
        "description": "Atualiza dados de um Cliente existente no cadastro. O campo Id e obrigatorio. ATENCAO: envie o payload COMPLETO - campos omitidos sao zerados, nao preservados. Para edicao parcial, faca cliente_consultar primeiro e mande os dados existentes mais o que muda. Valida ownership por UserCreate (cliente tem que pertencer ao usuario logado) e por empresa (IdEmpresa tem que ser a logada, 0 ou null - se for outra empresa sua, troque antes)."
      },
      {
        "name": "produto_consultar",
        "description": "Pesquisa produto no cadastro da empresa logada. Aceita codigo interno, NCM (8 digitos), GTIN/EAN (8/12/13/14 digitos) ou descricao parcial. Use ANTES de criar produtos novos para evitar duplicatas. PAGINACAO: Limite default 20 (max 50). Use Offset pra ir alem - o retorno traz TotalGeral. Se TotalGeral > matches retornados, peça mais paginas em vez de inventar/agrupar."
      },
      {
        "name": "produto_criar",
        "description": "Cadastra um novo Produto na empresa logada. Validacao de duplicata por Codigo. NCM aceito com 7 ou 8 digitos (zero-pad automatico). EAN/GTIN validado por digito verificador."
      }
    ],
    "profiled_at": "2026-11-10T11:01:09.337Z"
  },
  "unreachable": false
}