NFE.io

Issue NFS-e (Brazilian service invoice)

[Requer chave de API NFE.io] Issue a Brazilian Electronic Service Invoice (NFS-e) for a company registered in NFE.io. By default this tool waits (polls) until the municipality returns a terminal state — "Issued" (success) or "IssueFailed" (rejected). Set waitForCompletion=false to return immediately after submission (you can then poll with nfeio_get_invoice_status). Contract notes: - Federal tax number (CPF or CNPJ) must be passed as a NUMBER, not a string. - cityServiceCode is defined by

List NFS-e service invoices

[Requer chave de API NFE.io] List NFS-e (Nota Fiscal de Servico Eletronica) invoices for a company, with optional date filters and offset pagination. Use when: - The user asks to list, count, or browse service invoices for a specific company. - You need invoice IDs to then retrieve details, cancel, or download PDFs/XMLs. Do NOT use when: - The user wants NF-e (product) invoices — those use a different endpoint not exposed here. Args: - companyId (string, required): NFE.io company UUID

Get NFS-e processing status

[Requer chave de API NFE.io] Check the processing status of a specific NFS-e (service invoice). Use when: - A previous issue_service_invoice call timed out or returned async; you need to know whether the invoice was ultimately issued, failed, or is still processing. - The user asks "what's the status of invoice X". Do NOT use when: - You only need invoice business data (use list_service_invoices or a dedicated retrieve tool instead). Args: - companyId (string, required): company UUID.

List NFE.io companies (issuers)

[Requer chave de API NFE.io] List the companies (issuers / tenants) registered on your NFE.io account, with offset pagination. This is the discovery path for companyId: the other fiscal tools (issue/list/status) need a companyId, and this tool is how you find it without leaving the MCP client. Once you know which company you want, either pass its id explicitly or set it as the session default (NFE_COMPANY_ID / X-NFE-Company-Id). Use when: - The user asks "which companies do I have", "list my

Get NFE.io company detail

[Requer chave de API NFE.io] Retrieve the full detail of one company (issuer) registered on your NFE.io account via companies.retrieve. Returns the fields an agent typically needs before issuing an invoice: tax regime, municipal registration (inscrição municipal / CCM), state registration (IE), issuance environment (Production vs Test), and ISS rate for Simples Nacional. The payload is returned as the API sends it — the SDK's Company type is intentionally open-ended, so treat any field beyond t

Create NFE.io company (issuer)

