Beel MCP server
{
"mcpServers": {
"beel": {
"command": "npx",
"args": [
"-y",
"@beel_es/mcp@latest"
],
"env": {
"BEEL_API_KEY": "<beel_api_key>",
"BEEL_BASE_URL": "https://...",
"BEEL_DOCS_URL": "https://..."
}
}
}
}{
"mcpServers": {
"beel": {
"command": "npx",
"args": [
"-y",
"@beel_es/mcp@latest"
],
"env": {
"BEEL_API_KEY": "<beel_api_key>",
"BEEL_BASE_URL": "https://...",
"BEEL_DOCS_URL": "https://..."
}
}
}
}{
"mcpServers": {
"beel": {
"command": "npx",
"args": [
"-y",
"@beel_es/mcp@latest"
],
"env": {
"BEEL_API_KEY": "<beel_api_key>",
"BEEL_BASE_URL": "https://...",
"BEEL_DOCS_URL": "https://..."
}
}
}
}{
"servers": {
"beel": {
"command": "npx",
"args": [
"-y",
"@beel_es/mcp@latest"
],
"env": {
"BEEL_API_KEY": "${input:beel_api_key}",
"BEEL_BASE_URL": "${input:beel_base_url}",
"BEEL_DOCS_URL": "${input:beel_docs_url}"
}
}
},
"inputs": [
{
"id": "beel_api_key",
"type": "promptString",
"description": "Beel api key",
"password": true
},
{
"id": "beel_base_url",
"type": "promptString",
"description": "Beel base url",
"password": true
},
{
"id": "beel_docs_url",
"type": "promptString",
"description": "Beel docs url",
"password": true
}
]
}{
"mcpServers": {
"beel": {
"command": "npx",
"args": [
"-y",
"@beel_es/mcp@latest"
],
"env": {
"BEEL_API_KEY": "<beel_api_key>",
"BEEL_BASE_URL": "https://...",
"BEEL_DOCS_URL": "https://..."
}
}
}
}file .mcp.json (in your project root)file claude_desktop_config.jsonfile ~/.cursor/mcp.jsonfile .vscode/mcp.jsonfile ~/.codeium/windsurf/mcp_config.jsoninstall npx -y @beel_es/mcpversion 0.5.0
What it does
An MCP server that enables AI agents to issue legally compliant Spanish electronic invoices with VeriFactu registration to AEAT. It provides invoice creation, correction, customer management, and NIF validation, and can be run as a remote hosted service or locally via Node.js.
- Issue Spanish electronic invoices (F1/F2 types) and corrective invoices (R1-R5) that comply with VeriFactu regulations from an AI agent.
- Validate Spanish NIFs against the official census and manage customer records for invoicing.
- Run headless invoice operations in scheduled jobs or CI pipelines using API key authentication.
Tools this server exposes
| Tool | Does |
|---|---|
| beel_docs_search | Search the documentation. |
| beel_docs_get | Retrieve documentation content. |
| beel_docs_list | List available documentation. |
| beel_get_setup_status | Report what configuration is missing for a given NIF before it can issue invoices and the next required action. |
Before you enable it
An MCP server runs with whatever access you give it. Start with a development account rather than production, and check which tools the server exposes before you let an agent call them unattended.