How do I install Factuarea?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Factuarea need an API key?

The publisher lists these environment variables: FACTUAREA_API_KEY, FACTUAREA_MCP_URL, FACTUAREA_REQUEST_TIMEOUT_MS.

What transport does Factuarea use?

Factuarea is reached over HTTP.

When was Factuarea last checked?

Last checked 2026-10-23. Spanish invoicing with VeriFactu (AEAT): invoices, quotes, contacts, products, taxes and filings.

Factuarea MCP server

Power your agent

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Add to Cursor Add in Claude Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Server URL

https://mcp.factuarea.com

Credentials from the publisher

FACTUAREA_API_KEY — Factuarea API key. The prefix selects the environment: fact_test_ for the isolated sandbox, fact_live_ for the real company. Without it the server starts and refuses every call with an actionable error.
FACTUAREA_MCP_URL — Endpoint of the hosted server. Defaults to https://mcp.factuarea.com.
FACTUAREA_REQUEST_TIMEOUT_MS — Ceiling for a single call, in milliseconds. Defaults to 120000.

The Claude button above opens Claude with the name and URL filled in. You still confirm it there.

shClaude Code

1claude mcp add --transport http com.factuarea-mcp https://mcp.factuarea.com

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "com.factuarea-mcp": {4      "command": "npx",5      "args": [6        "-y",7        "mcp-remote",8        "https://mcp.factuarea.com"9      ]10    }11  }12}

claude_desktop_config.json

Remote · HTTPPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Remote

Transport: http
Version

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

Connect

The server lives at https://mcp.factuarea.com. Add it to your client and sign in with your Factuarea account — no installation, no key to copy. On the consent screen you pick the company, the environment (live or test) and exactly which permissions to grant.

Client	Setup
Claude (web and desktop)	Settings → Connectors → Add custom connector and paste the URL
Claude Code	`claude mcp add --transport http factuarea https://mcp.factuarea.com`, then `/mcp` → Authenticate — or install the official plugin
ChatGPT	Add a custom connector (developer mode) with the URL and OAuth
Cursor	The Add to Cursor button, or `{ "mcpServers": { "factuarea": { "url": "https://mcp.factuarea.com" } } }` in `~/.cursor/mcp.json`
VS Code	The Install button, or `{ "servers": { "factuarea": { "type": "http", "url": "https://mcp.factuarea.com" } } }` in `.vscode/mcp.json`
Any other client	Streamable HTTP with OAuth 2.1 (dynamic client registration and PKCE)

MCP access is included in every Factuarea plan, also during the trial.

Create a key under Settings → Developers → API keys, choosing its scopes, and send it as a bearer token:

claude mcp add --transport http factuarea https://mcp.factuarea.com \
  --header "Authorization: Bearer fact_test_xxxxxxxxxxxxxxxxxxxxxxxx"

fact_test_… keys operate on the sandbox; fact_live_… keys on the real company.

@factuarea/mcp is a small stdio server that forwards every request to https://mcp.factuarea.com with your API key. It is the setup for the Claude Desktop configuration file, agent frameworks and any client without remote-server support. Node 20 or later.

{
  "mcpServers": {
    "factuarea": {
      "command": "npx",
      "args": ["-y", "@factuarea/mcp"],
      "env": { "FACTUAREA_API_KEY": "fact_test_xxxxxxxxxxxxxxxxxxxxxxxx" }
    }
  }
}

Variable	Meaning
`FACTUAREA_API_KEY`	Your API key. Without it the server still starts, and each call replies with how to create one.
`FACTUAREA_MCP_URL`	Server endpoint. Default `https://mcp.factuarea.com`; only `https://` is accepted outside `localhost`.
`FACTUAREA_REQUEST_TIMEOUT_MS`	Time limit per call. Default `120000`.

The package contains no business logic of its own: tools, rules and permissions are always the server's, so the local and the remote connection behave the same. Versions are published from CI with npm provenance.

Ask it things like

"Invoice Talleres Ruiz for yesterday's delivery note and email it to them."

"Which invoices from this quarter are still unpaid? Send each customer a reminder."

"Turn quote 2026-014 into an invoice, but move the due date to the 30th."

"Register this supplier invoice and mark it as paid by bank transfer."

"Raise every price in the wholesale price list by 5 %."

"Prepare the Modelo 303 workbook for the third quarter."

"Why didn't WooCommerce order #1042 produce an invoice?"

"Who on the team hasn't clocked in today?"

