# FiscalHub MCP by usefulapi

> FiscalHub MCP by usefulapi is an MCP server. Read NF-e XML and NCM tax data, simulate totals, issue and cancel NF-e and NFC-e in FiscalHub. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/fiscalhub/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/fiscalhub
- **MCP Registry name:** io.usefulapi/fiscalhub
- **Listing updated:** 2026-11-13

## About

Read NF-e XML and NCM tax data, simulate totals, issue and cancel NF-e and NFC-e in FiscalHub.

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http fiscalhub https://fiscalhub.usefulapi.io/mcp
```

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

```sh
https://fiscalhub.usefulapi.io/mcp
```

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

```json
{
  "mcpServers": {
    "fiscalhub": {
      "url": "https://fiscalhub.usefulapi.io/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "fiscalhub": {
      "type": "http",
      "url": "https://fiscalhub.usefulapi.io/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "fiscalhub": {
      "serverUrl": "https://fiscalhub.usefulapi.io/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "fiscalhub": {
      "type": "http",
      "url": "https://fiscalhub.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `fiscalhub_get_nfe_xml`: Get the authorized NF-e XML (nfe-proc: NF-e plus protocol) for an access key, fetched from the SEFAZ. Use it to recover an XML that was not stored locally. FiscalHub: GET /api/v1/nfe/{chave}/xml.
- `fiscalhub_list_received_nfe`: List NF-es and events issued against a company's CNPJ, fetched from the SEFAZ (Distribuicao DFe), in NSU order. Pass the returned ultNsu next time to get only new documents. Each document has its schema (resNFe, nfeProc or procEventoNFe). FiscalHub: GET /api/v1/nfe/distribuicao.
- `fiscalhub_get_ncm`: Get the tax data of one exact NCM product code: description, IPI rate, CEST and unit of measure. FiscalHub: GET /api/v1/ncm/{codigo}.
- `fiscalhub_search_ncm`: Search NCM product codes by a partial code or a description term. Use it to find the NCM for a product before issuing a document. FiscalHub: GET /api/v1/ncm/buscar?q=.
- `fiscalhub_simulate_nfe_totals`: Simulate the tax totals of an NF-e (ICMS, IPI, PIS, COFINS, DIFAL, IBS, CBS and the invoice total) before issuing it. Nothing is issued or stored. FiscalHub: POST /api/v1/tributario/simular-nfe.
- `fiscalhub_emit_nfe`: DESTRUCTIVE: issues an NF-e (model 55) and sends it to the SEFAZ for authorization. A production company issues a legal document that the customer must cancel if it is wrong. Whether it is homologation or production depends on the company's setting in FiscalHub. FiscalHub: POST /api/v1/nfe/emitir.
- `fiscalhub_cancel_nfe`: DESTRUCTIVE: cancels an authorized NF-e by its access key, with a required justification. The tax authority records the cancellation and it cannot be undone. FiscalHub: POST /api/v1/nfe/{chave}/cancelar.
- `fiscalhub_emit_nfce`: DESTRUCTIVE: issues a consumer NFC-e (model 65) and sends it to the SEFAZ for authorization. It has the same fields as an NF-e; the API applies model 65. The company's environment (homologation or production) is set in FiscalHub. FiscalHub: POST /api/v1/nfce/emitir.
- `fiscalhub_cancel_nfce`: DESTRUCTIVE: cancels an authorized NFC-e by its access key, with a required justification. The tax authority records the cancellation and it cannot be undone. FiscalHub: POST /api/v1/nfce/{chave}/cancelar.

## FAQ

### How do I add FiscalHub MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http fiscalhub https://fiscalhub.usefulapi.io/mcp

---
Source: https://ai-powered.com/mcp/fiscalhub-mcp-by-usefulapi
