Skip to content
MCP server

FiscalAPI

Brazilian state registrations, CNPJ, tax clearance certificates and NF-e XML copies

Install
Pricing
Freemium
Platforms
API, Web
Runs
Remotely
Version
0.1.0
Listing updated
3 days ago

About FiscalAPI

FiscalAPI is a freemium MCP server for finance and payments. It runs as a hosted remote server, so there is nothing to install locally.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://mcp.fiscalapi.com.br/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "fiscalapi-mcp": {
      "url": "https://mcp.fiscalapi.com.br/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (10)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Freemium

Plans from R$ 19.99/month; the site mentions 10 free queries a month; per-query prices by plan

Prices change. Check fiscalapi.com.br before you buy.

FiscalAPI 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 to FiscalAPI

  1. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  2. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  3. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments
  4. New York LLC publication rules, deadline, county prices, clerks and notice text

    • 8 tools
    • Remote
    • Free
    • Legal and government
  5. Stock scores, what a price assumes, earnings quality and quiet profit revisions

    • 11 tools
    • Remote
    • Free
    • Finance and payments
  6. Provyan

    MCP server

    Backtested crypto signal results on 94 coins, with luck odds and sources

    • 4 tools
    • Remote
    • Free
    • Finance and payments