Skip to content
Factusur

MCP server · Claude · Cursor · VS Code · Codex

Convert your invoices to Factur-X from your AI assistant

Add Factusur to Claude, Cursor, VS Code or Codex. Ask it to “convert this invoice”: the agent produces a checked Factur-X, shows you the report and gives you the download link.

  • 5 free conversions a month, with an account
  • An EN 16931 check report with every Factur-X
  • The agent never pays: you stay in control

Server URL: https://factusur.com/mcp

Conversion is for invoices issued by businesses registered in France (the seller needs a SIREN number). Checking a Factur-X works for any file.

AI assistant · factusur server

you › Convert facture-042.pdf to Factur-X with Factusur.

factusur · convert_to_facturx

reading · generating · EN 16931 checks…

Factur-X ready · checks PASS

1 conversion counted · 2 left this month

facture-F2026-042-facturx.pdf · link valid for 15 min

Example: the user asks their assistant to convert an invoice; the assistant calls Factusur’s convert_to_facturx tool and gets a compliant Factur-X, with a download link.

Setup · 2 minutes

Add Factusur to your tool

Commands and configurations checked against each tool’s documentation. You then sign in to your Factusur account in the browser: no key to copy.

One command in the terminal, then sign in to your account from the browser.

  1. Step 1: In a terminal, add the server with the command below (--scope user makes it available in all your projects).
  2. Step 2: Open Claude Code, type /mcp, pick factusur then “Authenticate”: your browser opens on Factusur.
  3. Step 3: Sign in, review what Claude will be able to do, then click “Allow”.
  4. Step 4: Then ask, for example: “Convert invoice-042.pdf to Factur-X with Factusur”.
Terminal
claude mcp add --transport http --scope user factusur https://factusur.com/mcp

.mcp.json (shared project)
{
  "mcpServers": {
    "factusur": {
      "type": "http",
      "url": "https://factusur.com/mcp"
    }
  }
}

At the root of a repository, for the whole team. Everyone signs in with their own account.

Use an access key instead of OAuth

For a script, CI or a tool without OAuth sign-in. Create a key in Account › MCP connections: it is shown only once. Never paste it into a file under version control.

With an access key
claude mcp add --transport http --scope user factusur https://factusur.com/mcp \
  --header "Authorization: Bearer fsk_live_YOUR_KEY"

Sign-in: OAuth (sign-in in the browser) or an access key in a header. Source: Claude Code documentation (MCP) (opens in a new tab), checked on 26 October 2026.

Full guide for Claude Code

Tools

What your agent can do

Convert, fix, check, keep an eye on your quota: a few example requests.

convert_to_facturxConvertcounts one conversion

Convert an invoice

PDF, photo or structured data → Factur-X EN 16931, with a check report and a download link. If a mandatory detail is missing, the agent asks you for it.

  • “Convert invoice-042.pdf to Factur-X with Factusur.”
  • “Create a Factur-X for this invoice: 3 days of consulting at €450 excl. VAT, customer Exemple SAS.”
batch_convertConvertcounts one conversion

Convert a batch

Up to 20 invoices at once, with a ZIP file. Unlocking is all or nothing: if the quota isn’t enough, nothing is counted.

  • “Convert every PDF invoice in the ./october folder to Factur-X.”
validate_facturxValidatecounts nothing

Check a Factur-X

Checks PDF/A-3, XML, XSD, the EN 16931 schematron and the French mandatory details of a Factur-X you received. Counts no conversion.

  • “Check the Factur-X my supplier sent me and tell me what’s wrong.”
All 9 tools of the Factusur MCP server

Limits and quotas

The same quota as on the website

Each compliant Factur-X unlocked by the agent counts one conversion of your plan, exactly as on the website. Checking a Factur-X counts nothing. Prices include French VAT (20%).

