FiscalAPI
IE (27 UFs), CNPJ, certidões e cópia para leitura do XML de NF-e pela chave, do Brasil.
Sollte ich dies verwenden
Qualität und Sicherheit
Befunde (3)
- HIGH
- LOWin saldo
- INFOin consultar_ie_todos_estados
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"fiscalapi-mcp": {
"url": "https://mcp.fiscalapi.com.br/mcp"
}
}
}Remote-Endpunkte
https://mcp.fiscalapi.com.br/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (13)
🟢validar_inscricao_estadual(uf, ie)
Confere o formato e o dígito verificador de uma Inscrição Estadual na UF informada. Não precisa de chave e não cobra. Não diz se a IE existe, está ativa ou a quem pertence: isso só a consulta real (consultar_ie) responde. Devolve valida, motivo da recusa, a IE formatada e quantos zeros à esquerda foram completados.
Eingabe-Schema
{
"type": "object",
"properties": {
"uf": {
"description": "Sigla da UF da inscrição, ex.: MT.",
"enum": [
"AC",
"AL",
"AM",
"AP",
"BA",
"CE",
"DF",
"ES",
"GO",
"MA",
"MG",
"MS",
"MT",
"PA",
"PB",
"PE",
"PI",
"PR",
"RJ",
"RN",
"RO",
"RR",
"RS",
"SC",
"SE",
"SP",
"TO"
],
"title": "Uf",
"type": "string"
},
"ie": {
"description": "Número da IE, com ou sem pontuação.",
"maxLength": 30,
"title": "Ie",
"type": "string"
}
},
"required": [
"uf",
"ie"
],
"title": "validar_inscricao_estadualArguments"
}Ausgabe-Schema
{
"type": "object",
"additionalProperties": true,
"title": "validar_inscricao_estadualDictOutput"
}🟢cobertura
Resumo do que a FiscalAPI consulta por produto e UF, o que cada ferramenta devolve e os limites da API. Não precisa de chave e não cobra.
Eingabe-Schema
{
"type": "object",
"properties": {},
"title": "coberturaArguments"
}Ausgabe-Schema
{
"type": "object",
"additionalProperties": true,
"title": "coberturaDictOutput"
}⚪consultar_ie(uf, cpf, cnpj, ie, secundarias, ...)
Consulta a Inscrição Estadual na UF informada, por CPF, CNPJ ou IE (um só). Devolve os dados cadastrais de cada inscrição: número, razão social, situação, tipo, endereço, CNAE, regime e datas. Por CPF não funciona em SP (lá, use CNPJ ou IE). Custo por consulta, descontado do saldo em créditos (1 crédito = R$ 1): Starter R$ 0,10 (R$ 0,12 com créditos extras); Pro R$ 0,065 (R$ 0,085); Enterprise R$ 0,025 (R$ 0,035). Erro não é cobrado. Resposta sem inscrição encontrada, sem_certidao ou nao_contribuinte conta como consulta. Exige plano ou créditos extras: as 10 consultas grátis do mês são só no painel, não valem pelo MCP.
Eingabe-Schema
{
"type": "object",
"properties": {
"uf": {
"description": "Sigla da UF, ex.: MT.",
"enum": [
"AC",
"AL",
"AM",
"AP",
"BA",
"CE",
"DF",
"ES",
"GO",
"MA",
"MG",
"MS",
"MT",
"PA",
"PB",
"PE",
"PI",
"PR",
"RJ",
"RN",
"RO",
"RR",
"RS",
"SC",
"SE",
"SP",
"TO"
],
"title": "Uf",
"type": "string"
},
"cpf": {
"anyOf": [
{
"maxLength": 20,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "CPF, com ou sem pontuação (informe só um documento).",
"title": "Cpf"
},
"cnpj": {
"anyOf": [
{
"maxLength": 24,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "CNPJ, com ou sem pontuação (informe só um documento).",
"title": "Cnpj"
},
"ie": {
"anyOf": [
{
"maxLength": 24,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Número da Inscrição Estadual (informe só um documento).",
"title": "Ie"
},
"secundarias": {
"default": false,
"description": "Busca também as atividades secundárias de cada inscrição. Pode somar de alguns a dezenas de segundos, conforme o estado.",
"title": "Secundarias",
"type": "boolean"
},
"confirmo_custo": {
"default": false,
"description": "Obrigatório para executar: true só depois que o usuário aceitou o custo descrito na ferramenta. Sem isso a ferramenta só explica o custo e não consulta nada.",
"title": "Confirmo Custo",
"type": "boolean"
}
},
"required": [
"uf"
],
"title": "consultar_ieArguments"
}Ausgabe-Schema
{
"type": "object",
"additionalProperties": true,
"title": "consultar_ieDictOutput"
}⚪consultar_ie_todos_estados(cpf, cnpj, ie, secundarias, confirmo_custo)
Procura inscrições estaduais nos 27 estados numa chamada, por CPF, CNPJ ou IE (um só), sem informar a UF. Devolve, por UF, as inscrições encontradas e o campo complete (false = algum estado não respondeu, então ausência não prova que não existe inscrição). Conta como 1 consulta. Custo por consulta, descontado do saldo em créditos (1 crédito = R$ 1): Starter R$ 0,10 (R$ 0,12 com créditos extras); Pro R$ 0,065 (R$ 0,085); Enterprise R$ 0,025 (R$ 0,035). Erro não é cobrado. Resposta sem inscrição encontrada, sem_certidao ou nao_contribuinte conta como consulta. Exige plano ou créditos extras.
Eingabe-Schema
{
"type": "object",
"properties": {
"cpf": {
"anyOf": [
{
"maxLength": 20,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "CPF, com ou sem pontuação (informe só um documento).",
"title": "Cpf"
},
"cnpj": {
"anyOf": [
{
"maxLength": 24,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "CNPJ, com ou sem pontuação (informe só um documento).",
"title": "Cnpj"
},
"ie": {
"anyOf": [
{
"maxLength": 24,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Número da Inscrição Estadual (informe só um documento).",
"title": "Ie"
},
"secundarias": {
"default": false,
"description": "Busca também as atividades secundárias de cada inscrição. Pode somar de alguns a dezenas de segundos, conforme o estado.",
"title": "Secundarias",
"type": "boolean"
},
"confirmo_custo": {
"default": false,
"description": "Obrigatório para executar: true só depois que o usuário aceitou o custo descrito na ferramenta. Sem isso a ferramenta só explica o custo e não consulta nada.",
"title": "Confirmo Custo",
"type": "boolean"
}
},
"title": "consultar_ie_todos_estadosArguments"
}Ausgabe-Schema
{
"type": "object",
"additionalProperties": true,
"title": "consultar_ie_todos_estadosDictOutput"
}⚪consultar_cnpj(cnpj, ao_vivo, confirmo_custo)
Consulta o cadastro público de um CNPJ na Receita Federal: razão social, situação cadastral, abertura, CNAE, endereço, telefones, e-mail, quadro societário e opção pelo Simples e pelo MEI (base mensal da Receita Federal). Com ao_vivo=true consulta a Receita Federal na hora (mais lento; Simples e MEI voltam vazios). Custo por consulta, descontado do saldo em créditos (1 crédito = R$ 1): Starter R$ 0,10 (R$ 0,12 com créditos extras); Pro R$ 0,065 (R$ 0,085); Enterprise R$ 0,025 (R$ 0,035); com ao_vivo=true, Starter R$ 0,30 (R$ 0,36 com créditos extras); Pro R$ 0,195 (R$ 0,255); Enterprise R$ 0,075 (R$ 0,105). Erro não é cobrado. Resposta sem inscrição encontrada, sem_certidao ou nao_contribuinte conta como consulta. Exige plano ou créditos extras: as 10 consultas grátis do mês são só no painel, não valem pelo MCP.
Eingabe-Schema
{
"type": "object",
"properties": {
"cnpj": {
"description": "CNPJ, com ou sem pontuação.",
"maxLength": 24,
"title": "Cnpj",
"type": "string"
},
"ao_vivo": {
"default": false,
"description": "Consulta a Receita Federal na hora, ignorando o cache. Tem preço próprio (ver Custo).",
"title": "Ao Vivo",
"type": "boolean"
},
"confirmo_custo": {
"default": false,
"description": "Obrigatório para executar: true só depois que o usuário aceitou o custo descrito na ferramenta. Sem isso a ferramenta só explica o custo e não consulta nada.",
"title": "Confirmo Custo",
"type": "boolean"
}
},
"required": [
"cnpj"
],
"title": "consultar_cnpjArguments"
}Ausgabe-Schema
{
"type": "object",
"additionalProperties": true,
"title": "consultar_cnpjDictOutput"
}⚪consultar_cnd_estadual(uf, cpf, cnpj, confirmo_custo)
Consulta a Certidão Negativa de Débitos estadual (ICMS) de um CPF ou CNPJ (um só) na UF informada. Devolve o status (negativa, positiva, positiva_com_efeitos_de_negativa, nao_contribuinte, sem_certidao ou erro), emissão, validade e protocolo. O PDF não vem pelo MCP. Custo por consulta, descontado do saldo em créditos (1 crédito = R$ 1): Starter R$ 0,10 (R$ 0,12 com créditos extras); Pro R$ 0,065 (R$ 0,085); Enterprise R$ 0,025 (R$ 0,035). Erro não é cobrado. Resposta sem inscrição encontrada, sem_certidao ou nao_contribuinte conta como consulta. Exige plano ou créditos extras: as 10 consultas grátis do mês são só no painel, não valem pelo MCP.
Eingabe-Schema
{
"type": "object",
"properties": {
"uf": {
"description": "Sigla da UF, ex.: MT.",
"enum": [
"AC",
"AL",
"AM",
"AP",
"BA",
"CE",
"DF",
"ES",
"GO",
"MA",
"MG",
"MS",
"MT",
"PA",
"PB",
"PE",
"PI",
"PR",
"RJ",
"RN",
"RO",
"RR",
"RS",
"SC",
"SE",
"SP",
"TO"
],
"title": "Uf",
"type": "string"
},
"cpf": {
"anyOf": [
{
"maxLength": 20,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "CPF, com ou sem pontuação (informe só um documento).",
"title": "Cpf"
},
"cnpj": {
"anyOf": [
{
"maxLength": 24,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "CNPJ, com ou sem pontuação (informe só um documento).",
"title": "Cnpj"
},
"confirmo_custo": {
"default": false,
"description": "Obrigatório para executar: true só depois que o usuário aceitou o custo descrito na ferramenta. Sem isso a ferramenta só explica o custo e não consulta nada.",
"title": "Confirmo Custo",
"type": "boolean"
}
},
"required": [
"uf"
],
"title": "consultar_cnd_estadualArguments"
}Ausgabe-Schema
{
"type": "object",
"additionalProperties": true,
"title": "consultar_cnd_estadualDictOutput"
}⚪consultar_cndt(cpf, cnpj, confirmo_custo)
Consulta a Certidão Negativa de Débitos Trabalhistas (TST) de um CPF ou CNPJ (um só). Devolve status, emissão, validade e protocolo. O PDF não vem pelo MCP. Custo por consulta, descontado do saldo em créditos (1 crédito = R$ 1): Starter R$ 0,10 (R$ 0,12 com créditos extras); Pro R$ 0,065 (R$ 0,085); Enterprise R$ 0,025 (R$ 0,035). Erro não é cobrado. Resposta sem inscrição encontrada, sem_certidao ou nao_contribuinte conta como consulta. Exige plano ou créditos extras: as 10 consultas grátis do mês são só no painel, não valem pelo MCP.
Eingabe-Schema
{
"type": "object",
"properties": {
"cpf": {
"anyOf": [
{
"maxLength": 20,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "CPF, com ou sem pontuação (informe só um documento).",
"title": "Cpf"
},
"cnpj": {
"anyOf": [
{
"maxLength": 24,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "CNPJ, com ou sem pontuação (informe só um documento).",
"title": "Cnpj"
},
"confirmo_custo": {
"default": false,
"description": "Obrigatório para executar: true só depois que o usuário aceitou o custo descrito na ferramenta. Sem isso a ferramenta só explica o custo e não consulta nada.",
"title": "Confirmo Custo",
"type": "boolean"
}
},
"title": "consultar_cndtArguments"
}Ausgabe-Schema
{
"type": "object",
"additionalProperties": true,
"title": "consultar_cndtDictOutput"
}⚪consultar_cnd_federal(cpf, cnpj, emitir_nova, confirmo_custo)
Consulta a certidão de débitos de tributos federais e Dívida Ativa da União (Receita Federal e PGFN) de um CPF ou CNPJ (um só). Se já existe certidão que vale por mais de 3 dias, devolve essa (modo=consulta); senão, emite uma nova (modo=emissao). Com emitir_nova=true, emite sempre. Devolve status, emissão, validade e protocolo. O PDF não vem pelo MCP. Custo por consulta, descontado do saldo em créditos (1 crédito = R$ 1): Starter R$ 0,10 (R$ 0,12 com créditos extras); Pro R$ 0,065 (R$ 0,085); Enterprise R$ 0,025 (R$ 0,035). Erro não é cobrado. Resposta sem inscrição encontrada, sem_certidao ou nao_contribuinte conta como consulta. Exige plano ou créditos extras: as 10 consultas grátis do mês são só no painel, não valem pelo MCP.
Eingabe-Schema
{
"type": "object",
"properties": {
"cpf": {
"anyOf": [
{
"maxLength": 20,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "CPF, com ou sem pontuação (informe só um documento).",
"title": "Cpf"
},
"cnpj": {
"anyOf": [
{
"maxLength": 24,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "CNPJ, com ou sem pontuação (informe só um documento).",
"title": "Cnpj"
},
"emitir_nova": {
"default": false,
"description": "Emite uma certidão nova mesmo que já exista uma válida.",
"title": "Emitir Nova",
"type": "boolean"
},
"confirmo_custo": {
"default": false,
"description": "Obrigatório para executar: true só depois que o usuário aceitou o custo descrito na ferramenta. Sem isso a ferramenta só explica o custo e não consulta nada.",
"title": "Confirmo Custo",
"type": "boolean"
}
},
"title": "consultar_cnd_federalArguments"
}Ausgabe-Schema
{
"type": "object",
"additionalProperties": true,
"title": "consultar_cnd_federalDictOutput"
}⚪consultar_crf_fgts(cpf, cnpj, confirmo_custo)
Consulta o Certificado de Regularidade do FGTS (Caixa) de um CPF ou CNPJ (um só). Devolve status, emissão, validade e protocolo. O PDF não vem pelo MCP. Custo por consulta, descontado do saldo em créditos (1 crédito = R$ 1): Starter R$ 0,10 (R$ 0,12 com créditos extras); Pro R$ 0,065 (R$ 0,085); Enterprise R$ 0,025 (R$ 0,035). Erro não é cobrado. Resposta sem inscrição encontrada, sem_certidao ou nao_contribuinte conta como consulta. Exige plano ou créditos extras: as 10 consultas grátis do mês são só no painel, não valem pelo MCP.
Eingabe-Schema
{
"type": "object",
"properties": {
"cpf": {
"anyOf": [
{
"maxLength": 20,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "CPF, com ou sem pontuação (informe só um documento).",
"title": "Cpf"
},
"cnpj": {
"anyOf": [
{
"maxLength": 24,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "CNPJ, com ou sem pontuação (informe só um documento).",
"title": "Cnpj"
},
"confirmo_custo": {
"default": false,
"description": "Obrigatório para executar: true só depois que o usuário aceitou o custo descrito na ferramenta. Sem isso a ferramenta só explica o custo e não consulta nada.",
"title": "Confirmo Custo",
"type": "boolean"
}
},
"title": "consultar_crf_fgtsArguments"
}Ausgabe-Schema
{
"type": "object",
"additionalProperties": true,
"title": "consultar_crf_fgtsDictOutput"
}⚪baixar_xml_nfe_sem_certificado(chave, confirmo_custo)
Devolve uma cópia para leitura do XML de UMA NF-e (modelo 55) a partir da chave de acesso de 44 posições, sem certificado digital. A cópia vem sem a assinatura digital (assinado=false, tipo_xml=leitura): traz os dados da nota, mas não serve para validar schema nem assinatura. Status por chave: ok (com o XML), nao_encontrado ou erro. Custo por chave, descontado do saldo em créditos (1 crédito = R$ 1): Starter R$ 0,30 (R$ 0,36 com créditos extras); Pro R$ 0,195 (R$ 0,255); Enterprise R$ 0,05 (R$ 0,05). Cobra o XML entregue e também a chave cuja nota não foi encontrada (nao_encontrado); a mesma chave repetida logo depois de um nao_encontrado, chave inválida e erro não são cobrados. Precisa de plano ou créditos extras.
Eingabe-Schema
{
"type": "object",
"properties": {
"chave": {
"description": "Chave de acesso da NF-e (44 posições); separadores são ignorados.",
"maxLength": 60,
"title": "Chave",
"type": "string"
},
"confirmo_custo": {
"default": false,
"description": "Obrigatório para executar: true só depois que o usuário aceitou o custo descrito na ferramenta. Sem isso a ferramenta só explica o custo e não consulta nada.",
"title": "Confirmo Custo",
"type": "boolean"
}
},
"required": [
"chave"
],
"title": "baixar_xml_nfe_sem_certificadoArguments"
}Ausgabe-Schema
{
"type": "object",
"additionalProperties": true,
"title": "baixar_xml_nfe_sem_certificadoDictOutput"
}⚪consultar_simples_nacional(cnpj, confirmo_custo)
Consulta a situação de um CNPJ no Simples Nacional (com a data da opção), no SIMEI e nos regimes regulares de IBS e CBS, com os eventos futuros. Para filiais, a situação é a da matriz. Custo por consulta, descontado do saldo em créditos (1 crédito = R$ 1): Starter R$ 0,10 (R$ 0,12 com créditos extras); Pro R$ 0,065 (R$ 0,085); Enterprise R$ 0,025 (R$ 0,035). Erro não é cobrado. Exige plano ou créditos extras: as 10 consultas grátis do mês são só no painel, não valem pelo MCP.
Eingabe-Schema
{
"type": "object",
"properties": {
"cnpj": {
"description": "CNPJ, com ou sem pontuação.",
"maxLength": 24,
"title": "Cnpj",
"type": "string"
},
"confirmo_custo": {
"default": false,
"description": "Obrigatório para executar: true só depois que o usuário aceitou o custo descrito na ferramenta. Sem isso a ferramenta só explica o custo e não consulta nada.",
"title": "Confirmo Custo",
"type": "boolean"
}
},
"required": [
"cnpj"
],
"title": "consultar_simples_nacionalArguments"
}Ausgabe-Schema
{
"type": "object",
"additionalProperties": true,
"title": "consultar_simples_nacionalDictOutput"
}⚪consultar_nfse(chave, confirmo_custo)
Consulta UMA NFS-e do padrão nacional pela chave de acesso de 50 dígitos, sem certificado digital: emitente, tomador, serviço, tributação municipal e federal e situação de geração (situacao não indica cancelamento). Uma consulta nova leva de 30 a 60 segundos. O PDF do DANFSe não vem por aqui. Custo por nota, descontado do saldo em créditos (1 crédito = R$ 1): Starter R$ 0,30 (R$ 0,36 com créditos extras); Pro R$ 0,195 (R$ 0,255); Enterprise R$ 0,05 (R$ 0,05). Cobra só a NFS-e entregue; chave inválida, nota não encontrada e erro não são cobrados. Exige plano ou créditos extras: as 10 consultas grátis do mês são só no painel, não valem pelo MCP.
Eingabe-Schema
{
"type": "object",
"properties": {
"chave": {
"description": "Chave de acesso da NFS-e (50 dígitos); separadores são ignorados.",
"maxLength": 70,
"title": "Chave",
"type": "string"
},
"confirmo_custo": {
"default": false,
"description": "Obrigatório para executar: true só depois que o usuário aceitou o custo descrito na ferramenta. Sem isso a ferramenta só explica o custo e não consulta nada.",
"title": "Confirmo Custo",
"type": "boolean"
}
},
"required": [
"chave"
],
"title": "consultar_nfseArguments"
}Ausgabe-Schema
{
"type": "object",
"additionalProperties": true,
"title": "consultar_nfseDictOutput"
}⚪saldo
Saldo da conta em créditos (1 crédito = R$ 1) e quanto ele ainda rende. creditos traz plano (créditos do plano que restam no ciclo), extras (créditos extras, não vencem), guardados (créditos do plano que sobraram quando o plano venceu; voltam ao assinar um plano) e disponivel (plano + extras). consultas_restantes (IE, CNPJ, certidões) e notas_restantes (XML de NF-e) dividem o mesmo saldo. notas_restantes conta o XML com certificado; no Enterprise o XML sem certificado custa o dobro. Usa a chave da FiscalAPI e não consome consulta.
Eingabe-Schema
{
"type": "object",
"properties": {},
"title": "saldoArguments"
}Ausgabe-Schema
{
"type": "object",
"additionalProperties": true,
"title": "saldoDictOutput"
}Community
Nachweis