f facturifirma

MCP · Model Context Protocol

Connect an AI assistant to your company

facturifirma exposes an MCP server over streamable HTTP. Any compatible client (Claude, Claude Code, other agents) can issue invoices, submit to the SPV, manage clients and generate reports directly from a conversation.

Start free Available tools

What the MCP connector is

MCP (Model Context Protocol) is an open standard for AI assistants to call tools exposed by an application. The facturifirma connector gives full read/write access to your companies, documents, clients and reports, enforcing the same business rules as the app and REST API.

Endpoint

Streamable HTTP MCP server, available at the address below.

https://app.facturifirma.ro/mcp

Authentication

Option 1 — OAuth (recommended for claude.ai / ChatGPT)

For clients that can't send a custom Authorization header (claude.ai web connectors, ChatGPT), authorization happens in the browser via OAuth 2.1.

  1. 1. In claude.ai: open Settings → Connectors and click “Add custom connector”.
  2. 2. Give it a name (e.g. “facturifirma”), paste the address https://app.facturifirma.ro/mcp and click “Add”.
  3. 3. Click “Connect” on the new connector — you’re taken to facturifirma to sign in (if you aren’t already).
  4. 4. Click “Allow” on the consent screen. You return to claude.ai with the connector “Connected” — no client ID or secret to configure.
https://app.facturifirma.ro/mcp

Option 2 — API key (Bearer)

For clients that can send custom headers (Claude Code, Claude Desktop, other agents), use an API key as a Bearer header.

  1. 1. Create an API key in the app: Settings → API Keys.
  2. 2. Send the key as an Authorization: Bearer <API_KEY> header on every request.
  3. 3. Configure your MCP client (Claude Code, Claude Desktop, etc.) with the endpoint and header below.

Claude Code (CLI)

claude mcp add --transport http facturifirma https://app.facturifirma.ro/mcp --header "Authorization: Bearer <API_KEY>"

Generic config (JSON)

{
  "mcpServers": {
    "facturifirma": {
      "url": "https://app.facturifirma.ro/mcp",
      "headers": {
        "Authorization": "Bearer <API_KEY>"
      }
    }
  }
}

Available tools

The real list of tools the server exposes, grouped by area:

Invoicing & documents

Create, edit, issue and collect payment on invoices, proformas and credit notes.

list_documentscreate_invoiceupdate_invoiceissue_documentdelete_documentrecord_paymentreverse_invoiceconvert_proformalist_purchases

ANAF e-Factura

Send documents to the SPV, track their status, and import received invoices.

send_to_anafpoll_efacturasync_inboxlist_inboximport_inbox

Companies

List and manage the companies under your account.

list_companiescreate_companyget_companyupdate_company

Clients

Create and manage a company's clients (counterparties).

list_clientscreate_clientget_clientupdate_clientdelete_client

Suppliers

Create and manage a company's suppliers (the parties you buy from).

list_suppliersget_suppliercreate_supplierupdate_supplierdelete_supplier

Expenses

Record and manage supplier expenses.

list_expensescreate_expenseupdate_expensedelete_expense

Recurring invoices

Create templates that auto-generate draft invoices on a cadence.

list_recurringcreate_recurringupdate_recurringdelete_recurring

Bank accounts

List and replace the bank accounts of a company, client, or supplier.

list_bank_accountsreplace_bank_accounts

Public ANAF data

Look up a Romanian company by CUI (name, address, VAT / e-Factura status).

lookup_company

Catalog & operations

Products, warehouses and numbering series.

list_productscreate_productget_productupdate_productdelete_productlist_warehousescreate_warehouseupdate_warehousedelete_warehouselist_seriescreate_seriesupdate_seriesdelete_series

Reports

Sales journal, VAT report and bank reconciliation.

sales_journalvat_reportreconcile_bank

Settings

Read and update the tenant's configuration.

get_settings_schemaget_settingsupdate_settings

Security

An API key is scoped to your account (tenant) and can be revoked anytime from Settings → API Keys. Every MCP call runs with the same permissions as the user who generated the key — nothing more.

Ready to connect an AI assistant?

Create an API key in the app and add it to your favorite MCP client.

Open the app

← Back to home