Servidor MCP da FiscalAPI: IE, CNPJ e certidões dentro do seu agente
O servidor MCP da FiscalAPI, no ar em https://mcp.fiscalapi.com.br/mcp, leva a consulta de Inscrição Estadual nos 27 estados, CNPJ e certidões para o Claude, o Cursor, o VS Code e o ChatGPT, e duas ferramentas funcionam sem chave e sem custo: validar_inscricao_estadual e cobertura. As outras nove usam a chave da sua conta e cobram do saldo, como a API.
Endereço do servidor (Streamable HTTP)
https://mcp.fiscalapi.com.br/mcpAtualizado em
As 11 ferramentas e quanto custa cada uma
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).
| Ferramenta | O que faz | Custo |
|---|---|---|
validar_inscricao_estadual | Confere o formato e o dígito verificador da IE na UF. Não diz se a IE existe ou está ativa. | Sem chave, sem custo |
cobertura | O que a FiscalAPI consulta, por produto e UF, e os limites da API. | Sem chave, sem custo |
consultar_ie | Inscrição Estadual numa UF, por CPF, CNPJ ou IE (por CPF, todos os estados menos SP). | 1 consulta |
consultar_ie_todos_estados | Inscrições nos 27 estados numa chamada, por CPF, CNPJ ou IE. | 1 consultaFora das 10 grátis |
consultar_cnpj | Cadastro público do CNPJ na Receita Federal, com Simples e MEI. Com ao_vivo=true, consulta na hora. | 1 consulta; ao vivo, 3 |
consultar_cnd_estadual | CND estadual (ICMS) de CPF ou CNPJ na UF. | 1 consulta |
consultar_cndt | Certidão Negativa de Débitos Trabalhistas. | 1 consulta |
consultar_cnd_federal | Certidão de tributos federais e Dívida Ativa da União. | 1 consulta |
consultar_crf_fgts | Certificado de Regularidade do FGTS. | 1 consulta |
baixar_xml_nfe_sem_certificado | Cópia para leitura do XML de uma NF-e (modelo 55) pela chave de acesso, sem a assinatura digital. | 3 consultas (2 no Enterprise)Lite R$ 2,01; Starter R$ 0,30; Pro R$ 0,195; Enterprise R$ 0,05 por chave |
saldo | Quanto o saldo ainda rende, em consultas e em notas. | Não consome consulta |
- Consulta que termina em erro não é cobrada. Resposta sem inscrição encontrada, sem_certidao ou nao_contribuinte conta como consulta.
- 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 precisa de plano ou recarga.
- 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.
Configurar no seu cliente MCP
A chave vai no header X-API-Key (também aceita Authorization: Bearer <chave>). Ela fica em app.fiscalapi.com.br, em Chave API. Troque fapi_sua_chave pela sua.
Claude Code
No terminal:
claude mcp add --transport http fiscalapi https://mcp.fiscalapi.com.br/mcp --header "X-API-Key: fapi_sua_chave"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
.cursor/mcp.json (no projeto) ou ~/.cursor/mcp.json (global):
{
"mcpServers": {
"fiscalapi": {
"url": "https://mcp.fiscalapi.com.br/mcp",
"headers": {
"X-API-Key": "${env:FISCALAPI_API_KEY}"
}
}
}
}VS Code
.vscode/mcp.json. O VS Code pede a chave na primeira vez e guarda de forma segura:
{
"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}"
}
}
}
}ChatGPT (modo desenvolvedor)
Crie um conector com esta URL, sem autenticação:
https://mcp.fiscalapi.com.br/mcpOs conectores do ChatGPT aceitam só OAuth ou nenhuma autenticação, não uma chave de API em header. 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.
As 10 consultas grátis valem pelo MCP
Conta que nunca assinou, com e-mail confirmado e sem recarga, tem 10 consultas grátis por mês de Inscrição Estadual de um estado e de CNPJ. Elas valem no painel, na API e pelo MCP, com a mesma chave. Não entram nas grátis a IE nos 27 estados nem o CNPJ ao vivo.
Freios e segurança
O agente não gasta o seu saldo sem você ver o custo, e a chave não fica guardada no servidor.
confirmo_custo é falso por padrão
Toda ferramenta que cobra tem o parâmetro 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.
Até 30 consultas pagas por hora por chave
É o teto deste servidor (chave recusada pela API não conta). Valem também os limites por minuto da conta: Lite 5, Starter 20, Pro 60 e Enterprise 120. Para volume, use a API REST direto.
A chave nunca vai para log
Ela só é repassada à API da FiscalAPI (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 quando a janela de 1 hora passa.
Só fala com a API da FiscalAPI
Os caminhos são fixos no código e o que você informa vai como parâmetro. O código é aberto, com licença MIT.
Perguntas frequentes
Existe servidor MCP para consultar inscrição estadual e CNPJ?
Sim. A FiscalAPI tem um servidor MCP no ar em https://mcp.fiscalapi.com.br/mcp (Streamable HTTP), publicado no registro oficial do MCP como io.github.fiscalapi-br/fiscalapi-mcp. Ele consulta Inscrição Estadual nos 27 estados por CPF, CNPJ ou IE, CNPJ, CND estadual, CNDT, CND Federal e CRF/FGTS no Claude, no Cursor, no VS Code e em outros clientes MCP. validar_inscricao_estadual e cobertura funcionam sem chave e sem custo; as demais usam a chave da sua conta da FiscalAPI.
Preciso de chave para usar o servidor MCP?
Para validar_inscricao_estadual e cobertura, não. Para as consultas com dados reais, sim: crie a conta em app.fiscalapi.com.br, gere a chave em Chave API e configure no cliente MCP o header X-API-Key (ou Authorization: Bearer).
Quanto custa consultar pelo MCP?
O mesmo que pela API. A maioria das ferramentas usa 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). O CNPJ ao vivo usa 3 consultas e o XML de NF-e sem certificado usa 3 (2 no Enterprise). Consulta que termina em erro não é cobrada, e a ferramenta saldo não consome consulta.
As 10 consultas grátis valem pelo MCP?
Conta que nunca assinou, com e-mail confirmado e sem recarga, tem 10 consultas grátis por mês de Inscrição Estadual de um estado e de CNPJ. Elas valem no painel, na API e pelo MCP, com a mesma chave. Não entram nas grátis a IE nos 27 estados nem o CNPJ ao vivo.
O agente pode gastar o meu saldo sem eu saber?
Toda ferramenta que cobra tem o parâmetro confirmo_custo, falso por padrão: sem confirmo_custo=true ela só explica o custo e não consulta nada. O servidor também aceita no máximo 30 consultas pagas por hora por chave.
O servidor guarda a minha chave?
Não. A chave só é repassada à API da FiscalAPI a cada chamada. O servidor não tem banco de dados, não registra headers e mantém em memória só um hash da chave para contar o teto por hora, descartado depois de 1 hora.
Funciona no ChatGPT?
No modo desenvolvedor, crie um conector com a URL do servidor, sem autenticação. Como os conectores do ChatGPT não enviam chave em header, por lá funcionam só validar_inscricao_estadual e cobertura. Para as consultas pagas, use Claude Code, Cursor, VS Code ou outro cliente que envia o header.
O PDF das certidões vem pelo MCP?
Não: o PDF é grande demais para o modelo. O MCP devolve status, emissão, validade e protocolo. Na API REST o PDF vem no campo pdf_base64.
Crie a chave e consulte do seu agente.
Conta nova, com e-mail confirmado, tem 10 consultas grátis por mês de Inscrição Estadual de um estado e de CNPJ, no painel, na API e pelo MCP.