See pricing
Conversions per month and price incl. VAT for each plan
PlanConversions per monthPrice incl. VAT
Free5€0
Starter10€3.90 / month
Essentiel30€6.90 / month
Pro100€13.90 / month
Business500€26.90 / month
Formats
PDF, JPG, PNG (Excel and CSV when import is enabled)
Size
3 MB in the request, 10 MB and 10 pages per upload
Batch
20 invoices at most
Default caps
30 calls per minute, 50 conversions per day and per connection (adjustable)
Download links
15 minutes, single use
Retention
files deleted within 2 hours after download, 25 hours at most

Security

You stay in control

You authorize each application

Sign-in goes through a Factusur screen showing the application, its return address and the permissions it asks for. You can refuse, and disconnect the application from your account at any time.

The agent never pays

No tool can pay, change your plan or delete your data. When the quota is reached, the agent shows you a link: you pay yourself, in your browser.

Revocable, limited access

Short-lived tokens, access keys with an expiry date and the permissions you choose, adjustable call caps: an agent stuck in a loop can’t drain your quota.

Your invoices don’t stay

Same rules as on the website: files deleted within 2 hours after download, 25 hours at most. The activity log contains no invoice content.

MCP server security in detail

Frequently asked questions

What is an MCP server?

The Model Context Protocol (MCP) is an open standard that lets an AI assistant (Claude, Cursor, VS Code, Codex…) use external tools. The Factusur MCP server gives it access to Factur-X invoice conversion and checking.

Do I need a Factusur account?

Yes: a free account is enough (5 conversions a month). You sign in once, from your browser; you can also create an access key in your account.

How much does a conversion through the agent cost?

Exactly the same as on the website: each compliant Factur-X unlocked counts one conversion of your plan. Checking a Factur-X counts nothing.

Can the agent pay or change my plan?

No. When your quota is reached, the agent receives a message with a link to the payment page: only you can open it, sign in and confirm.

Does Factusur send my invoices?

No. Factusur is not an approved platform (PA) and does not transmit your invoices: it creates a Factur-X file from the invoice details, which you or your agent download.

What happens to my files?

The same rules as on the website apply: the original is deleted once the Factur-X is generated, and the Factur-X at the latest 2 hours after the first download and 25 hours after upload.

OAuth or access key: which one?

OAuth when your tool supports it (Claude, Cursor, VS Code, Codex): nothing to copy, you authorize in the browser. An access key suits scripts, CI or tools without OAuth; it is shown only once and can be revoked in one click.

Is the MCP server official?

The server is published by Factusur and follows the open MCP specification. It is not a product of Anthropic, OpenAI, Cursor or Microsoft.

Troubleshooting

“401” or “authentication required”

Sign in again from your tool (/mcp in Claude Code, “Connect” in Cursor, codex mcp login). A revoked or expired key must be replaced.

“quota_exceeded”

Your monthly quota is used up: open the link shown by the agent to change plan or add a pack, then ask the agent to resume the conversion (nothing is read again).

“needs_input”: missing details

The invoice lacks some mandatory details (customer SIREN, date…). Give them to the agent: it fixes them with update_conversion, then runs the conversion again.

“rate_limited”

A safety cap was reached (calls per minute, conversions per day). Wait a moment, or adjust your caps in Account › MCP connections.

File too large

Above 3 MB, the agent must use create_upload_url (direct upload, 10 MB at most). A PDF of more than 10 pages is refused: upload the invoice only.

My tool can’t find the server

Check the exact URL https://factusur.com/mcp and the “http” transport (Streamable HTTP). Older clients limited to the SSE transport are not supported.

Factusur is not an approved platform (plateforme agréée, PA) and does not transmit your invoices. We create a file in Factur-X format from the information you confirm.

You remain solely responsible for the content of your invoices and for their compliance with invoicing rules.

MCP (Model Context Protocol) is an open specification. Factusur is not affiliated with Anthropic, OpenAI, Cursor or Microsoft; the names mentioned belong to their owners.