Peppol e-invoicing: look up participants, validate invoices, and send sandbox test invoices.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Platform accounts only: creates a test customer (sub-tenant legal entity) in the getpeppr sandbox and returns its registration state. Up to 10 active test customers per account; identifier rules per country: https://getpeppr.dev/docs/platform/legal-entities/. Calling it again with the same arguments returns the same test customer with its current status, never a second one. Pass the returned legalEntity.id as sender.legalEntityId to send_test_invoice once its status allows sending. Requires the admin role and signing in to getpeppr.
The company's registered address.
ISO 3166-1 alpha-2, e.g. "BE".
Your own id for this customer company. Calling again with the same arguments returns the same test customer, with its current status.
The test customer company's legal name.
One Peppol identifier, e.g. { "scheme": "0208", "value": "0123456789" }.
Several identifiers, in the order the country guide gives.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Platform accounts only: creates a test customer (sub-tenant legal entity) in the getpeppr sandbox and returns its registration state. Up to 10 active test customers per account; identifier rules per country: https://getpeppr.dev/docs/platform/legal-entities/. Calling it again with the same arguments returns the same test customer with its current status, never a second one. Pass the returned legalEntity.id as sender.legalEntityId to send_test_invoice once its status allows sending. Requires the admin role and signing in to getpeppr.
| Argument | Type | Description |
|---|---|---|
| address* | object | The company's registered address. |
| country* | string | ISO 3166-1 alpha-2, e.g. "BE". |
| externalId* | string | Your own id for this customer company. Calling again with the same arguments returns the same test customer, with its current status. |
| identifier | object | One Peppol identifier, e.g. { "scheme": "0208", "value": "0123456789" }. |
| companyName* | string | The test customer company's legal name. |
| identifiers | array | Several identifiers, in the order the country guide gives. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"externalId",
"companyName",
"country",
"address"
],
"properties": {
"address": {
"type": "object",
"required": [
"line1",
"city",
"zip"
],
"properties": {
"zip": {
"type": "string",
"maxLength": 20,
"minLength": 1,
"description": "Postal code."
},
"city": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"line1": {
"type": "string",
"maxLength": 255,
"minLength": 1,
"description": "Street and number."
}
},
"description": "The company's registered address."
},
"country": {
"type": "string",
"maxLength": 2,
"minLength": 2,
"description": "ISO 3166-1 alpha-2, e.g. \"BE\"."
},
"externalId": {
"type": "string",
"maxLength": 255,
"minLength": 1,
"description": "Your own id for this customer company. Calling again with the same arguments returns the same test customer, with its current status."
},
"identifier": {
"type": "object",
"required": [
"scheme",
"value"
],
"properties": {
"value": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"scheme": {
"type": "string",
"maxLength": 40,
"minLength": 1
}
},
"description": "One Peppol identifier, e.g. { \"scheme\": \"0208\", \"value\": \"0123456789\" }."
},
"companyName": {
"type": "string",
"maxLength": 255,
"minLength": 1,
"description": "The test customer company's legal name."
},
"identifiers": {
"type": "array",
"items": {
"type": "object",
"required": [
"scheme",
"value"
],
"properties": {
"value": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"scheme": {
"type": "string",
"maxLength": 40,
"minLength": 1
}
}
},
"maxItems": 5,
"minItems": 1,
"description": "Several identifiers, in the order the country guide gives."
}
}
}Returns the status and lifecycle events of a sandbox document sent from your getpeppr account; call it with the documentId send_test_invoice returned. submitted: getpeppr accepted it. delivered: the test receiver's access point received it, the goal of a sandbox test. failed: final, with a failureCategory. In application code, subscribe to webhooks instead of polling. Requires signing in to getpeppr.
| Argument | Type | Description |
|---|---|---|
| documentId* | string | The documentId send_test_invoice returned. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"documentId"
],
"properties": {
"documentId": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "The documentId send_test_invoice returned."
}
}
}Says whether a Peppol identifier (scheme:identifier) is registered to receive documents on the production Peppol network, and which ones. A sandbox test customer is never on it, and send_test_invoice only targets the test receiver 9925:BE0314595348 whatever this answers.
| Argument | Type | Description |
|---|---|---|
| peppolId* | string | Peppol participant identifier, e.g. "9925:BE0314595348", "0208:0685660237" or "GB:VAT:123456789". |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"peppolId"
],
"properties": {
"peppolId": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Peppol participant identifier, e.g. \"9925:BE0314595348\", \"0208:0685660237\" or \"GB:VAT:123456789\"."
}
}
}Returns the integration steps, code snippets and documentation links for adding Peppol to an application, for a single sender or for a platform that sends on behalf of its customers.
| Argument | Type | Description |
|---|---|---|
| mode* | string | "single_sender": your own company sends its invoices. "platform": your software sends for many customer companies. |
| countries* | array | ISO 3166-1 alpha-2 codes of the senders' countries, e.g. ["BE", "DE"]. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"mode",
"countries"
],
"properties": {
"mode": {
"enum": [
"single_sender",
"platform"
],
"type": "string",
"description": "\"single_sender\": your own company sends its invoices. \"platform\": your software sends for many customer companies."
},
"countries": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Za-z]{2}$"
},
"maxItems": 10,
"description": "ISO 3166-1 alpha-2 codes of the senders' countries, e.g. [\"BE\", \"DE\"]."
}
}
}Searches the prose of the public getpeppr documentation and returns up to 5 matching pages, each with its url and a short excerpt. Excerpts carry no code: open the returned url, or call plan_integration, for code.
| Argument | Type | Description |
|---|---|---|
| query* | string | What to look for in the getpeppr documentation, e.g. "CustomizationID" or "webhook retries". |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "What to look for in the getpeppr documentation, e.g. \"CustomizationID\" or \"webhook retries\"."
}
}
}Sends an invoice in the getpeppr sandbox to the Belgian test receiver 9925:BE0314595348, for your own company or for one of your test customers. Never sends a real invoice. Lines without tax fields get your account's sandbox tax profile. While your sandbox tax profile is unchanged, calling it again with the same arguments returns the same document, never a second one. Returns a documentId to pass to get_document_status. Requires signing in to getpeppr.
| Argument | Type | Description |
|---|---|---|
| sender | object | Platform accounts: send as one of your test customers (the legalEntity.id create_test_customer returned). Its tax fields are then yours to set: O with vatRate 0 for a test customer without a VAT number, AE with vatRate 0 for one with a VAT number. |
| invoice* | object | An invoice in the getpeppr SDK shape (https://getpeppr.dev/docs/types/). Minimal example: {"number":"INV-001","to":{"name":"SPF Economie (test receiver)","peppolId":"9925:BE0314595348","street":"Rue du Progrès 50","city":"Brussels","postalCode":"1210","country":"BE"},"lines":[{"description":"Consulting","quantity":1,"unitPrice":1000}]}. to.peppolId must be the sandbox test receiver 9925:BE0314595348. Omit "from": the sender is your registered company. Omit the line tax fields (vatRate, vatCategory, taxExemptReason): the server applies your account's sandbox tax profile to lines that carry none. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"invoice"
],
"properties": {
"sender": {
"type": "object",
"required": [
"legalEntityId"
],
"properties": {
"legalEntityId": {
"type": "string",
"maxLength": 64,
"minLength": 1
}
},
"description": "Platform accounts: send as one of your test customers (the legalEntity.id create_test_customer returned). Its tax fields are then yours to set: O with vatRate 0 for a test customer without a VAT number, AE with vatRate 0 for one with a VAT number."
},
"invoice": {
"type": "object",
"required": [
"to"
],
"properties": {
"to": {
"type": "object",
"required": [
"peppolId"
],
"properties": {
"peppolId": {
"type": "string"
}
},
"additionalProperties": {}
}
},
"description": "An invoice in the getpeppr SDK shape (https://getpeppr.dev/docs/types/). Minimal example: {\"number\":\"INV-001\",\"to\":{\"name\":\"SPF Economie (test receiver)\",\"peppolId\":\"9925:BE0314595348\",\"street\":\"Rue du Progrès 50\",\"city\":\"Brussels\",\"postalCode\":\"1210\",\"country\":\"BE\"},\"lines\":[{\"description\":\"Consulting\",\"quantity\":1,\"unitPrice\":1000}]}. to.peppolId must be the sandbox test receiver 9925:BE0314595348. Omit \"from\": the sender is your registered company. Omit the line tax fields (vatRate, vatCategory, taxExemptReason): the server applies your account's sandbox tax profile to lines that carry none.",
"additionalProperties": {}
}
}
}Validates a Peppol BIS Billing 3.0 UBL document against the Peppol rules, or a getpeppr invoice JSON against the SDK rules, and explains each violation. It does not check whether the invoice can be sent. Send sample or test invoices only, never a real invoice or real people's data.
| Argument | Type | Description |
|---|---|---|
| xml | string | A sample or test UBL document, never a real invoice, when format is "ubl" (at most 1 MiB). |
| format* | string | "ubl" for a Peppol BIS 3 UBL document, "json" for a getpeppr SDK invoice. |
| invoice | object | A sample or test invoice in the getpeppr SDK shape, never a real one, when format is "json". |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"format"
],
"properties": {
"xml": {
"type": "string",
"description": "A sample or test UBL document, never a real invoice, when format is \"ubl\" (at most 1 MiB)."
},
"format": {
"enum": [
"ubl",
"json"
],
"type": "string",
"description": "\"ubl\" for a Peppol BIS 3 UBL document, \"json\" for a getpeppr SDK invoice."
},
"invoice": {
"type": "object",
"description": "A sample or test invoice in the getpeppr SDK shape, never a real one, when format is \"json\"."
}
}
}