Belgium Invoices (Peppol BIS 3.0 via Storecove)

Official3 toolsLive

by junter1989k-ai · JavaScript

Belgium Peppol BIS 3.0 e-invoices for AI agents: send, check recipient, get delivery proof.

Topics

ai-agentbelgiumclaudee-invoiceinvoicemcpmcp-serverpeppolstorecovetaxvatwishpool

Captured live from the server via tools/list.

create_invoice

Send a Belgium B2B electronic invoice over the Peppol network in Peppol BIS 3.0 / EN 16931 format via Storecove (a certified Peppol Access Point). Belgium mandates structured e-invoicing for domestic B2B from 2026-01-01 (grace period to 2026-03-31; near-real-time reporting follows in 2028). Builds the structured invoice JSON from seller + buyer (name, Belgian VAT BE0xxxxxxxxx and/or enterprise number, address) and line items (description, quantity, net unit price, VAT rate 21/12/6/0), computes the Belgian VAT breakdown, and submits it under YOUR OWN Storecove credentials. Bring your own credential as header x-storecove-key. You must also pass seller_legal_entity_id — the legalEntityId of the sender you created in your Storecove account. Belgian VAT rates: 21 (standard), 12, 6 (reduced), 0 (zero-rated/exempt/reverse charge). Amounts in EUR. Delivery over Peppol is asynchronous: this returns a submission guid — use get_delivery_evidence with it to fetch the delivery proof/status. Tip: call check_recipient first to confirm the buyer is reachable on Peppol. There is no cancel over Peppol: to reverse an invoice you issue a credit note (a new invoice).

Parameters24

seller_legal_entity_id	string	required	REQUIRED. The Storecove legalEntityId of the sender (created in your Storecove account under Senders). Numeric id, passed through to Storecove.
seller_name	string	required	Seller legal/company name.
seller_vat	string	optional	Seller Belgian VAT number, format BE0xxxxxxxxx (BE + 10 digits). Provide this and/or seller_enterprise_number.
seller_enterprise_number	string	optional	Optional seller Belgian enterprise number (KBO/BCE), 10 digits (0xxxxxxxxx).
seller_address	string	required	Seller street address.
seller_city	string	required	Seller city.
seller_zip	string	required	Seller postal code.
seller_country	string	optional	Seller country code. Default BE.
customer_name	string	required	Buyer legal/company name.
customer_vat	string	optional	Buyer Belgian VAT number BE0xxxxxxxxx. Provide this and/or customer_enterprise_number (used to route on Peppol if no explicit recipient id is given).
customer_enterprise_number	string	optional	Optional buyer Belgian enterprise number (KBO/BCE), 10 digits.
customer_address	string	required	Buyer street address.
customer_city	string	required	Buyer city.
customer_zip	string	required	Buyer postal code.
customer_country	string	optional	Buyer country code. Default BE.
recipient_peppol_scheme	string	optional	Optional explicit Peppol routing scheme (EAS/ISO6523). Belgium: 0208 (enterprise number) or 9925 (VAT). Default 0208 when routing by enterprise number.
recipient_peppol_id	string	optional	Optional explicit Peppol participant identifier to route to (overrides deriving from the customer VAT/enterprise number).
recipient_email	string	optional	Optional email fallback — used if the recipient is not on Peppol (Storecove can email a copy).
invoice_number	string	optional	Invoice number. Auto-generated if omitted.
issue_date	string	optional	Invoice issue date, YYYY-MM-DD. Default: today (UTC).
due_date	string	optional	Optional payment due date, YYYY-MM-DD.
currency	string	optional	Document currency. Default EUR.
note	string	optional	Optional free-text note on the invoice.
lines	array	required	Invoice line items. Each: description, unit_price (net, VAT-exclusive, EUR), vat_rate (21\|12\|6\|0), optional quantity (default 1), optional tax_category (S standard / Z zero-rated / E exempt / AE reverse charge; default S for rate>0, Z for rate 0), optional item_name.

Raw schema

