# Factuarea

Wires your agent into the Factuarea platform: issue VeriFactu invoices, manage contacts, products and taxes without leaving the chat.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: factuarea
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/factuarea/factuarea-mcp
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/mcp/factuarea

## What it does

Factuarea is an invoicing and management platform for Spanish businesses and freelancers. This is its official MCP server — the production service itself, not a layer sitting on top of the REST API. Your agent gets the same operations the dashboard offers: raise a VeriFactu invoice, check who clocked in this morning, browse the catalog or look at a tax filing.

The server runs at `https://mcp.factuarea.com`. Nothing to install: point your client at the URL and sign in with your Factuarea account. The consent screen asks which company, which environment — `live` or `test` — and which permissions to hand over. MCP access comes with every plan, trial included.

No browser handy? An API key covers CI and scheduled jobs: create one in the developer settings and send it as a bearer token. Keys starting with `fact_test_…` hit the sandbox, `fact_live_…` hit the real company. Clients that only launch local servers can use the `@factuarea/mcp` package, a small stdio server that forwards calls to the same endpoint with your key. It needs Node 20 or later. No business logic ships in the package — tools, rules and permissions stay on the server, so local and remote connections act the same.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.factuarea.com`
- Environment variables: `FACTUAREA_API_KEY`, `FACTUAREA_MCP_URL`, `FACTUAREA_REQUEST_TIMEOUT_MS` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http mcp https://mcp.factuarea.com
```

2. **Platform CLI**
```bash
claude mcp add --env FACTUAREA_API_KEY=<FACTUAREA_API_KEY> --env FACTUAREA_MCP_URL=<FACTUAREA_MCP_URL> --env FACTUAREA_REQUEST_TIMEOUT_MS=<FACTUAREA_REQUEST_TIMEOUT_MS> --transport stdio factuarea -- npx -y @factuarea/mcp
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add factuarea --url https://mcp.factuarea.com
```

2. **Platform CLI**
```bash
codex mcp add factuarea --env FACTUAREA_API_KEY=<FACTUAREA_API_KEY> --env FACTUAREA_MCP_URL=<FACTUAREA_MCP_URL> --env FACTUAREA_REQUEST_TIMEOUT_MS=<FACTUAREA_REQUEST_TIMEOUT_MS> -- npx -y @factuarea/mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "factuarea": {
            "url": "https://mcp.factuarea.com"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "factuarea": {
            "command": "npx",
            "args": [
                "-y",
                "@factuarea/mcp"
            ],
            "env": {
                "FACTUAREA_API_KEY": "<FACTUAREA_API_KEY>",
                "FACTUAREA_MCP_URL": "<FACTUAREA_MCP_URL>",
                "FACTUAREA_REQUEST_TIMEOUT_MS": "<FACTUAREA_REQUEST_TIMEOUT_MS>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "factuarea": {
            "type": "http",
            "url": "https://mcp.factuarea.com"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "factuarea": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@factuarea/mcp"
            ],
            "env": {
                "FACTUAREA_API_KEY": "<FACTUAREA_API_KEY>",
                "FACTUAREA_MCP_URL": "<FACTUAREA_MCP_URL>",
                "FACTUAREA_REQUEST_TIMEOUT_MS": "<FACTUAREA_REQUEST_TIMEOUT_MS>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http factuarea https://mcp.factuarea.com
```

2. **Platform CLI**
```bash
gemini mcp add -e FACTUAREA_API_KEY=<FACTUAREA_API_KEY> -e FACTUAREA_MCP_URL=<FACTUAREA_MCP_URL> -e FACTUAREA_REQUEST_TIMEOUT_MS=<FACTUAREA_REQUEST_TIMEOUT_MS> factuarea npx -y @factuarea/mcp
```
Replace <…> with your own values

## When to use it
- issue a VeriFactu invoice for AEAT
- build a quote from the product catalog
- check who clocked in today
- review company contacts and taxes
- prepare a tax filing

## Example prompts
- Issue an invoice for last month with VeriFactu
- Show me who clocked in today
- Draft a quote from the product catalog

## Similar
- [Boletín Claro](https://affpapa.org/en/nevibecode/mcp/boletin-claro.md) — MCP server
- [QuickBooks Automation](https://affpapa.org/en/nevibecode/skills/quickbooks-automation.md) — skill · 4700 installs
- [popbill](https://affpapa.org/en/nevibecode/skills/popbill.md) — skill · 4400 installs
- [plan-payroll](https://affpapa.org/en/nevibecode/skills/plan-payroll.md) — skill · 1800 installs
- [xero](https://affpapa.org/en/nevibecode/skills/xero.md) — skill · 346 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md