# BeeL

> BeeL is a freemium MCP server for finance and payments. Issue Spanish VeriFactu invoices and manage NIFs and customers from an AI assistant. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI
- **Website:** https://docs.beel.es/mcp
- **Repository:** https://github.com/beel-es/beel-mcp
- **MCP Registry name:** es.beel/mcp
- **Categories:** finance and payments, legal and government
- **Listing updated:** 2026-11-14

## About

BeeL's server lets an assistant carry out an invoice from start to finish: choose between standard (F1) and simplified (F2), validate the NIF, set regime keys and clear the VeriFactu checks before issuing. For mistakes it distinguishes voiding from a corrective invoice (R1 to R5), and it can walk a NIF through onboarding until it can issue live.

Guardrails are part of the design. Issuing tools report blockers such as ENV_MISMATCH, NIF_NOT_REGISTERED and NIF_REPRESENTATION_REQUIRED instead of failing blindly, invoice creation carries an idempotency key so a retry never duplicates an invoice, and you approve scopes on the consent screen. Connecting means working with live data unless you pick the Test sandbox there.

The hosted server is at mcp.beel.es/mcp, with OAuth or an API-key bearer token, and an npm package is available for stdio. It can also preview an invoice PDF in chat.

## Features

- **End-to-end invoicing:** Handles F1 and F2 invoices, NIF validation and regime keys.
- **Corrections:** Voids or issues corrective invoices R1 to R5.
- **NIF onboarding:** Gets a NIF ready to issue live with series, VeriFactu and payments.
- **Idempotent writes:** A retried request never duplicates a VeriFactu invoice.
- **Scoped OAuth:** Approve scopes and choose Test or Live on the consent screen.
- **Bulk customers and products:** Manages customers and products, in bulk when needed.

## Good for

- Issue an invoice by describing it in chat
- Fix a wrong invoice with a corrective R1 to R5
- Validate a customer's NIF before billing
- Read fiscal summaries and usage
- Test the flow in sandbox before going live

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.beel.es/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.beel.es/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.beel.es/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://mcp.beel.es/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.beel.es/mcp"
    }
  }
}
```

## FAQ

### What does BeeL cost?

Sandbox is free with no card or time limit. Live NIFs cost 19 euros per month (or 180 euros per year) each, excluding VAT, with extra invoices past those included at 0.01 euros each.

### How does it sign in?

OAuth 2.1 with PKCE, or a BeeL API key as a bearer token. Test keys start beel_sk_test_ and live keys beel_sk_live_.

### Can I try it without touching live data?

Yes, pick the sandbox (Test) environment on the consent screen.

### Is there anything to install?

No for the hosted server; there is also an npm package for stdio use.

### Is BeeL free?

BeeL has a free plan, with paid plans for more usage or features.

### How do I add BeeL to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://mcp.beel.es/mcp

### What are the best alternatives to BeeL?

The closest alternatives to BeeL are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, NY LLC Publication (FileMyPublication) and Quantivex Research.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [NY LLC Publication (FileMyPublication)](https://ai-powered.com/mcp/ny-llc-publication-filemypublication): NY LLC Publication (FileMyPublication) is a free MCP server for legal and government.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [SupplyClub Catalog](https://ai-powered.com/mcp/supplyclub-catalog): SupplyClub Catalog is a free MCP server for legal and government.

---
Source: https://ai-powered.com/mcp/beel
