Skip to main content
MCP server CX Codex

BeeL — Claude Code MCP server: Spanish e-invoicing with VeriFactu

BeeL — an MCP server for issuing Spanish electronic invoices with VeriFactu registration at AEAT. Your agent validates NIFs, creates F1/F2 invoices and R1–R5 corrections straight from Claude Code, Cursor or VS Code.

MIT ★ 2 updated 2026-10-21

Install into Claude Code · Platform CLI: remote server All methods and platforms ↓
claude mcp add --transport http mcp https://mcp.beel.es/mcp
Open on GitHub

What BeeL does

The server exposes 125 tools built from BeeL's public OpenAPI contract: invoice issuance, customer and product management, NIF validation against the census, tax regime configuration. Input schemas include enums, regime keys and line-item structures — all from the real API, no drift. Seven synthetic tools cover documentation search, the fiscal rules catalogue and NIF readiness checks.

Runs in two modes: a remote server at https://mcp.beel.es/mcp with OAuth login (nothing to install) and a local stdio server via npx @beel_es/mcp for automation where API keys work and browser logins do not. Keys prefixed beel_sk_test_ are safe to experiment with; beel_sk_live_ issue real fiscal documents.

Built-in guardrails stop a request before it becomes a document if regulatory invariants break. Resources under beel://guardrails/* carry fiscal rules by domain, an error code catalogue and seven workflow prompts: issue invoice, fix invoice, onboard NIF, connect payments.

What it helps with

  • Issue a Spanish electronic invoice with VeriFactu registration at AEAT
  • Validate a counterparty's NIF against the tax authority census
  • Create an R1–R5 corrective invoice that meets regulatory requirements
  • Configure tax regimes and document series for a company

Example prompts for the agent

  • Validate NIF ES12345678A and create an F1 invoice for 1200 euros
  • Issue an R2 correction for invoice INV-2024-001 and register it with VeriFactu
  • Show what needs to be configured for NIF ESB87654321 before it can issue invoices

How to install BeeL

1Platform CLI: remote server

claude mcp add --transport http mcp https://mcp.beel.es/mcp

2Platform CLI

claude mcp add --env BEEL_API_KEY=<BEEL_API_KEY> --env BEEL_ENV=<BEEL_ENV> --transport stdio beel -- npx -y @beel_es/mcp

Replace <…> with your own values

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about BeeL

How to install BeeL in Claude Code?

For the remote server with OAuth, run claude mcp add --transport http beel https://mcp.beel.es/mcp. For the local server with an API key: claude mcp add --env BEEL_API_KEY=<BEEL_API_KEY> --env BEEL_ENV=<BEEL_ENV> --transport stdio beel -- npx -y @beel_es/mcp.

What does BeeL do?

BeeL is an MCP server for issuing Spanish electronic invoices with VeriFactu registration at AEAT. Your agent validates NIFs, creates F1/F2 invoices, R1–R5 corrections and manages customers and products through 125 tools built from the OpenAPI contract.

What is the difference between beel_sk_test_ and beel_sk_live_ keys?

Keys prefixed beel_sk_test_ are safe to experiment with and do not create real fiscal documents. Keys prefixed beel_sk_live_ issue actual invoices registered with AEAT.

Similar MCP servers

All MCP servers for Backend and APIs →

Project sponsors

Companies that keep this analytics open