Servidor MCP

Consulte Inscrição Estadual, CNPJ e certidões de dentro do Claude, Cursor, VS Code ou ChatGPT pelo servidor MCP da FiscalAPI.

O servidor MCP da FiscalAPI está no ar em https://mcp.fiscalapi.com.br/mcp (Streamable HTTP) e deixa um cliente MCP (Claude Code, 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.

Duas ferramentas funcionam sem chave e não cobram nada: validar_inscricao_estadual e cobertura. As outras usam a sua API Key e cobram do saldo da conta, como a API REST.

Item	Valor
Endereço	`https://mcp.fiscalapi.com.br/mcp`
Transporte	Streamable HTTP
Autenticação	header `X-API-Key: <chave>` (também aceita `Authorization: Bearer <chave>`)
Registro oficial do MCP	`io.github.fiscalapi-br/fiscalapi-mcp`
Código (MIT)	github.com/fiscalapi-br/fiscalapi-mcp

Configurar

Troque fapi_sua_chave pela sua chave, que fica no Dashboard, em Chave API.

Claude Code

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 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. 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.

Ferramentas e custos

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.

Ferramenta	O que faz	Custo
`validar_inscricao_estadual`	Confere formato e 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 consulta (fora das grátis)
`consultar_cnpj`	Cadastro público do CNPJ na Receita Federal, com Simples e MEI. `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

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, também pelo MCP. 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.

Freios

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 agente deve mostrar o custo e esperar o seu OK.
O servidor aceita até 30 consultas pagas por hora por chave (chave recusada pela API não conta). Para volume, use a API REST direto.
Valem também os limites da sua conta: por minuto, Lite 5, Starter 20, Pro 60 e Enterprise 120 consultas; XML de NF-e sem certificado, 2 consultas simultâneas. Veja Planos e Limites.

Segurança

A chave só é repassada à API da FiscalAPI (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).
O servidor só fala com api.fiscalapi.com.br; 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: github.com/fiscalapi-br/fiscalapi-mcp.