Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.e-invoice.be/llms.txt

Use this file to discover all available pages before exploring further.

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