Factuarea

com.factuareaPublished by factuarea.comOfficial publisherv0.1.3Updated Oct 26, 2026

Spanish invoicing with VeriFactu (AEAT): invoices, quotes, contacts, products, taxes and filings.

VerifiedStreamable HTTPWeb executableProductivity & WorkflowFinanceBusiness & Commerce

Overview

AI-generated overview

Official Factuarea MCP server that lets an assistant run Spanish invoicing and back-office work — VeriFactu invoices, quotes, purchases, catalog, tax filings…

What you can do
  • Issue, send, schedule, void and rectify invoices, quotes, pro-formas and delivery notes, with PDF templates and brand identities
  • Register supplier invoices and payments, and list overdue or pending items
  • Manage contacts, products with variants and stock, price lists, numbering series and taxes
  • Handle VeriFactu records, FacturaE/FACe e-invoices and Modelo 303, 347 and 130 filings
  • Track employees, work schedules, absences and the working-time register, plus projects, tasks, timers and billable time entries
  • Configure webhooks, rule automations, WooCommerce and Shopify stores and Stripe auto-invoicing; fiscal guides ship as resources and guided workflows as prompts
When to use it
Useful for Spanish businesses, freelancers and gestorías that already run on Factuarea and want an assistant to draft, issue and chase invoices, register purchases, prepare tax models or answer questions about orders, staff and projects without leaving the chat.
Requirements
A Factuarea account and plan (MCP access is included, also during the trial). Connect the hosted endpoint with OAuth 2.1 and pick company, environment and permissions on the consent screen, or use an API key as a bearer token. Clients without remote support can run the npm package @factuarea/mcp on Node 20 or later with FACTUAREA_API_KEY set; FACTUAREA_MCP_URL and FACTUAREA_REQUEST_TIMEOUT_MS are optional.
Before you install
The server acts on real fiscal and financial data: it can issue, send, void and rectify invoices, email customers, register payments and submit filings, and some mistakes cannot be undone once recorded with the tax agency. A fact_live_ key or the live environment touches the real company, so start with the test environment or a fact_test_ key. API keys are shown once and grant scopes; the most sensitive operations need the owner's own key. Data goes to the hosted Factuarea service.

Installation

In SourceWeft

  1. Open Factuarea in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. 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/com.factuarea%2Fmcp/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. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "factuarea": {
      "type": "http",
      "url": "https://mcp.factuarea.com/"
    }
  }
}

README

[Factuarea]

Factuarea MCP

Your whole back office, one MCP server away.
Invoicing with VeriFactu, purchases, catalog, tax filings, time tracking and automations
for Spanish businesses — as tools for Claude, ChatGPT, Cursor, VS Code and any MCP client.

English · Español

[npm] [CI] [MCP Registry] [650+ tools] [MIT license]

[Add Factuarea to Cursor] [Install Factuarea in VS Code]

650+ tools · 41 domains · 9 fiscal guardrails · 5 guided workflows · live and sandbox environments

Factuarea is an invoicing and management platform for businesses and freelancers in Spain. This is its official Model Context Protocol server — the same service the Factuarea team runs in production, not a wrapper built on top of it. Whatever you can do in the Factuarea dashboard or through its REST API, your agent can do in conversation: from issuing a VeriFactu invoice to checking who clocked in this morning.

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.

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

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

No browser available? Use an API key (scheduled jobs, CI, servers)

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

bash
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.

Client that only runs local servers? Use the npm package

@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.

json
{  "mcpServers": {    "factuarea": {      "command": "npx",      "args": ["-y", "@factuarea/mcp"],      "env": { "FACTUAREA_API_KEY": "fact_test_xxxxxxxxxxxxxxxxxxxxxxxx" }    }  }}
VariableMeaning
FACTUAREA_API_KEYYour API key. Without it the server still starts, and each call replies with how to create one.
FACTUAREA_MCP_URLServer endpoint. Default https://mcp.factuarea.com; only https:// is accepted outside localhost.
FACTUAREA_REQUEST_TIMEOUT_MSTime 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."

"Use the new template with our logo on every quote we send to Talleres Ruiz."

What it covers

🧾 SalesInvoices from draft to paid — sending, scheduling, reminders, payments, voiding and rectificativas — plus quotes, pro-formas, signed delivery notes and recurring invoices
🎨 Document designA library of PDF templates and brand identities, versioned by revision, with your own logos and defaults for the company, each document type, series or contact; the template of each invoice, quote, pro-forma and delivery note and its audited visual revisions; previews, retained PDFs you can prepare, render and verify, and public links that share the exact version you published
📥 PurchasesSupplier invoices with attachments, payments, overdue and pending lists
🚚 TransportDeCA, 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
📦 CatalogContacts that are customers, suppliers or both; products with variants, presentations and stock; supplier offers; price lists; numbering series; taxes
🏛️ ComplianceVeriFactu records, events and certificates; FacturaE e-invoices to public administrations through FACe; Modelo 303, 347 and 130
⏱️ TeamEmployees, work schedules, the working-time register required by RD-ley 8/2019, absences, presence and holidays
✅ Tasks & projectsProjects 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
⚙️ AutomationWebhooks and events, a rule engine with dry runs, WooCommerce and Shopify stores, Stripe auto-invoicing
🏢 AdvisorsManaged 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.

More from Factuarea for developers

Questions

Do I need to know how to program?

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

Are invoices created this way valid for VeriFactu?

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.

Can I try it without touching my real data?

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

Can the agent see other companies I have access to?

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

I found a bug or I'm missing a tool.

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.

Source: README.md at commit 26859ef

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

4
  1. v0.1.3LatestOct 26, 2026
  2. v0.1.2Oct 14, 2026
  3. v0.1.1Oct 1, 2026
  4. v0.1.0Sep 25, 2026

Score

85% 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 listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts