Tools & prompts
Every tool the BeeL. MCP server exposes, the guided workflow prompts, and the inline invoice PDF viewer.
Through the BeeL. MCP server your assistant can do everything the BeeL. API offers — issue and manage invoices, customers, products, NIFs, payments and more — plus a few helper tools and guided prompts that keep fiscal steps in the right order. The tool set covers the whole API and grows with it.
Tools are named beel_<action> and grouped by resource. Each needs specific scopes; the assistant can only use a tool if the scopes you approved on the consent screen cover it.
Helper tools
A few tools help the assistant orient itself before it acts:
| Tool | Description |
|---|---|
beel_get_setup_status | One-call checklist of every NIF's readiness with a recommended next action — the fastest way to see what's missing. |
beel_docs_search | Search these docs from inside the client. |
beel_docs_get | Read a documentation page in full. |
beel_docs_list | List the available documentation pages. |
Guided prompts
Prompts are templates you invoke like a command; they seed the conversation with the correct order of operations so the assistant doesn't skip a fiscal step.
| Prompt | What it does |
|---|---|
issue-invoice | Issue a compliant invoice: F1 vs F2, validate the NIF, set regime keys, clear the VeriFactu gates. |
fix-invoice | Fix an issued invoice the right way: void (anulación) vs corrective (rectificativa R1–R5). |
onboard-nif | Get a NIF ready to issue Live end to end: readiness → default series → VeriFactu → payments → first Test invoice. |
setup-representation | Set up the AEAT fiscal representation (apoderamiento) a NIF needs for VeriFactu — resolves the NIF_REPRESENTATION_REQUIRED blocker. |
invite-member | Invite a collaborator (gestoría) or teammate and grant the right role, account-wide or per-NIF. |
connect-payments | Connect Stripe to a NIF or account-wide, and verify it is active. |
upgrade-integration | Bring an existing BeeL. API integration up to current best practices. |
Inline invoice PDF
When the assistant fetches an invoice PDF, the BeeL. MCP server returns it as an MCP App: a client that supports MCP UI (such as Claude) renders the invoice inline in the chat as an embedded viewer, instead of a bare download link — so you review the document without leaving the conversation.
Tool catalogue
Every tool the server exposes, grouped by resource, with the scopes each one needs.
Overview
Connect AI assistants to BeeL. through the Model Context Protocol — issue compliant invoices, manage NIFs and customers, and read your fiscal data in natural language, with VeriFactu guardrails built in.
Claude Code
Use the BeeL. plugin for Claude Code to implement, audit, and maintain BeeL. API integrations with AI assistance.