# Fiscalo MCP by usefulapi

> Fiscalo MCP by usefulapi is a freemium MCP server for accounting and tax. Hosted MCP server connecting Fiscalo invoicing to Claude, ChatGPT and Cursor. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** Web, API, CLI, vscode
- **Website:** https://usefulapi.io/fiscalo/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/fiscalo
- **MCP Registry name:** io.usefulapi/fiscalo
- **Categories:** accounting and tax
- **Listing updated:** 2026-11-18

## About

The server gives AI assistants access to a Fiscalo account, the Portuguese invoicing platform, through its API. Users can look up customers and catalog items, create new ones, prepare draft invoices and add lines to them, and check the status of documents. Issuing a document is not possible through the server; that step stays inside the Fiscalo Developer Center.

It runs as a remote endpoint, so there is nothing to install locally. Each user signs in with OAuth and enters their own Fiscalo API key on the login page, and the key determines which company and environment (sandbox or production) the tools act on. Write operations need production access on the company.

According to the product's site, it is aimed at Portuguese companies and accountants who prepare invoices in Fiscalo. The site also states that usefulapi is an independent service and is not affiliated with or endorsed by Fiscalo.

## Features

- **Customer lookup and creation:** Search customers by name, tax number or external id, open a record, or create a new individual or company customer.
- **Draft invoice preparation:** Create a draft document for a customer in an active series and add lines to it, without issuing the document.
- **Document status review:** List invoices, credit notes and quotes with their status, and open one to see its lines, taxes and totals.
- **Product and service catalog:** List or fetch catalog items and create new products or services with a unit price and tax rate.
- **Connection and environment check:** Test that an API key works and see whether it points to the sandbox or production environment.
- **Read-only and write tool split:** Nine tools only read data, while four can create or change records, so clients can ask for approval before writes.

## Good for

- Drafting invoices for a client from a chat with Claude or ChatGPT
- Checking whether a customer already exists before creating a new record
- Reviewing which documents were created today and their current status
- Adding new services and their tax rates to the Fiscalo catalog
- Verifying whether an API key is pointed at sandbox or production before working

## Install

### Claude Code (Terminal)

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

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

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

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

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

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

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

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

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

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

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

## Tools

- `fiscalo_connection_test`: Check that the API key works and show its environment (sandbox or production).
- `fiscalo_list_customers`: List customers of the company behind the API key, filterable by name, tax number or external_id.
- `fiscalo_get_customer`: Get one customer by its Fiscalo id.
- `fiscalo_create_customer`: Create a customer (individual or company).
- `fiscalo_list_items`: List products and services in the catalog.
- `fiscalo_get_item`: Get one product or service by its Fiscalo id.
- `fiscalo_create_item`: Create a product or service with its unit price and tax rate.
- `fiscalo_list_tax_rates`: List the global tax-rate catalog.
- `fiscalo_list_document_series`: List the document series of the company.
- `fiscalo_list_documents`: List documents with their status.
- `fiscalo_get_document`: Get one document with its lines, taxes, totals and status.
- `fiscalo_create_document_draft`: Create a draft document for a customer in an active series; the draft is not issued.
- `fiscalo_add_document_line`: Add a line to a draft document.
- `fiscalo_usage_status`: Report the caller's current usage and plan limit.
- `fiscalo_request_feature`: Send a request for a feature the Fiscalo tools cannot yet provide.
- `fiscalo_upgrade`: Get a paid plan (Pro or Pro+) for Fiscalo.
- `fiscalo_cancel_subscription`: Cancel the Pro subscription at the end of the paid period.

## FAQ

### Can the server issue invoices?

No. The draft tool cannot issue or cancel a document, and issuing stays in the Fiscalo Developer Center.

### Do I need to install anything?

No. The README describes it as hosted with no local install. You connect by adding the server URL to an MCP client and logging in.

### Where do I get the API key?

Create or copy a key in the Fiscalo Developer Center under API keys. The login page asks for it.

### What does the free plan include?

The free plan allows 50 tool calls per month. Pro is $9/month or $90/year with 10,000 calls, and Pro+ is $39/month or $390/year with 100,000 calls.

### Which clients are supported?

The site lists Claude, ChatGPT, Claude Code, Cursor, VS Code, Codex, Windsurf and other clients that support remote MCP over Streamable HTTP with OAuth.

### Is Fiscalo MCP by usefulapi free?

Fiscalo MCP by usefulapi has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

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

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

### What are the best alternatives to Fiscalo MCP by usefulapi?

The closest alternatives to Fiscalo MCP by usefulapi are Fatture in Cloud MCP by usefulapi, KashFlow MCP by usefulapi, CBO MCP by usefulapi, Facture App MCP by usefulapi and FiscalHub MCP by usefulapi.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Fatture in Cloud MCP by usefulapi](https://ai-powered.com/mcp/fatture-in-cloud-mcp-by-usefulapi): Fatture in Cloud MCP by usefulapi is a freemium MCP server for accounting and tax.
- [KashFlow MCP by usefulapi](https://ai-powered.com/mcp/kashflow-mcp-by-usefulapi): KashFlow MCP by usefulapi is a freemium MCP server for accounting and tax.
- [CBO MCP by usefulapi](https://ai-powered.com/mcp/cbo-mcp-by-usefulapi): CBO MCP by usefulapi is a freemium MCP server for accounting and tax.
- [Facture App MCP by usefulapi](https://ai-powered.com/mcp/facture-app-mcp-by-usefulapi): Facture App MCP by usefulapi is a freemium MCP server for finance and payments.
- [FiscalHub MCP by usefulapi](https://ai-powered.com/mcp/fiscalhub-mcp-by-usefulapi): FiscalHub MCP by usefulapi is a freemium MCP server for accounting and tax.
- [Doklado MCP by usefulapi](https://ai-powered.com/mcp/doklado-mcp-by-usefulapi): Doklado MCP by usefulapi is a freemium MCP server for accounting and tax.
- [Fakturowo MCP by usefulapi](https://ai-powered.com/mcp/fakturowo-mcp-by-usefulapi): Fakturowo MCP by usefulapi is a freemium MCP server for accounting and tax.
- [Invoices Online MCP by usefulapi](https://ai-powered.com/mcp/invoices-online-mcp-by-usefulapi): Invoices Online MCP by usefulapi is a freemium MCP server for accounting and tax.

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