Facturalia MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.3.4Updated Nov 7, 2026

Create invoices and credit notes; check whether invoices are sent and paid in Facturalia.

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableFinance Business & Commerce

Server details

Identifier: io.usefulapi/facturalia
Transport: Streamable HTTP
Runtime: Web executable
Trust: Verified
Published: Nov 1, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified that this server's namespace belongs to usefulapi.io, which also runs its endpoint. That identifies the publisher; it does not make the server's tools safe.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.usefulapi%2Ffacturalia.svg)](https://sourceweft.com/mcp/io.usefulapi%2Ffacturalia?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Connects an assistant to a Facturalia account to create invoices and credit notes and check whether invoices are sent and paid.

What you can do: Check the sent and paid status of an invoice by number
Check the paid status of a credit note by number
Create a live sales invoice from customer and line data
Create a live credit note from customer and line data
Report monthly tool-call usage and manage the subscription plan
When to use it: Useful when you keep billing in Facturalia and want an assistant to draft and file invoices or credit notes from a conversation, or to look up whether a specific invoice has been sent or paid without opening the Facturalia interface.
Requirements: A remote MCP endpoint reached over streamable HTTP; no local install. Sign-in is via OAuth, and on first connect you supply your own Facturalia live API key (starts with fac_live_) from the Facturalia API module. A Facturalia account is required; the free plan allows 50 tool calls per month.

Before you install

The create tools write real documents to the live Facturalia account and count toward its invoices; they are not e-mailed automatically, and an external_id should be sent so retries do not duplicate documents. Your Facturalia live API key is stored per user by the server. Paid plans (Pro, Pro+) are billed through a Stripe Checkout link, and cancellation gives no refund for the current period.

Installation

In SourceWeft

Open Facturalia MCP by usefulapi in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.usefulapi%2Ffacturalia/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "facturalia-by-usefulapi": {
      "type": "http",
      "url": "https://facturalia.usefulapi.io/mcp"
    }
  }
}

README

Facturalia MCP by usefulapi

Use your Facturalia account from Claude, Cursor, or any MCP client. It reads the sent and paid status of invoices and the paid status of credit notes, and it creates live invoices and credit notes. Hosted, no local install: connect with your own credentials.

Live endpoint: https://facturalia.usefulapi.io/mcp · Homepage: https://usefulapi.io

Connect

Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://facturalia.usefulapi.io/mcp.
Claude Code: claude mcp add --transport http facturalia https://facturalia.usefulapi.io/mcp, then run /mcp to log in.
VS Code: Add to VS Code.
Cursor and other clients: add the URL as a remote MCP server:

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Facturalia credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/facturalia/

On first connect you provide your Facturalia live API key (in Facturalia under Extra, Modules, API; it starts with fac_live_). The server validates it and stores it per user. No keys go in config files.

Tools

Tool	Type	What it does
`facturalia_get_invoice_status`	read	Get invoice status
`facturalia_get_credit_note_status`	read	Get credit note status
`facturalia_create_invoice`	write	Create an invoice
`facturalia_create_credit_note`	write	Create a credit note
`facturalia_usage_status`	meta	Usage status (free-tier meter)
`facturalia_request_feature`	meta	Request a missing feature
`facturalia_upgrade`	meta	Upgrade to Pro or Pro+
`facturalia_cancel_subscription`	meta	Cancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with facturalia_upgrade (it returns a Stripe Checkout link). Cancel any time with facturalia_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running facturalia_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT — see LICENSE. Documentation only; the server is hosted.

Source: servers/facturalia/README.md at commit 4046075

Tools

facturalia_get_invoice_status

Get invoice status

Get the sent and paid status of one invoice by its number. Facturalia API: GET /invoices/status/?number=.

Parametersnumberrequired

facturalia_get_credit_note_status

Get credit note status

Get the paid status of one credit note by its number. Facturalia API: GET /creditnotes/status/?number=.

Parametersnumberrequired

facturalia_create_invoice

Create an invoice

Create a sales invoice in the live Facturalia account from customer and line data. It creates a real invoice that counts toward the account's invoices; it is not sent by e-mail (autosend is not offered). Send external_id so a retry does not create a second invoice. Facturalia API: POST /invoices/.

Parameterslinesrequiredinvoicerequiredcustomerrequiredexternal_id

facturalia_create_credit_note

Create a credit note

Create a credit note in the live Facturalia account from customer and line data. It creates a real document; it is not sent by e-mail (autosend is not offered). Send external_id so a retry does not create a second credit note. Facturalia API: POST /creditnotes/.

Parameterslinesrequiredcustomerrequiredcreditnoterequiredexternal_id

Version history

v1.3.4LatestNov 7, 2026
v1.2.3Nov 5, 2026
v1.2.2Nov 5, 2026
v1.2.1Nov 4, 2026
v1.2.0Nov 3, 2026
v1.1.1Nov 3, 2026
v1.0.0Nov 1, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 daysRequired25 pts
Auth declaredRequired10 pts
Tools listedRequired15 pts
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts

Business & Commerce5 toolsNov 7, 2026

Plan	Price	Limit
Free	$0	50 tool calls / month
Pro (per user)	$9/mo or $90/yr (2 months free)	Unlimited*