---
title: "Livro de receitas"
description: "Prompts prontos por tarefa para usar o MCP da NFE.io no dia a dia - validar cadastros, decodificar chave de NFe, CNAE, correção pela Selic/IPCA, PTAX e mais."
source_url: https://nfe.io/docs/mcp/comecar/receitas
last_updated: 2026-08-24
---

# Livro de receitas

Esta página é para **usar**, não para programar. Cada receita mostra a **intenção**, um **prompt** que você digita no seu assistente e **o que volta**. Você fala como falaria com um colega - o agente escolhe a ferramenta certa.

:::warning Validar ≠ Consultar
*Validar* um CPF/CNPJ é **offline e grátis**: confere só o **dígito verificador** (se o número é matematicamente possível) - **não** diz se está ativo na Receita. *Consultar* traz o dado real (razão social, situação cadastral) e **exige a [Chave de Consulta](/mcp/comecar/adicionar-chave)**.
:::

## Nível 0 - sem chave, sem custo

As 13 ferramentas gratuitas cobrem quase todo o dia a dia contábil.

### 🧾 Validar cadastro antes de lançar

| Você digita | Volta |
|---|---|
| *"Esse CPF é válido? 123.456.789-09"* | válido/inválido + motivo |
| *"Confere esse CNPJ: 11.222.333/0001-81"* | válido/inválido |
| *"O CNPJ alfanumérico 12ABC34501DE35 é válido?"* | válido - suporta o **novo CNPJ alfanumérico** |

:::tip Em lote
Cole uma coluna inteira de CPFs/CNPJs da sua planilha e peça para validar todos. O agente itera e devolve o motivo linha a linha.
:::

### 🔑 Decodificar a chave de acesso de uma nota

| Você digita | Volta |
|---|---|
| *"De que dia, UF e empresa é a chave 35240514200166000187550010000000123456789012?"* | UF, mês/ano, CNPJ do emitente, modelo, série, número |

### 🏢 Encontrar e conferir CNAE

| Você digita | Volta |
|---|---|
| *"Qual CNAE serve para 'desenvolvimento de software sob encomenda'?"* | candidatos por busca textual |
| *"O que é o CNAE 6201-5/01?"* | descrição + hierarquia |

### 📍 Código IBGE de município e UF

| Você digita | Observação |
|---|---|
| *"Qual o código IBGE de Campinas, SP?"* | informe a UF - a lista nacional é grande demais |
| *"Me dá o código e a região do estado de MG"* | id, nome e região |

### 📊 Classificar tributação e ICMS

| Você digita | Volta |
|---|---|
| *"O que significa o CST 060 de ICMS?"* | descrição oficial + norma |
| *"No Simples Nacional, o que é o CSOSN 500?"* | roteia sozinho para a tabela certa |
| *"Qual a alíquota de ICMS numa venda de SP para a Bahia?"* | 7% ou 12% (regra interestadual) |

:::note Só interestadual
A alíquota de ICMS aqui é a **interestadual** (regra 7%/12%). Alíquota **interna** da UF e DIFAL estão fora do escopo.
:::

### 💰 Correção monetária

| Você digita | Volta |
|---|---|
| *"Corrige R$ 10.000,00 de 15/01/2020 até hoje pela Selic"* | valor corrigido + fator acumulado |
| *"Atualiza R$ 3.500 de março/2023 a dezembro/2023 pelo IPCA"* | valor + fator + série usada |
| *"Qual o IPCA acumulado de 2023?"* | a série do período |

:::note
É um fator de **atualização** monetária - não inclui multa nem demais encargos de débitos federais.
:::

### 💵 Câmbio PTAX

| Você digita | Observação |
|---|---|
| *"Qual foi a PTAX do dólar em 15/03/2024?"* | se cair em fim de semana/feriado, o agente avisa para verificar dia útil |

## Nível 1 - com a Chave de Consulta

| Intenção | Você digita |
|---|---|
| Dado real da Receita por CNPJ | *"Puxa a razão social, situação e atividade do CNPJ 11.222.333/0001-81"* |
| Endereço por CEP | *"Que endereço é o CEP 01310-100?"* |

## Nível 2 - com a Chave de Dados

### ✅ Consultar (seguro, do dia a dia)

| Você digita |
|---|
| *"Lista minhas NFS-e emitidas em junho"* |
| *"Qual o status da nota tal?"* |
| *"Quais empresas eu tenho cadastradas?"* |

### ⚠️ Emitir e criar (destrutivo)

| Você digita | Cuidado |
|---|---|
| *"Emite uma NFS-e de R$ 500 de consultoria para o cliente Y"* | use o **modo de teste** primeiro e confirme antes de valer |
| *"Cria uma empresa emissora com esse CNPJ"* | não deduplica por CNPJ - pode criar duplicata |

:::warning O certificado nunca passa pelo chat
Emitir usa o **certificado digital que fica no dashboard da NFE.io** - ele nunca é enviado pelo assistente. Veja **[Segurança](/mcp/referencia/seguranca)**.
:::

## Receitas combinadas

O ganho de um agente é **encadear** ferramentas numa frase só:

- *"Valida esse CNPJ, me diz o CNAE principal e em que município/UF ele fica."*
- *"Recebi essa chave de NFe - decodifica e me diz de que empresa é."*
- *"Corrige esses 5 débitos da planilha pela Selic até hoje."*

## O que ele **não** faz

- Situação cadastral ou dívida ativa **sem** a Chave de Consulta (validar é só dígito verificador).
- Alíquota **interna** de ICMS ou DIFAL (só interestadual).
- NCM / CEST / CFOP ainda não têm ferramenta.
- Emitir sem a empresa credenciada na prefeitura e com certificado no dashboard.