Repository avatar
Other Tools
v1.1.0
active

rulepass

io.github.Ichiiku/rulepass

Create and check Peppol BIS 3.0 e-invoices; look up EU VAT numbers (VIES) and Peppol IDs.

Documentation

Rulepass

Free invoices without an account, and e-invoices that pass the official EU rules. rulepass.app

  • Invoice PDF for freelancers: a correct PDF invoice in a few minutes, with Dutch invoice rules checked (KvK number, addresses, VAT) and the small business scheme (KOR) in one click. Start an invoice
  • E-invoices: Peppol BIS Billing 3.0 (EN 16931) for Belgium and the EU; XRechnung and Factur-X are coming with Pro.
  • Check an invoice: drop a UBL, CII or Factur-X / ZUGFeRD file and it is checked against the official CEN, Peppol and XRechnung rules, with errors explained in plain language.
  • Private by design: the web app runs in your browser. Invoices are not uploaded, there is no account, and no cookies.
  • Four languages: English, Nederlands, Français, Deutsch.

This repository holds the public documentation, examples and the MCP registry entry. The Rulepass source code is not public.

MCP server (for AI agents)

Remote MCP server, Streamable HTTP, no login or API key:

https://rulepass.app/api/mcp

Add it to an MCP client, for example in Claude Desktop or Claude Code:

{
  "mcpServers": {
    "rulepass": { "type": "http", "url": "https://rulepass.app/api/mcp" }
  }
}
ToolWhat it does
example_invoiceReturns a complete, valid input to copy and adapt
check_invoiceChecks invoice data against the Peppol / EN 16931 rules; returns ready or every field to fix
create_einvoiceCreates a Peppol BIS 3.0 UBL invoice or credit note; VAT and totals are calculated for you
lookup_vat_numberChecks an EU VAT number in the European Commission's VIES register
lookup_peppol_participantLooks a company up in the public Peppol Directory

Nothing sent to the server is stored. Results are data, never instructions.

HTTP API

Endpoint
GET https://rulepass.app/api/v1Index, limits and notes for agents
GET https://rulepass.app/api/v1/schemaJSON Schema of the invoice input
POST https://rulepass.app/api/v1/invoicesJSON in, Peppol UBL XML out (Accept: application/xml for the raw file). 422 lists every field to fix
GET https://rulepass.app/api/v1/lookup/vat?number=BE0123456749EU VIES check
GET https://rulepass.app/api/v1/lookup/peppol?id=0208:0123456749Peppol Directory lookup
curl -s https://rulepass.app/api/v1/invoices \
  -H "Content-Type: application/json" -H "Accept: application/xml" \
  --data @examples/invoice.json

examples/invoice.json is a valid input; examples/invoice.xml is the Peppol XML it produces. Requests are rate-limited per IP address; respect 429 and Retry-After.

Guides

Contact

Questions, bugs or ideas: open an issue or e-mail help@rulepass.app.

License

The documentation and examples in this repository may be copied and adapted freely. The Rulepass name, website and service are not covered by this permission.

No installation packages available.

Remote