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
claude mcp add --transport http mcp https://mcp.beel.es/mcpWhat 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/mcp2Platform CLI
claude mcp add --env BEEL_API_KEY=<BEEL_API_KEY> --env BEEL_ENV=<BEEL_ENV> --transport stdio beel -- npx -y @beel_es/mcpReplace <…> with your own values
1Platform CLI: remote server
codex mcp add beel --url https://mcp.beel.es/mcp2Platform CLI
codex mcp add beel --env BEEL_API_KEY=<BEEL_API_KEY> --env BEEL_ENV=<BEEL_ENV> -- npx -y @beel_es/mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"beel": {
"url": "https://mcp.beel.es/mcp"
}
}
}{
"mcpServers": {
"beel": {
"command": "npx",
"args": [
"-y",
"@beel_es/mcp"
],
"env": {
"BEEL_API_KEY": "<BEEL_API_KEY>",
"BEEL_ENV": "<BEEL_ENV>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"beel": {
"type": "http",
"url": "https://mcp.beel.es/mcp"
}
}
}{
"servers": {
"beel": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@beel_es/mcp"
],
"env": {
"BEEL_API_KEY": "<BEEL_API_KEY>",
"BEEL_ENV": "<BEEL_ENV>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http beel https://mcp.beel.es/mcp2Platform CLI
gemini mcp add -e BEEL_API_KEY=<BEEL_API_KEY> -e BEEL_ENV=<BEEL_ENV> beel npx -y @beel_es/mcpReplace <…> 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.