# FiscalAPI

> FiscalAPI is a freemium MCP server for finance and payments. Brazilian state registrations, CNPJ, tax clearance certificates and NF-e XML copies. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, Web
- **Website:** https://fiscalapi.com.br
- **Repository:** https://github.com/fiscalapi-br/fiscalapi-mcp
- **MCP Registry name:** io.github.fiscalapi-br/fiscalapi-mcp
- **Categories:** finance and payments, legal and government
- **Listing updated:** 2026-11-14

## About

Brazilian fiscal lookups are spread across state tax authorities and federal agencies; this server puts them behind one account balance. The README says it covers Inscrição Estadual in all 27 states, CNPJ and Simples Nacional status, service invoices by 50-digit key, and the state, federal, labour and FGTS clearance certificates, plus a read-only copy of an NF-e XML fetched by access key, without the digital signature.

Two tools need no key and cost nothing: one checks the format and check digit of a state registration number, and one reports what the API covers and its limits. The rest use your FiscalAPI key, sent as an X-API-Key or bearer header, and draw on the account balance like the REST API. Errors are not charged, but an answer that finds no registration still counts as a query. ChatGPT connectors cannot send a key header, so only the two free tools work there.

The site targets ERPs, fintechs, tax teams and agribusiness, and says data comes from state tax authorities, SINTEGRA, Receita Federal and other official sources.

## Features

- **State registration lookup:** Finds Inscrição Estadual by CPF, CNPJ or IE in one state or all 27.
- **CNPJ and Simples:** Returns the public CNPJ record, Simples Nacional and MEI status.
- **Clearance certificates:** Fetches state ICMS, federal, labour and FGTS certificates.
- **NFS-e by key:** Retrieves a service invoice from its 50-digit key.
- **Free checks:** Validates registration number format and lists coverage without a key.
- **Balance-based billing:** Each query draws on the account balance; failed queries are not charged.

## Good for

- Check a supplier's state registration before issuing an invoice
- Verify a customer's Simples Nacional status
- Pull tax clearance certificates for a counterparty review
- Read the items and taxes of an NF-e from its access key
- Confirm a rural producer's registration across states

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http fiscalapi-mcp https://mcp.fiscalapi.com.br/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.fiscalapi.com.br/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "fiscalapi-mcp": {
      "url": "https://mcp.fiscalapi.com.br/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "fiscalapi-mcp": {
      "type": "http",
      "url": "https://mcp.fiscalapi.com.br/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "fiscalapi-mcp": {
      "serverUrl": "https://mcp.fiscalapi.com.br/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "fiscalapi-mcp": {
      "type": "http",
      "url": "https://mcp.fiscalapi.com.br/mcp"
    }
  }
}
```

## Tools

- `validar_inscricao_estadual`: Checks the format and check digit of a state registration number.
- `cobertura`: Reports what the API covers by product and state, and its limits.
- `consultar_ie`: Looks up a state registration in one state by CPF, CNPJ or IE.
- `consultar_ie_todos_estados`: Looks up registrations in all 27 states in one call.
- `consultar_cnpj`: Returns the public CNPJ record with Simples and MEI status.
- `consultar_simples_nacional`: Returns Simples Nacional, SIMEI and IBS/CBS regime status.
- `consultar_nfse`: Retrieves a national-standard service invoice by 50-digit key.
- `consultar_cnd_estadual`: Fetches a state ICMS clearance certificate.
- `consultar_cndt`: Fetches the labour debt clearance certificate.
- `consultar_cnd_federal`: Fetches the federal tax and debt clearance certificate.

## FAQ

### Which tools are free?

validar_inscricao_estadual and cobertura need no key and cost nothing.

### How do I authenticate paid tools?

Send your FiscalAPI key in the X-API-Key header, or as a bearer token.

### Does validating an IE prove it exists?

No. The README says the free validator only checks format and check digit, not whether the registration exists or is active.

### What does it cost?

The README lists plans from R$ 19.99 per month and per-query prices that vary by plan, for example R$ 0.10 on Starter.

### Is FiscalAPI free?

FiscalAPI has a free plan, with paid plans for more usage or features.

### How do I add FiscalAPI to Claude Code?

Run this command in your terminal: claude mcp add --transport http fiscalapi-mcp https://mcp.fiscalapi.com.br/mcp

### What are the best alternatives to FiscalAPI?

The closest alternatives to FiscalAPI are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, NY LLC Publication (FileMyPublication) and Quantivex Research.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [NY LLC Publication (FileMyPublication)](https://ai-powered.com/mcp/ny-llc-publication-filemypublication): NY LLC Publication (FileMyPublication) is a free MCP server for legal and government.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [SupplyClub Catalog](https://ai-powered.com/mcp/supplyclub-catalog): SupplyClub Catalog is a free MCP server for legal and government.

---
Source: https://ai-powered.com/mcp/fiscalapi
