InvoiceVerify MCP
An MCP server for AI agents that validates, generates, and converts EU e-invoices (UBL, Peppol, XRechnung, Factur-X) and checks Peppol receivability, including specific Belgian client list checks under enterprise and VAT numbers.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
https://peppol-invoice-compass.lovable.app/mcpWhat you can do with it
- Validate UBL and Peppol BIS 3.0 invoices against EN 16931 rules
- Check Belgian company receivability under 0208 and 9925 Peppol IDs
- Generate Peppol UBL invoices from structured data
- Convert between UBL, CII, and Factur-X formats
Source and maintenance
Protocol and capabilities
- Server
- invoiceverify 1.2.1
- MCP protocol
- 2025-06-18
- Tools
- 9 advertised
- Resources
- Not advertised
- Resource templates
- Not advertised
- Prompts
- Not advertised
{
"tools": {
"listChanged": false
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
9 advertised
check_peppol_receivability — Check Belgian Peppol receivability (free)
Free, no sign-in needed: check whether one Belgian company can receive Peppol e-invoices under each of its two Belgian Peppol IDs — 0208 (enterprise/KBO-BCE number) and 9925 (VAT number). Returns receivable under both, only 0208, only 9925, neither or unknown, which ID to send to, the access point (service provider) per ID, and the risk and fix in English, Dutch or French. Limited to 20 checks per hour per connection; for client lists use check_belgian_peppol_list (sign-in).
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "Belgian enterprise or VAT number, e.g. BE0403170701, 0403.170.701 or 0403170701."
},
"lang": {
"enum": [
"en",
"nl",
"fr"
],
"type": "string",
"description": "Language of the explanation: en (default), nl or fr."
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}validate_invoice — Validate e-invoice
Validate a UBL 2.1, Peppol BIS Billing 3.0, XRechnung or CII / Factur-X XML invoice against EN 16931 and Peppol rules; returns pass/fail with rule IDs, line numbers and fixes. Uses one metered call. Requires an InvoiceVerify account (OAuth sign-in).
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"xml"
],
"properties": {
"xml": {
"type": "string",
"maxLength": 5242880,
"minLength": 1,
"description": "The complete invoice XML document."
},
"profile": {
"enum": [
"auto",
"peppol",
"en16931",
"xrechnung"
],
"type": "string",
"description": "Rule set to apply. 'auto' (default) detects it from the CustomizationID."
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}generate_invoice — Generate e-invoice XML
Create a Peppol BIS 3 UBL, XRechnung (UBL or CII) or Factur-X/ZUGFeRD CII XML invoice from structured invoice data, with totals and VAT computed and the result validated. Uses one metered call. Requires an InvoiceVerify account (OAuth sign-in).
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"invoice"
],
"properties": {
"format": {
"enum": [
"peppol",
"xrechnung-ubl",
"xrechnung-cii",
"cii"
],
"type": "string",
"description": "Output format. Default 'peppol' (Peppol BIS Billing 3.0 UBL)."
},
"invoice": {
"type": "object",
"description": "Invoice data: {number, issueDate (YYYY-MM-DD), dueDate?, currency?, buyerReference?, seller: Party, buyer: Party, payment?: {meansCode, iban, bic}, lines: [{name, quantity, unitPrice, unitCode?, vatCategory? (S,Z,E,AE,K,G,O), vatRate?}]}. Party: {name, vatId?, companyId?, endpointId, endpointScheme (EAS code, e.g. 0208, 9930), street?, city?, postalCode?, country (ISO 2)}. Full schema: InvoiceData in /openapi.json.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}convert_invoice — Convert e-invoice format
Convert an existing UBL or CII / Factur-X invoice XML into Peppol BIS 3 UBL, XRechnung UBL, XRechnung CII or Factur-X CII, and validate the result. Uses one metered call. Requires an InvoiceVerify account (OAuth sign-in).
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"xml",
"format"
],
"properties": {
"xml": {
"type": "string",
"maxLength": 5242880,
"minLength": 1,
"description": "The source invoice XML."
},
"format": {
"enum": [
"peppol",
"xrechnung-ubl",
"xrechnung-cii",
"cii"
],
"type": "string",
"description": "Target format, e.g. 'peppol' or 'xrechnung-ubl'."
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}parse_invoice — Read e-invoice into JSON
Read a UBL or CII / Factur-X invoice XML into structured JSON (parties, lines, VAT, totals, payment) for booking or reconciliation. Uses one metered call. Requires an InvoiceVerify account (OAuth sign-in).
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"xml"
],
"properties": {
"xml": {
"type": "string",
"maxLength": 5242880,
"minLength": 1,
"description": "The invoice XML."
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}lookup_peppol_participant — Check Peppol receivability
Check whether a company can receive Peppol e-invoices: give a VAT number, company number (KBO/BCE, KvK, SIREN/SIRET), GLN or Peppol ID and it checks every relevant scheme (e.g. Belgian 0208 and 9925) in the live Peppol SML/SMP, lists supported document types and says which ID to send to. Uses one metered call. Requires an InvoiceVerify account (OAuth sign-in).
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "VAT number (BE0403170701), company number or Peppol ID (0208:0403170701)."
},
"country": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"description": "ISO country code hint for ambiguous numbers, e.g. 'BE' or 'FR'."
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}check_belgian_peppol_list — Check a Belgian client list on Peppol
Check up to 25 Belgian companies (enterprise or VAT numbers) for Peppol receivability under both Belgian IDs — 0208 (enterprise number) and 9925 (VAT number). Returns per company: receivable under both, only 0208, only 9925, neither, or unknown, with the risk and what to fix in Dutch, French or English. Uses one metered call per valid company; unreadable numbers are free. Requires an InvoiceVerify account (OAuth sign-in).
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"companies"
],
"properties": {
"lang": {
"enum": [
"en",
"nl",
"fr"
],
"type": "string",
"description": "Language of the explanations: en (default), nl or fr."
},
"companies": {
"type": "array",
"items": {
"anyOf": [
{
"type": "string",
"maxLength": 80,
"minLength": 1
},
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "Enterprise or VAT number, e.g. BE0403170701 or 0403.170.701"
},
"name": {
"type": "string",
"maxLength": 200,
"description": "Optional client name to echo back"
}
}
}
]
},
"maxItems": 25,
"minItems": 1,
"description": "1 to 25 Belgian enterprise or VAT numbers (strings or {id, name}). Split longer lists into several calls."
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}explain_rule — Explain validation rule
Explain an EN 16931, Peppol or XRechnung business rule (e.g. BR-CO-15, PEPPOL-EN16931-R003) in plain English, Dutch or French, with typical causes and fix steps. Free. Requires an InvoiceVerify account (OAuth sign-in).
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"rule_id"
],
"properties": {
"rule_id": {
"type": "string",
"maxLength": 40,
"minLength": 2,
"description": "Rule ID as reported by validate_invoice, e.g. BR-CO-15."
},
"language": {
"enum": [
"en",
"nl",
"fr"
],
"type": "string",
"description": "Explanation language. Default 'en'."
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}get_usage — Show API usage
Show this month's metered calls, the included allowance, remaining call-pack credits and the reset date for the signed-in account. Free. Requires an InvoiceVerify account (OAuth sign-in).
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}Prompts
Not advertised
Resources
Not advertised
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 1666 ms
- 95th percentile latency
- 1666 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 1666 ms · metadata changed · 9 tool(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport http invoiceverify-mcp https://peppol-invoice-compass.lovable.app/mcpCodex
codex mcp add invoiceverify-mcp --url https://peppol-invoice-compass.lovable.app/mcpCursor
{
"mcpServers": {
"invoiceverify-mcp": {
"url": "https://peppol-invoice-compass.lovable.app/mcp"
}
}
}Cline
{
"mcpServers": {
"invoiceverify-mcp": {
"type": "streamableHttp",
"url": "https://peppol-invoice-compass.lovable.app/mcp",
"disabled": false
}
}
}VS Code
{
"servers": {
"invoiceverify-mcp": {
"type": "http",
"url": "https://peppol-invoice-compass.lovable.app/mcp"
}
}
}Gemini CLI
gemini mcp add --transport http invoiceverify-mcp https://peppol-invoice-compass.lovable.app/mcpClaude Desktop
{
"mcpServers": {
"invoiceverify-mcp": {
"url": "https://peppol-invoice-compass.lovable.app/mcp"
}
}
}Windsurf
{
"mcpServers": {
"invoiceverify-mcp": {
"serverUrl": "https://peppol-invoice-compass.lovable.app/mcp"
}
}
}Let your agent find its tools
Find servers like InvoiceVerify MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.
Other commerce servers
Do you run InvoiceVerify MCP?
Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.