Konnektor Pingen

Wofür er sich eignet

• Schweizer KMU, die Rechnungen, Verträge oder Mahnungen per Post verschicken
• Assistenten, die den Mahnlauf automatisieren
• Sammelsendungen und Aussendungen an viele Empfänger
• Treuhand- und Agenturbetriebe, die eBill-Rechnungen für Kunden einreichen
• Abläufe, die einen Postweg brauchen, ohne einen eigenen Drucker einzurichten

Tools (19)

• pingen_letter_list: List letters in your Pingen organisation with optional filters (status, date range) and pagination. Returns letter UUIDs, status, file info, and delivery details.
• pingen_letter_get: Get a single letter by UUID. Returns full attributes: status, delivery_product, print_mode, print_spectrum, file_url, tracking_number, timestamps.
• pingen_letter_calculate_price: Estimate the price (currency + amount) for sending a letter with given delivery and print settings. Required args: country (ISO code, e.g. 'CH'), paper_types (array, e.g. ['normal']). Call this BEFORE pingen_letter_send to surface the cost in the confirmation summary.
• pingen_letter_create: Upload a base64-encoded PDF and create a draft letter. auto_send is hard-forced to false - the draft must be reviewed and explicitly sent via pingen_letter_send. The recipient address must be visible in the PDF's address window.
• pingen_letter_edit: Update delivery_product, print_mode, print_spectrum, address_position, or meta_data on a draft letter (status validating or valid). Cannot edit a letter that's already been sent.
• pingen_letter_send: BILLING IMPACT: trigger postal delivery of a draft letter. Requires α-confirmation (2-phase): Phase 1 returns a confirm_token + cost summary; Phase 2 with the token executes the send. Bulk-mode supported: pass ids[] instead of id to send up to 200 letters with ONE confirmation.
• pingen_letter_cancel: Cancel a draft letter before it's submitted to the printer. α-gated (requires confirm_token). Bulk-mode supported via ids[]. Cannot cancel letters in status action_required, sending, sent, or delivered (the API returns 409).
• pingen_letter_delete: Soft-delete a letter from your Pingen account data view. α-gated (requires confirm_token). Bulk-mode supported via ids[]. Subject to Pingen's data retention policy; irreversible from user perspective.
• pingen_letter_list_issues: Fetch validation issues for a specific letter (e.g. file_too_many_pages, address_invalid). Use this to debug why a letter ended up in status invalid or action_required.
• pingen_batch_list: List mass-mailing batches in your Pingen organisation with filters and pagination.
• pingen_batch_get: Fetch batch details by UUID. Optionally include embedded letters via ?include=letters.
• pingen_batch_create: Upload a multi-page PDF (one address per page or section) and create a batch. auto_send is hard-forced to false; review the batch then call pingen_batch_send to dispatch.
• pingen_batch_send: BILLING IMPACT: dispatch a batch of letters. α-gated. Bulk-mode supported (multiple batches in one confirmation). One batch may contain dozens or hundreds of letters; the per-letter price applies.
• pingen_batch_cancel: Cancel a batch that hasn't reached the printer yet. α-gated. Bulk-mode supported.
• pingen_ebill_list: List Swiss eBill submissions in your Pingen organisation. eBill is Pingen's early-access integration with the SIX e-billing network - only Swiss recipients with active eBill registration.
• pingen_ebill_get: Fetch a single eBill submission by UUID, including its status and submission details.
• pingen_ebill_create: BILLING IMPACT: submit a PDF invoice to the Swiss SIX eBill network via Pingen. α-gated. The recipient must be eBill-registered in their bank's online portal.
• pingen_organisation_list: List all Pingen organisations this user has access to. Useful when PINGEN_ORGANISATION_ID is not set and the server reports multiple orgs - pick the right UUID from this list.
• pingen_organisation_get: Get organisation details: name, plan (free/paid), billing_currency (CHF/EUR), billing_balance, default_country, default_address_position. Useful to check credit balance before a big send.

Beispielanfragen

• “Schick dieses Rechnungs-PDF als B-Post-Brief an meinen Kunden in Bern”
• “Was kostet ein vierseitiger Farbbrief nach Deutschland mit schneller Zustellung?”
• “Verschick 50 Rechnungs-PDFs als Sammelsendung, einseitig und in Graustufen”
• “Zeig mir alle nicht versendeten Briefentwürfe der letzten Woche”
• “Warum steht Brief abc123 auf ungültig? Liste die Beanstandungen auf”
• “Reiche dieses PDF als Schweizer eBill ins SIX-Netz ein”
• “Wie hoch ist mein Pingen-Guthaben und auf welchem Tarif bin ich?”

Einrichten

Von AIWerk betreiben lassen, ohne eigene Installation, oder selbst auf dem eigenen Rechner starten:

npx @aiwerk/mcp-server-pingen@0.1.0

Pingen ist einer von vielen Konnektoren im AIWerk-Katalog. Jeder Konnektor ist signiert und geprüft. Sie können ihn selbst auf Ihrem Rechner installieren oder von AIWerk betreiben lassen.