io.github.fiscalapi-br由 GitHub 账号 fiscalapi-br 发布v0.1.0更新于 Nov 8, 2026
IE (27 UFs), CNPJ, certidões e cópia para leitura do XML de NF-e pela chave, do Brasil.
FiscalAPI 的 MCP 服务器，用于巴西企业与税务查询：州登记（IE）、CNPJ、各类完税证明以及 NF-e XML 副本。
Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。
把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。
阅读 https://sourceweft.com/mcp/io.github.fiscalapi-br%2Ffiscalapi-mcp/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。把它添加到你客户端的 mcpServers 配置中。
{
"mcpServers": {
"fiscalapi": {
"type": "http",
"url": "https://mcp.fiscalapi.com.br/mcp"
}
}
}Servidor MCP da FiscalAPI. Deixa um agente de IA (Claude, Cursor, VS Code, ChatGPT) consultar Inscrição Estadual nos 27 estados, CNPJ, CND estadual, CNDT, CND Federal, CRF/FGTS e baixar uma cópia para leitura do XML de NF-e pela chave de acesso (sem a assinatura digital), usando a sua conta da FiscalAPI.
Endereço: https://mcp.fiscalapi.com.br/mcp (Streamable HTTP)
Duas ferramentas funcionam sem chave e não cobram nada: validar_inscricao_estadual e cobertura. As outras usam a sua chave da FiscalAPI e cobram do saldo da conta, como a API REST.
Para consultar dados reais: crie a chave em app.fiscalapi.com.br (10 consultas grátis de IE/CNPJ por mês).
A chave vai no header X-API-Key (também aceita Authorization: Bearer <chave>). Troque fapi_sua_chave pela sua.
Para não deixar a chave no histórico do terminal, guarde-a numa variável de ambiente e use --header "X-API-Key: $FISCALAPI_API_KEY".
.cursor/mcp.json (no projeto) ou ~/.cursor/mcp.json (global):
.vscode/mcp.json. O VS Code pede a chave na primeira vez e guarda de forma segura:
Crie um conector com a URL https://mcp.fiscalapi.com.br/mcp, sem autenticação. Os conectores do ChatGPT aceitam só OAuth ou nenhuma autenticação, não uma chave de API em header, então por lá funcionam só as ferramentas sem chave (validar_inscricao_estadual e cobertura). Para as consultas pagas, use um cliente que envia o header, como os de cima.
Preço de 1 consulta do saldo por plano (franquia do plano; recarga entre parênteses): Lite R$ 0,67; Starter R$ 0,10 (R$ 0,12); Pro R$ 0,065 (R$ 0,07); Enterprise R$ 0,025 (R$ 0,02). Consulta que termina em erro não é cobrada; resposta sem inscrição encontrada, sem_certidao ou nao_contribuinte conta como consulta.
As 10 consultas grátis por mês valem para IE em um estado e CNPJ (não para a IE em todos os estados nem para o CNPJ ao vivo), em conta que nunca assinou, com e-mail confirmado e sem recarga. O XML de NF-e sem certificado cobra também a chave cuja nota não foi encontrada (menos a mesma chave repetida logo depois) e não entra nas grátis.
O PDF das certidões não volta pelo MCP (é grande demais para o modelo). Na API REST ele vem no campo pdf_base64; repetir a consulta lá cobra de novo.
confirmo_custo. Sem confirmo_custo=true, ela só explica o custo e não consulta nada. O agente deve mostrar o custo e esperar o seu OK.https://api.fiscalapi.com.br) no header X-API-Key, a cada chamada. O servidor não tem banco de dados, não registra headers e não guarda a chave: para contar o teto por hora, mantém em memória só um hash (SHA-256) dela, descartado depois que a janela de 1 hora passa (ou quando a chave é recusada pela API).api.fiscalapi.com.br; os caminhos são fixos no código e o que você informa vai como parâmetro.Requer uv e Python 3.12.
Os testes não chamam a API de verdade: as respostas são simuladas.
MIT. Veja LICENSE.
来源：README.md，提交 7982bb9
Validar Inscrição Estadual (formato e dígito)
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.
ie必填uf必填O que a FiscalAPI consulta
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.
无需输入参数。
Consultar Inscrição Estadual numa UF
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: 1 consulta do saldo (Lite R$ 0,67; Starter R$ 0,10 (recarga R$ 0,12); Pro R$ 0,065 (recarga R$ 0,07); Enterprise R$ 0,025 (recarga R$ 0,02)). Erro não é cobrado. Resposta sem inscrição encontrada, sem_certidao ou nao_contribuinte conta como consulta. Conta que nunca assinou, com e-mail confirmado e sem recarga, tem 10 consultas grátis por mês de IE em um estado e de CNPJ.
ieuf必填cpfcnpjsecundariasconfirmo_custoConsultar Inscrição Estadual em todos os estados
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: 1 consulta do saldo (Lite R$ 0,67; Starter R$ 0,10 (recarga R$ 0,12); Pro R$ 0,065 (recarga R$ 0,07); Enterprise R$ 0,025 (recarga R$ 0,02)). Erro não é cobrado. Resposta sem inscrição encontrada, sem_certidao ou nao_contribuinte conta como consulta. Não entra nas consultas grátis: exige plano ou recarga.
iecpfcnpjsecundariasconfirmo_custoConsultar CNPJ
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: 1 consulta do saldo (Lite R$ 0,67; Starter R$ 0,10 (recarga R$ 0,12); Pro R$ 0,065 (recarga R$ 0,07); Enterprise R$ 0,025 (recarga R$ 0,02)); com ao_vivo=true, 3 consultas (Lite R$ 2,01; Starter R$ 0,30 (recarga R$ 0,36); Pro R$ 0,195 (recarga R$ 0,21); Enterprise R$ 0,075 (recarga R$ 0,06)). Erro não é cobrado. Resposta sem inscrição encontrada, sem_certidao ou nao_contribuinte conta como consulta. Conta que nunca assinou, com e-mail confirmado e sem recarga, tem 10 consultas grátis por mês de IE em um estado e de CNPJ. A consulta ao vivo não entra nas grátis.
cnpj必填ao_vivoconfirmo_custoConsultar CND estadual
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: 1 consulta do saldo (Lite R$ 0,67; Starter R$ 0,10 (recarga R$ 0,12); Pro R$ 0,065 (recarga R$ 0,07); Enterprise R$ 0,025 (recarga R$ 0,02)). Erro não é cobrado. Resposta sem inscrição encontrada, sem_certidao ou nao_contribuinte conta como consulta.
uf必填cpfcnpjconfirmo_custoConsultar CNDT (débitos trabalhistas)
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: 1 consulta do saldo (Lite R$ 0,67; Starter R$ 0,10 (recarga R$ 0,12); Pro R$ 0,065 (recarga R$ 0,07); Enterprise R$ 0,025 (recarga R$ 0,02)). Erro não é cobrado. Resposta sem inscrição encontrada, sem_certidao ou nao_contribuinte conta como consulta.
cpfcnpjconfirmo_custoConsultar CND Federal
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: 1 consulta do saldo (Lite R$ 0,67; Starter R$ 0,10 (recarga R$ 0,12); Pro R$ 0,065 (recarga R$ 0,07); Enterprise R$ 0,025 (recarga R$ 0,02)). Erro não é cobrado. Resposta sem inscrição encontrada, sem_certidao ou nao_contribuinte conta como consulta.
cpfcnpjemitir_novaconfirmo_custoConsultar CRF/FGTS
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: 1 consulta do saldo (Lite R$ 0,67; Starter R$ 0,10 (recarga R$ 0,12); Pro R$ 0,065 (recarga R$ 0,07); Enterprise R$ 0,025 (recarga R$ 0,02)). Erro não é cobrado. Resposta sem inscrição encontrada, sem_certidao ou nao_contribuinte conta como consulta.
cpfcnpjconfirmo_custoBaixar XML de NF-e sem certificado (cópia para leitura)
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: 3 consultas do saldo (2 no Enterprise): Lite R$ 2,01; Starter R$ 0,30 (recarga R$ 0,36); Pro R$ 0,195 (recarga R$ 0,21); Enterprise R$ 0,05 por chave. 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 recarga.
chave必填confirmo_custoSaldo da conta
Quanto o saldo da conta ainda rende: consultas_restantes (IE, CNPJ, certidões) e notas_restantes (XML de NF-e). As duas formas dividem o mesmo saldo. notas_restantes conta o XML com certificado; no Enterprise o XML sem certificado gasta o dobro. Usa a chave da FiscalAPI e não consome consulta.
无需输入参数。
已满足适用检查项的 100%
该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。
claude mcp add --transport http fiscalapi https://mcp.fiscalapi.com.br/mcp --header "X-API-Key: fapi_sua_chave"{ "mcpServers": { "fiscalapi": { "url": "https://mcp.fiscalapi.com.br/mcp", "headers": { "X-API-Key": "${env:FISCALAPI_API_KEY}" } } }}{ "inputs": [ { "type": "promptString", "id": "fiscalapi-chave", "description": "Chave da FiscalAPI", "password": true } ], "servers": { "fiscalapi": { "type": "http", "url": "https://mcp.fiscalapi.com.br/mcp", "headers": { "X-API-Key": "${input:fiscalapi-chave}" } } }}uv syncuv run ruff check .uv run pytest -quv run python -m fiscalapi_mcp # sobe em http://localhost:8000/mcp (porta em PORT)