[Requer chave de API NFE.io] Create a new company (issuer/emitente) on your NFE.io account via companies.create. Creates the company "shell": its registration data, tax regime and address. The company is created but does NOT issue any fiscal document until a digital certificate (A1/.pfx) is uploaded — and certificate upload is intentionally NOT exposed as a tool (the .pfx file and its password must never travel through the LLM context). The certificate step is done in the NFE.io dashboard (http

Lookup Brazilian CNPJ

[Requer chave de API NFE.io] Lookup Brazilian company data by CNPJ (Cadastro Nacional da Pessoa Juridica) via the NFE.io data service. Returns official Receita Federal information: legal name (razao social), trade name (nome fantasia), registration status (Active/Suspended/Cancelled/Unabled/Null), size (ME/EPP/DEMAIS), legal nature, opening date, share capital, address, phones, e-mail and economic activities (CNAE). The partner list (QSA) is returned only when includePartners=true. Use when:

Lookup Brazilian address by CEP

[Requer chave de API NFE.io] Lookup a Brazilian postal address by CEP (Codigo de Enderecamento Postal). Returns street name, district (bairro), city name, city IBGE code, state (UF), and country. Useful to autofill an invoice borrower's address or validate a CEP supplied by a user. Use when: - The user asks to look up an address, CEP, or ZIP code in Brazil. - You need city.code (IBGE) to fill a NFS-e borrower address. Do NOT use when: - You need a free-text address search — the NFE.io A

Validate Brazilian CPF (offline)

[Gratuito — sem chave] Validate a Brazilian CPF by its check digits (mod-11), fully offline — no network, no NFE.io API key. This is ARITHMETIC validation, NOT an existence/registration check. `valido: true` means only that the two check digits are mathematically correct — the CPF may not exist at the Receita Federal. There is NO public source to confirm CPF existence, so this local check is the only verification possible for CPF. Use when: - You need to reject a malformed CPF before saving

Validate Brazilian CNPJ (offline, numeric + alphanumeric)

[Gratuito — sem chave] Validate a Brazilian CNPJ by its check digits (mod-11), fully offline — no network, no NFE.io API key. Supports BOTH the classic numeric CNPJ and the new alphanumeric CNPJ (IN RFB 2.229/2024). This is ARITHMETIC validation, NOT an existence/registration check. `valido: true` means only that the two check digits are mathematically correct — the CNPJ may not exist at the Receita Federal. Use when: - You need to reject a malformed CNPJ before saving, building an invoice p

Validate & decode NFe access key (offline)

[Gratuito — sem chave] Validate the check digit (cDV) of a Brazilian NFe/NFC-e access key by mod-11 (NT 2011.002) AND decode its positional layout, fully offline — no network, no NFE.io API key. This is ARITHMETIC + STRUCTURAL validation, NOT a SEFAZ query. `valido: true` means only that the 44th digit matches mod-11 — it does NOT mean the invoice exists, was authorized, or is not cancelled. The decoded fields (modelo, série, tpEmis, ...) are positional and informative; they do not imply an aut

List IBGE municipalities of a state (offline of billing)

[Gratuito — sem chave] Lista os municípios de uma UF (nome + código IBGE de 7 dígitos), via a API pública de Localidades do IBGE. Sem chave, sem custo de lookup. Use when: - O usuário quer os municípios de um estado, ou você precisa resolver nome → código IBGE para preencher/validar uma cidade (ex.: "emitir para Campinas-SP" precisa do código 3509502). Do NOT use when: - Você já tem o código IBGE (não há o que resolver). - Você quer dados cadastrais/fiscais de uma EMPRESA — use nfeio_loo

Get IBGE state (UF) by sigla

[Gratuito — sem chave] Retorna os dados de uma UF (código IBGE, nome por extenso e região) a partir da sigla, via a API pública de Localidades do IBGE. Sem chave, sem custo. Use when: - O usuário quer o código IBGE da UF, o nome por extenso ou a região de uma sigla. Do NOT use when: - Você quer a lista de municípios — use nfeio_consultar_municipios. - Você quer dados de uma empresa — use nfeio_lookup_cnpj (lookup pago). Args: - uf (string, obrigatório): sigla da UF (allowlist das 27).

Get CNAE subclass description by code

[Gratuito — sem chave] Retorna a descrição oficial de uma subclasse CNAE 2.0 (7 dígitos) e sua hierarquia (classe/grupo/divisão/seção), via a API pública de CNAE do IBGE. Sem chave, sem custo. Use when: - Você tem um código CNAE e quer a descrição oficial, ou quer validar se um código de 7 dígitos existe. Do NOT use when: - Você descreve a atividade por texto e quer descobrir o código — use nfeio_buscar_cnae. - Você quer os CNAEs de uma EMPRESA — use nfeio_lookup_cnpj (o lookup pago já o

Search CNAE subclasses by text

[Gratuito — sem chave] Descobre subclasses CNAE 2.0 por texto (ex.: "software" → desenvolvimento de programas de computador), via a API pública de CNAE do IBGE. Sem chave, sem custo. A busca é feita LOCALMENTE sobre a descrição e as atividades de cada subclasse (o parâmetro de busca do IBGE não filtra), então "software" também encontra CNAEs cuja descrição não contém a palavra mas cujas atividades sim. Use when: - O usuário descreve uma atividade e quer descobrir o(s) CNAE(s) correspondente(

Selic daily rate series (SGS 11)

[Gratuito — sem chave] Retorna a série da taxa Selic diária (% ao dia, SGS id=11) do Banco Central para um período, via a API pública do SGS. Sem chave, sem custo. Use when: - O usuário pede a taxa Selic diária de um período, ou precisa da série para auditar/cruzar com cálculo de juros. Do NOT use when: - O usuário quer CORRIGIR um valor monetário pela Selic — use nfeio_corrigir_valor (que já faz o produtório do fator). - O usuário quer a variação do IPCA — use nfeio_indexador_ipca. Arg

IPCA monthly variation series (SGS 433)

[Gratuito — sem chave] Retorna a série do IPCA (variação % mensal, SGS id=433) do Banco Central para um período, via a API pública do SGS. Sem chave, sem custo. Use when: - O usuário pede a série mensal do IPCA de um período, ou quer inspecionar a variação mês a mês. Do NOT use when: - O objetivo é CORRIGIR um valor pelo IPCA acumulado — use nfeio_corrigir_valor. - O usuário quer a taxa Selic — use nfeio_indexador_selic. Args: - dataInicial (string, obrigatório): dd/MM/yyyy. - dataF

Monetary correction by Selic/IPCA (compound factor)

[Gratuito — sem chave] Corrige (atualiza) um valor monetário entre duas datas pela Selic ou pelo IPCA, usando as séries públicas do SGS/Banco Central. Aplica o fator ACUMULADO (produtório de (1 + variação/100) sobre todas as observações do período), não a soma dos percentuais. Sem chave, sem custo. Este é um fator de ATUALIZAÇÃO monetária, não uma previsão. Para débitos federais a Receita ainda aplica multa e outros encargos, que esta ferramenta NÃO calcula. Use when: - O usuário quer atuali

PTAX exchange rate by date and currency

[Gratuito — sem chave] Retorna a cotação oficial PTAX (compra e venda) de uma moeda estrangeira numa data, via o serviço público Olinda/OData do Banco Central. Sem chave, sem custo. Use when: - O usuário precisa da taxa de câmbio oficial PTAX de uma data (conversão de operação internacional, fechamento de câmbio, valor em reais de fatura em moeda estrangeira). Do NOT use when: - O usuário quer cotação comercial em tempo real ou intraday — PTAX é o fechamento oficial do BCB, não cotação de

Validate CST / CSOSN / PIS-COFINS / IPI code (offline)

[Gratuito — sem chave] Valida e descreve um código CST/CSOSN (ICMS), CST PIS/COFINS ou CST IPI, 100% offline — sem rede, sem chave. Roteia automaticamente pela combinação regime + tributo e devolve o veredito + a descrição oficial. Roteamento: - tributo=icms + regime=simples → CSOSN (3 dígitos) - tributo=icms + regime=normal → CST ICMS (3 dígitos = origem [1] + tributação [2], decompostos na resposta) - tributo=pis ou cofins → CST PIS/COFINS (2 dígitos; mesma tabela para os dois) - trib

Interstate ICMS aliquot by UF pair (offline)

[Gratuito — sem chave] Retorna a alíquota INTERESTADUAL padrão de ICMS entre duas UFs pela regra da Resolução do Senado Federal nº 22/1989 (7% ou 12%), 100% offline. Escopo deliberadamente limitado ao interestadual. Regra: 7% quando a origem é Sul/Sudeste (exceto ES) e o destino é Norte/Nordeste/Centro-Oeste ou ES; 12% nos demais casos interestaduais. Operação intraestadual (origem = destino) devolve operacao 'intraestadual' e aliquota_interestadual null. Use when: - Estimar a alíquota inter