"Create a task in project DEV for tomorrow and assign it to Ana."

What it covers


🧾 Sales	Invoices from draft to paid — sending, scheduling, reminders, payments, voiding and rectificativas — plus quotes, pro-formas, signed delivery notes and recurring invoices
📥 Purchases	Supplier invoices with attachments, payments, overdue and pending lists
🚚 Transport	DeCA, the electronic control document for road freight: drafts (also from delivery notes), issuing, changes during the service, closing and cancelling, its PDF and the copy emailed to the carrier — not a delivery note, an invoice or a VeriFactu record
📦 Catalog	Contacts that are customers, suppliers or both; products with variants, presentations and stock; supplier offers; price lists; numbering series; taxes
🏛️ Compliance	VeriFactu records, events and certificates; FacturaE e-invoices to public administrations through FACe; Modelo 303, 347 and 130
⏱️ Team	Employees, work schedules, the working-time register required by RD-ley 8/2019, absences, presence and holidays
✅ Tasks & projects	Projects with board columns and custom fields; tasks with assignees, labels, comments, attachments and subtasks; timers and time entries you can bill on an invoice; the agenda and notifications
⚙️ Automation	Webhooks and events, a rule engine with dry runs, WooCommerce and Shopify stores, Stripe auto-invoicing
🏢 Advisors	Managed companies for gestorías, API keys, email and request logs

Every tool, its domain and the permission it needs: docs.factuarea.com/mcp/tools.

Alongside the tools, the server publishes 9 fiscal guides as resources (factuarea://guardrails/…: issuing, voiding versus rectifying, invoice types, lines and amounts, VAT regime keys, series, buyer identification, VeriFactu prerequisites, multiple companies) and 5 guided workflows as prompts: issuing an invoice, fixing a failed one, registering a customer by tax ID, connecting an online store and tracing an order that was never invoiced.

Designed for an agent that handles real money

It will not break the fiscal record. Some mistakes cannot be undone once an invoice exists for the tax agency: deleting an issued invoice instead of voiding it, editing one that is no longer a draft, annulling a rectificativa. The server refuses those calls before anything runs, and the refusal (mcp_guardrail_violation) names the broken rule (rule_id) and the guide that explains the right path (guardrail_uri), so the agent can correct course on its own.

A retry never creates a second invoice. Operations that cannot be undone accept an idempotency_key. If the agent repeats the call after a timeout, it gets the original result back, marked as a replay, instead of a duplicate document.

It only sees what you allowed. Each credential lists only the tools its scopes permit, and every call is checked again. Third-party apps connected through OAuth get a curated catalog; the most sensitive operations — VeriFactu writes, GDPR erasure, payments, API keys and managed companies — need the owner's own API key. No credential reaches data of a company it was not granted.

Practise on a copy first. A test credential works on a sandbox twin of your company that inherits its plan: nothing is sent to the AEAT, no email reaches your customers, no webhook leaves, and FACe submissions are simulated.

Security and privacy

OAuth 2.1 with PKCE and rotating refresh tokens; API keys shown once, stored hashed, with optional expiry and IP allowlist; connected apps can be revoked from the dashboard. Privacy policy: factuarea.com/privacidad. Vulnerabilities: please follow SECURITY.md.

Questions

No. Connect the server in Claude or ChatGPT and ask in plain language. The API key and npm package are only for automated setups.

They are the same invoices you would create in the dashboard. If VeriFactu is enabled for your company, Factuarea registers them with the AEAT exactly as it does for any other invoice.

Yes: choose test on the consent screen or use a fact_test_ key. The agent then works on an isolated sandbox company.

Only the one you chose when connecting. To work with another company, connect again and select it.

Open an issue — it is the right place even when the problem is in the hosted server. For account questions, contact support.

Contributing

This repository holds the npm package and the registry manifests; the server itself runs on Factuarea's platform. Read CONTRIBUTING.md to set up the project (and AGENTS.md if you work with a coding agent), and the Code of Conduct before taking part. Changes are listed in the CHANGELOG.

License

The code in this repository is MIT. Using the hosted server and Factuarea is subject to Factuarea's terms of service.

Factuarea

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Factuarea?

Does Factuarea need an API key?

What transport does Factuarea use?

When was Factuarea last checked?

Documentation

Connect

Ask it things like

What it covers

Designed for an agent that handles real money

Security and privacy

More from Factuarea for developers

Questions

Contributing

License