Skip to main content
The Model Context Protocol (MCP) is an open standard that lets AI assistants interact with external services. Think of it as a USB-C port for AI — one protocol to connect any AI tool to e-invoice.be. The e-invoice.be MCP server provides 12 read-only tools that give AI agents access to your invoices, credit notes, Peppol network data, and usage statistics.
All MCP tools are read-only. No data can be created, modified, or deleted through MCP. To create or send documents, use the REST API.

​
Quick Start

Server URL: https://api.e-invoice.be/mcp Connect using your existing API key — the same one you use for the REST API. 
claude mcp add e-invoice \
  -- --header "Authorization: Bearer YOUR_API_KEY" \
  https://api.e-invoice.be/mcp
Don’t have an API key yet? See the Authentication guide to get started.

​
Available Tools

​
Documents

ToolDescription
get_documentRetrieve a single invoice or credit note by ID, including line items, tax details, payment info, and attachments
get_document_attachmentsList all attachments for a document
get_document_attachmentGet a specific attachment with a signed download URL (valid for 1 hour)
get_document_timelineGet the chronological event history for a document (creation, validation, transmission, delivery)

​
Inbox

ToolDescription
get_inboxList all received documents with filtering by type, sender, date range, and full-text search
get_inbox_invoicesList only received invoices
get_inbox_credit_notesList only received credit notes

​
Outbox

ToolDescription
get_outboxList all sent documents with filtering by receiver, date range, and full-text search

​
Drafts

ToolDescription
get_draftsList draft documents with filtering by state (DRAFT, TRANSIT, FAILED), type, and date range

​
Peppol Lookup

These tools are public and do not require authentication.
ToolDescription
get_lookup_peppol_idVerify if a participant is registered on the Peppol network and retrieve their supported document types
get_lookup_participantsSearch for Peppol participants by name, with optional country filter

​
Statistics

ToolDescription
get_statsRetrieve sending and receiving statistics, grouped by day, week, or month

​
Example Prompts

Once connected, you can interact with your e-invoice.be account using natural language. Here are some examples:
  • “Show me all invoices received this month”
  • “Get the details and timeline of document doc_abc123”
  • “Is the company with VAT number BE0848934496 registered on Peppol?”
  • “Search for Peppol participants named ‘OpenPeppol’ in Belgium”
  • “Show my sending and receiving stats for the last 3 months, aggregated by month”
  • “List all failed documents in my drafts”
  • “What attachments are on invoice doc_xyz789?”

​
Security

Your API key gives MCP access to all data within your tenant. Treat it with the same care as any API credential.
  • Read-only access — MCP tools cannot create, modify, or delete any data
  • Tenant-scoped — your API key determines which tenant’s data is accessible
  • Lookup tools are public — get_lookup_peppol_id and get_lookup_participants work without authentication
  • Best practice — consider using a dedicated API key for MCP access, separate from your application’s key

​
Next Steps

Authentication

Get your API key and learn about authentication

API Reference

Full REST API for creating and sending documents

Webhooks

Receive real-time notifications for document events