{
  "type": "object",
  "properties": {
    "seller_legal_entity_id": {
      "type": "string",
      "description": "REQUIRED. The Storecove legalEntityId of the sender (created in your Storecove account under Senders). Numeric id, passed through to Storecove."
    },
    "seller_name": {
      "type": "string",
      "description": "Seller legal/company name."
    },
    "seller_vat": {
      "type": "string",
      "description": "Seller Belgian VAT number, format BE0xxxxxxxxx (BE + 10 digits). Provide this and/or seller_enterprise_number."
    },
    "seller_enterprise_number": {
      "type": "string",
      "description": "Optional seller Belgian enterprise number (KBO/BCE), 10 digits (0xxxxxxxxx)."
    },
    "seller_address": {
      "type": "string",
      "description": "Seller street address."
    },
    "seller_city": {
      "type": "string",
      "description": "Seller city."
    },
    "seller_zip": {
      "type": "string",
      "description": "Seller postal code."
    },
    "seller_country": {
      "type": "string",
      "description": "Seller country code. Default BE."
    },
    "customer_name": {
      "type": "string",
      "description": "Buyer legal/company name."
    },
    "customer_vat": {
      "type": "string",
      "description": "Buyer Belgian VAT number BE0xxxxxxxxx. Provide this and/or customer_enterprise_number (used to route on Peppol if no explicit recipient id is given)."
    },
    "customer_enterprise_number": {
      "type": "string",
      "description": "Optional buyer Belgian enterprise number (KBO/BCE), 10 digits."
    },
    "customer_address": {
      "type": "string",
      "description": "Buyer street address."
    },
    "customer_city": {
      "type": "string",
      "description": "Buyer city."
    },
    "customer_zip": {
      "type": "string",
      "description": "Buyer postal code."
    },
    "customer_country": {
      "type": "string",
      "description": "Buyer country code. Default BE."
    },
    "recipient_peppol_scheme": {
      "type": "string",
      "description": "Optional explicit Peppol routing scheme (EAS/ISO6523). Belgium: 0208 (enterprise number) or 9925 (VAT). Default 0208 when routing by enterprise number."
    },
    "recipient_peppol_id": {
      "type": "string",
      "description": "Optional explicit Peppol participant identifier to route to (overrides deriving from the customer VAT/enterprise number)."
    },
    "recipient_email": {
      "type": "string",
      "description": "Optional email fallback — used if the recipient is not on Peppol (Storecove can email a copy)."
    },
    "invoice_number": {
      "type": "string",
      "description": "Invoice number. Auto-generated if omitted."
    },
    "issue_date": {
      "type": "string",
      "description": "Invoice issue date, YYYY-MM-DD. Default: today (UTC)."
    },
    "due_date": {
      "type": "string",
      "description": "Optional payment due date, YYYY-MM-DD."
    },
    "currency": {
      "type": "string",
      "description": "Document currency. Default EUR."
    },
    "note": {
      "type": "string",
      "description": "Optional free-text note on the invoice."
    },
    "lines": {
      "type": "array",
      "minItems": 1,
      "description": "Invoice line items. Each: description, unit_price (net, VAT-exclusive, EUR), vat_rate (21|12|6|0), optional quantity (default 1), optional tax_category (S standard / Z zero-rated / E exempt / AE reverse charge; default S for rate>0, Z for rate 0), optional item_name.",
      "items": {
        "type": "object",
        "properties": {
          "description": {
            "type": "string",
            "description": "Line description."
          },
          "unit_price": {
            "type": "number",
            "description": "Net unit price in EUR, VAT-exclusive."
          },
          "vat_rate": {
            "type": "number",
            "description": "Belgian VAT rate percent: 21 (standard), 12, 6 (reduced), or 0."
          },
          "quantity": {
            "type": "number",
            "description": "Quantity. Default 1."
          },
          "tax_category": {
            "type": "string",
            "description": "Optional EN 16931 tax category: S / Z / E / AE. Default derived from vat_rate."
          },
          "item_name": {
            "type": "string",
            "description": "Optional item name (defaults to description)."
          }
        },
        "required": [
          "description",
          "unit_price",
          "vat_rate"
        ]
      }
    }
  },
  "required": [
    "seller_legal_entity_id",
    "seller_name",
    "seller_address",
    "seller_city",
    "seller_zip",
    "customer_name",
    "customer_address",
    "customer_city",
    "customer_zip",
    "lines"
  ]
}

check_recipient

