getpeppr

dev.getpepprPublished by getpeppr.devOfficial publisherv1.0.3Updated Nov 7, 2026

Peppol e-invoicing: look up participants, validate invoices, and send sandbox test invoices.

VerifiedStreamable HTTPWeb executableFinanceDeveloper Tools

Overview

AI-generated overview

Sandbox-only Peppol e-invoicing helper: plans integrations, searches docs, validates invoices, looks up participants and sends test invoices.

What you can do
  • Plan an integration: get steps, code snippets and doc links for single-sender or platform setups
  • Search the public getpeppr documentation and get matching pages with excerpts
  • Validate Peppol BIS Billing 3.0 UBL or getpeppr invoice JSON and see each rule violation
  • Look up whether a Peppol identifier is registered on the production network
  • Create sandbox test customers and send test invoices to the fixed Belgian test receiver
  • Track a sandbox document's status and lifecycle events until delivered or failed
When to use it
Useful when you are building Peppol e-invoicing into an application and want an assistant to draft the integration, check invoice documents against Peppol rules, and run an end-to-end sandbox delivery test before going live.
Requirements
Remote endpoint at api.getpeppr.dev over streamable HTTP; no local install. Validation and participant lookup need no account. Account tools require signing in to getpeppr on first use, or a sandbox API key sent as a bearer token; a free account and a registered company are needed for sending.
Before you install
Sandbox only: it never sends real invoices or acts in production, and test invoices go only to the fixed test receiver. Do not submit real invoices or real people's data to validate_invoice. Account tools create test customers and send documents, and the server asks for sign-in or a sandbox API key; keep live keys out of it.

Installation

In SourceWeft

  1. Open getpeppr in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/dev.getpeppr%2Fmcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "getpeppr": {
      "type": "http",
      "url": "https://api.getpeppr.dev/mcp"
    }
  }
}

README

getpeppr MCP server

A hosted Model Context Protocol server for Peppol e-invoicing, run by getpeppr.

Your assistant can plan a getpeppr integration, search the getpeppr documentation, check a test invoice against the Peppol rules and look up a participant on the Peppol network. With a free getpeppr sandbox account, it can also send test invoices and follow their status.

This repository holds no source code. The server is hosted and operated by getpeppr (Zero Loop Labs Ltd, UK). This repository describes it for MCP registries and directories. Nothing to install: you add an address to your assistant.

Full documentation: https://getpeppr.dev/docs/mcp/

Sandbox only. The server never sends a real invoice and never acts in production. Test invoices go to the sandbox test receiver 9925:BE0314595348, and a production key (sk_live_…) is refused: keep it out of your assistant's configuration. The participant lookup, on the other hand, reads the live Peppol network.

Addresses

Registry name: dev.getpeppr/mcp · transport: streamable HTTP.

AddressWhen to use it
https://api.getpeppr.dev/mcpThe four public tools work at once, without an account. The account tools ask you to sign in the first time you use one. For clients that open a sign-in page when a tool asks, such as Claude Code and Codex.
https://api.getpeppr.dev/mcp/authAsks you to sign in to getpeppr when you connect. For clients that sign in at connection time, such as VS Code, Cursor and Claude (web & desktop).

Configure your assistant

VS Code (GitHub Copilot)

Add to .vscode/mcp.json in your workspace, or to your user mcp.json:

json
{  "servers": {    "getpeppr": {      "type": "http",      "url": "https://api.getpeppr.dev/mcp/auth"    }  }}

Or from a terminal:

bash
code --add-mcp '{"name":"getpeppr","type":"http","url":"https://api.getpeppr.dev/mcp/auth"}'

VS Code asks you to sign in to getpeppr when it connects.

Claude Code

bash
claude mcp add --transport http getpeppr https://api.getpeppr.dev/mcp

When you first call an account tool, run /mcp in Claude Code and sign in to getpeppr.

Codex

bash
codex mcp add getpeppr --url https://api.getpeppr.dev/mcpcodex mcp login getpeppr

Run the login before using the account tools.

Cursor and Claude (web & desktop)

Both connect through https://api.getpeppr.dev/mcp/auth. getpeppr is also listed in Claude's connector directory. See the documentation for the one-click Cursor install.

Signing in

Signing in uses your getpeppr account; there is no API key to copy. You choose the organisation the assistant acts for. You can also pass a sandbox API key (sk_sandbox_…) as a bearer token instead of signing in.

No account yet? Create a free sandbox account.

Tools

ToolAccountWhat it does
lookup_participantNoWhether an identifier is registered on the production Peppol network, with which provider, and what the directory says about it.
validate_invoiceNoChecks a UBL document against the official Peppol rulebooks, or a JSON invoice against the getpeppr SDK's rules. Give it sample or test invoices only, never a real invoice or real people's data.
plan_integrationNoThe steps and code for your case (your own company, or a platform sending for customers) and your countries.
search_docsNoFinds getpeppr documentation pages, each with a short excerpt.
send_test_invoiceYes, writes (sandbox)Sends a sandbox invoice to the sandbox test receiver 9925:BE0314595348.
get_document_statusYes, readsThe status of one of your documents and its event timeline.
create_test_customerYes, writes (sandbox)Platform accounts: creates a sandbox customer company to send as.

From zero to a delivered test invoice

  1. plan_integration gives the steps and code for your case; search_docs finds the pages to read.
  2. validate_invoice and lookup_participant work without an account.
  3. Create a free getpeppr account and register your own company in the console.
  4. send_test_invoice sends to the sandbox test receiver. Platform accounts first call create_test_customer, then send as that customer.
  5. get_document_status follows the document until it is delivered or failed.

Going live (an sk_live_ key, real receivers, webhooks) happens in the getpeppr console and in your own code, never through this server.

Limits

Public tools are rate limited per network address, and account tools per account. getpeppr can turn the MCP tools off without notice to protect the service; they then answer mcp.temporarily_disabled, and the API itself is not affected. Details: Limits.

Privacy and contact

Source: README.md at commit 48268d9

Tools

7

plan_integration

Plan a getpeppr integration

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.

Parametersmoderequiredcountriesrequired

search_docs

Search the getpeppr documentation

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.

Parametersqueryrequired

validate_invoice

Validate an invoice

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.

Parametersxmlformatrequiredinvoice

lookup_participant

Look up a Peppol participant

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.

ParameterspeppolIdrequired

create_test_customer

Create a sandbox test customer

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.

ParametersaddressrequiredcountryrequiredexternalIdrequiredidentifiercompanyNamerequiredidentifiers

send_test_invoice

Send a sandbox test invoice

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.

Parameterssenderinvoicerequired

get_document_status

Get a document's status

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.

ParametersdocumentIdrequired

Version history

2
  1. v1.0.3LatestNov 7, 2026
  2. v1.0.0Oct 19, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.