# Servidor MCP > Consulte Inscrição Estadual, CNPJ e certidões de dentro do Claude, Cursor, VS Code ou ChatGPT pelo servidor MCP da FiscalAPI. URL: https://docs.fiscalapi.com.br/docs/getting-started/mcp O servidor [MCP](https://modelcontextprotocol.io) 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](/docs/getting-started/authentication) 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: ` (também aceita `Authorization: Bearer `) | | Registro oficial do MCP | `io.github.fiscalapi-br/fiscalapi-mcp` | | Código (MIT) | [github.com/fiscalapi-br/fiscalapi-mcp](https://github.com/fiscalapi-br/fiscalapi-mcp) | ## Configurar Troque `fapi_sua_chave` pela sua chave, que fica no [Dashboard](https://app.fiscalapi.com.br?utm_source=docs\&utm_medium=docs\&utm_campaign=mcp), em **Chave API**. ### Claude Code ```bash 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): ```json { "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: ```json { "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](/docs/referencia/plans-and-limits). ## 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](https://github.com/fiscalapi-br/fiscalapi-mcp). ## Links * Página do servidor: [fiscalapi.com.br/mcp](https://fiscalapi.com.br/mcp/) * Registro oficial do MCP: [`io.github.fiscalapi-br/fiscalapi-mcp`](https://registry.modelcontextprotocol.io/v0/servers?search=io.github.fiscalapi-br/fiscalapi-mcp) * Glama: [glama.ai/mcp/servers/fiscalapi-br/fiscalapi-mcp](https://glama.ai/mcp/servers/fiscalapi-br/fiscalapi-mcp)