Check whether a business can receive electronic invoices on the Peppol network before you send (Storecove POST /discovery/receives). This is the safe pre-flight for Belgian B2B: pass the recipient identifier and scheme and learn if they are a registered Peppol participant. For Belgium use scheme 0208 with the 10-digit enterprise number (KBO/BCE), or 9925 with the VAT number BE0xxxxxxxxx. Returns can_receive=true when the party is reachable (Storecove code OK). If can_receive is false, the recipient is not on Peppol — fall back to recipient_email in create_invoice or ask them to register.

Parameters4

identifier	string	required	The recipient Peppol identifier. Belgium: the 10-digit enterprise number (scheme 0208) or the VAT number BE0xxxxxxxxx (scheme 9925).
scheme	string	optional	Peppol/ISO6523 scheme. Default 0208 (Belgian enterprise number). Use 9925 for a Belgian VAT number.
network	string	optional	Network to check. Default peppol.
document_types	array	optional	Document types to check receipt for. Default ["invoice"].

Raw schema

{
  "type": "object",
  "properties": {
    "identifier": {
      "type": "string",
      "description": "The recipient Peppol identifier. Belgium: the 10-digit enterprise number (scheme 0208) or the VAT number BE0xxxxxxxxx (scheme 9925)."
    },
    "scheme": {
      "type": "string",
      "description": "Peppol/ISO6523 scheme. Default 0208 (Belgian enterprise number). Use 9925 for a Belgian VAT number."
    },
    "network": {
      "type": "string",
      "description": "Network to check. Default peppol."
    },
    "document_types": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Document types to check receipt for. Default [\"invoice\"]."
    }
  },
  "required": [
    "identifier"
  ]
}

get_delivery_evidence

Fetch the delivery evidence for an invoice sent by create_invoice, using its submission guid (Storecove GET /document_submissions/{guid}/evidence). Peppol delivery is asynchronous — this returns the proof of what was sent and the delivery status/receipt from the recipient Access Point. Call it shortly after create_invoice and poll until it reports delivery. Safe to call anytime.

Parameters1

guid

string

required

The submission guid returned by create_invoice.

Raw schema

{
  "type": "object",
  "properties": {
    "guid": {
      "type": "string",
      "description": "The submission guid returned by create_invoice."
    }
  },
  "required": [
    "guid"
  ]
}

README.md6 KBView on GitHub

Belgium Invoice MCP 🇧🇪 — How can my AI agent send a Peppol e-invoice in Belgium?

Use it in 60 seconds

Paste this into your MCP client config (Claude Desktop, Cursor, Windsurf, or any MCP-capable agent):

json

{
  "mcpServers": {
    "belgium-invoice": {
      "type": "http",
      "url": "https://inv-be.wishpool.app/mcp"
    }
  }
}

Nothing to install. Credentials, when you need them, travel as HTTP headers on each request and are never stored — see the threat model.

Or run it yourself

Would you rather not send production credentials to a server you do not control? Deploy this identical code to your own account and point your agent at your own URL:

bash

git clone https://github.com/junter1989k-ai/belgium-invoice-mcp && cd belgium-invoice-mcp && npx vercel --prod

MIT-licensed. Self-hosting removes us from the picture entirely, at no cost and with no loss of function.

Remote MCP server that lets any AI agent send Belgium B2B electronic invoices over the Peppol network in Peppol BIS 3.0 / EN 16931 format via Storecove, a certified Peppol Access Point. It builds the structured invoice, computes the Belgian VAT breakdown, and delivers it under the merchant's own Storecove account. Stateless, bring-your-own credentials, never stores anything.

Live endpoint: https://inv-be.wishpool.app/mcp · Registry: app.wishpool/belgium-invoice-mcp

Why now — the 2026 mandate

Belgium mandates structured e-invoicing over Peppol BIS 3.0 for domestic B2B from 2026-01-01 (grace period to 2026-03-31); near-real-time e-reporting follows in 2028. Paper and plain-PDF invoices no longer satisfy the B2B obligation.

Quick start

json

{
  "mcpServers": {
    "belgium-invoice": {
      "type": "http",
      "url": "https://inv-be.wishpool.app/mcp",
      "headers": {
        "x-storecove-key": "your-storecove-api-key"
      }
    }
  }
}

