Back to the catalog

Invoicetronic MCP Server

MCP server for Italian electronic invoicing (SDI) via Invoicetronic API

Open source Open in the app JSON README (API)

About

MCP server for Italian electronic invoicing (SDI) via Invoicetronic API

Details

Kind
MCP servers
Topic
Finance & crypto
Publisher
fgasparetto
Origin
official
Category
ferramentas
Transport
local
Version
1.0.1
Last push
2026-03-12T10:53:17Z
Repository state
ativo
Language
Python
License
MIT
Added
2026-08-29 03:02:47
Updated
2026-08-29 03:02:47
Origin id
io.github.fgasparetto/invoicetronic-mcp

README

<!-- mcp-name: io.github.fgasparetto/invoicetronic-mcp -->

# Invoicetronic MCP Server

MCP server for the [Invoicetronic](https://invoicetronic.com) API — Italian electronic invoicing through the SDI (Servizio di Interscambio).

Built with [FastMCP](https://github.com/modelcontextprotocol/python-sdk) (Python).

## Features

20 tools covering the full Invoicetronic API:

| Category | Tools |
|----------|-------|
| **Account** | `account_status`, `health_check` |
| **Send** | `list_sent_invoices`, `get_sent_invoice`, `get_sent_invoice_by_identifier`, `get_sent_invoice_payload`, `send_invoice_xml`, `validate_invoice_xml` |
| **Receive** | `list_received_invoices`, `get_received_invoice`, `get_received_invoice_payload` |
| **Company** | `list_companies`, `get_company` |
| **Events** | `list_events`, `get_event` |
| **Updates** | `list_updates`, `get_update` |
| **Export** | `export_invoices` |

## Setup

### Prerequisites

- Python 3.11+
- [uv](https://docs.astral.sh/uv/) (recommended) or pip
- An [Invoicetronic](https://invoicetronic.com) API key

### Claude Code

Add to your `.mcp.json`:

```json
{
  "mcpServers": {
    "invoicetronic": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/invoicetronic-mcp", "server.py"],
      "env": {
        "INVOICETRONIC_API_KEY": "your-api-key"
      }
    }
  }
}
```

### Claude Desktop

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "invoicetronic": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/invoicetronic-mcp", "server.py"],
      "env": {
        "INVOICETRONIC_API_KEY": "your-api-key"
      }
    }
  }
}
```

## Authentication

The Invoicetronic API uses Basic auth with your API key as the username and an empty password. Set the `INVOICETRONIC_API_KEY` environment variable.

Get your API key at [invoicetronic.com](https://invoicetronic.com).

## API Reference

Full API docs: [api.invoicetronic.com](https://api.invoicetronic.com)

## License

MIT

More