getpeppr

dev.getpeppr由 getpeppr.dev 发布官方发布者v1.0.3更新于 Nov 7, 2026

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

已验证Streamable HTTP可网页运行金融知识与记忆开发者工具

概览

AI 生成的概览

仅限沙箱的 Peppol 电子发票助手:规划集成、检索文档、校验发票、查询参与者并发送测试发票。

可以做什么
  • 规划集成:获取单发送方或平台场景的步骤、代码片段与文档链接
  • 检索 getpeppr 公开文档并返回匹配页面及摘要
  • 校验 Peppol BIS Billing 3.0 UBL 或 getpeppr 发票 JSON,并逐条说明违规
  • 查询某个 Peppol 标识是否已在生产网络注册
  • 创建沙箱测试客户,并向固定的比利时测试接收方发送测试发票
  • 跟踪沙箱单据的状态与生命周期事件,直到送达或失败
适用场景
适合正在把 Peppol 电子发票接入应用的开发者:让助手起草集成方案、按 Peppol 规则检查发票文档,并在上线前完成一次端到端沙箱投递测试。
运行要求
通过 streamable HTTP 连接 api.getpeppr.dev 远程端点,无需本地安装。校验与参与者查询无需账号。账号类工具首次使用时需登录 getpeppr,或以 bearer 方式提供沙箱 API 密钥;发送还需免费账号及已注册的公司。
安装前请注意
仅限沙箱:不会发送真实发票,也不会在生产环境操作,测试发票只发往固定的测试接收方。不要向 validate_invoice 提交真实发票或真实个人数据。账号类工具会创建测试客户并发送单据,服务器会要求登录或沙箱 API 密钥;不要在其中使用正式密钥。

安装

在 SourceWeft 中

  1. 打开 控制台中的 getpeppr,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/dev.getpeppr%2Fmcp/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "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

来源:README.md,提交 48268d9

工具

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.

输入参数mode必填countries必填

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.

输入参数query必填

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.

输入参数xmlformat必填invoice

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.

输入参数peppolId必填

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.

输入参数address必填country必填externalId必填identifiercompanyName必填identifiers

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.

输入参数senderinvoice必填

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.

输入参数documentId必填

版本历史

2
  1. v1.0.3最新Nov 7, 2026
  2. v1.0.0Oct 19, 2026

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。