Sign up at storecove.com — the merchant is the Peppol Access Point account holder. Request a free 30-day sandbox account from Storecove for a test key (sandbox does not need production onboarding). Create your sender under Senders to get the legalEntityId you pass as seller_legal_entity_id. Sandbox vs production is determined by the account your key belongs to — the base URL is the same. Authentication is HTTP Bearer with your key. Your key stays with you and travels per-request; this server never stores it.

Tools

Tool	What it does
`check_recipient`	Peppol participant discovery — is the buyer reachable on Peppol before you send? Pass the identifier (enterprise number scheme `0208`, or VAT scheme `9925`). Returns `can_receive`. The safe pre-flight.
`create_invoice`	Build a Peppol BIS 3.0 invoice from seller + buyer (Belgian VAT `BE0xxxxxxxxx` / enterprise number, address) and line items (description, net unit price, VAT rate 21/12/6/0, quantity), then submit over Peppol via Storecove. Returns a submission `guid` + computed VAT totals (`taxable`, `vat`, `total`).
`get_delivery_evidence`	Fetch the proof of what was sent and the Peppol delivery status by `guid`.

Amounts are in EUR. Belgian VAT rates: 21 (standard), 12, 6 (reduced), 0 (zero-rated/exempt/reverse charge). Parties identified by Belgian VAT (BE0xxxxxxxxx) and/or enterprise number (KBO/BCE, 10 digits).

No cancel over Peppol — to reverse an invoice you issue a credit note (a new invoice). create_invoice needs seller_legal_entity_id (your Storecove sender id). Owner policy guardrails ride optional headers (x-agentpay-max-amount, x-agentpay-approval-above, x-agentpay-allowed-tools) — set by the human owner in client config; the agent cannot relax them.

VAT math (deterministic)

Per line amountExcludingVat = round2(quantity × unit_price); grouped by (rate, category) into taxSubtotals (taxableAmount, taxAmount = round2(taxable × rate / 100)); gross amountIncludingVat = taxable + tax. Examples:

100 + 50 both @21% → taxable 150.00 / vat 31.50 / total 181.50
200 @21% + 100 @6% → taxable 300.00 / vat 48.00 (42 + 6) / total 348.00
2×50 @21% + 3×10 @6% + 1×25 @0% → taxable 155.00 / vat 22.80 (21 + 1.80 + 0) / total 177.80

Endpoints wrapped (Storecove REST)

Base: https://api.storecove.com/api/v2 (single base URL; auth = HTTP Bearer with your API key)
Send: POST /document_submissions — JSON { legalEntityId, routing, document:{ documentType:"invoice", invoice:{…} } } → { guid }
Evidence: GET /document_submissions/{guid}/evidence — proof of what was sent + Peppol delivery status
Discovery: POST /discovery/receives — JSON { documentTypes, network, metaScheme, scheme, identifier } → { code:"OK", email }
Verified probe (2026-07-10): a fake Bearer key really hits api.storecove.com/api/v2 → 403 {"errors":[{"source":"generic","details":"Not Authorized"}]} (endpoint alive; BYO = the merchant's own key validates).

Develop

bash

node test/serve.js   # local server on :3236
node test/e2e.js     # VAT math + Peppol JSON structure + protocol + validation + policy + fake-key live probe

Safety

Pure stateless translation layer over the Storecove REST API. Storecove is the certified Peppol Access Point under the merchant's own account; this service never signs, never onboards, and never stores anything. The API key travels per-request in a header, and funds are never touched — this issues tax invoices, it does not move money. Privacy policy.

Sister servers

Local invoices, one family: Italy FatturaPA (inv-it) · Malaysia MyInvois (inv-my) · Mexico CFDI (inv-mx) · Brazil NF-e (inv-br) · India GST (inv-in). Storecove also covers the Netherlands, Luxembourg and the Nordics on Peppol — those sister countries replicate this exact server. Local logistics: logi.wishpool.app. Local payments in 81 countries: mcp.wishpool.app.

MIT licensed.

Install

Tools (3)

create_invoicecheck_recipientget_delivery_evidence

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://inv-be.wishpool.app/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "belgium-invoice-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://inv-be.wishpool.app/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.