pingen-mcp-server
Summary: You can operate Pingen's physical mail, eBill, email, webhook, and account APIs through 49 MCP tools with OAuth support and JSON:API pass-through responses.
Manage letters: list/create/show/delete/send/cancel, fetch PDF redirects, calculate prices, and view per-letter and organisation-wide delivery events/images.
Manage batches: list/create/edit/show/delete/send/cancel, fetch statistics, and list events.
Manage eBills: list/create/show/delete/send/cancel, fetch file redirects, and view events/images.
Manage emails: list/create/show/delete/cancel, fetch file redirects, and view events/images.
Manage organisation webhook registrations: list/create/show/delete.
Read account directory data: authenticated user, user associations, organisations list/details.
Register file uploads and get upload destination metadata.
Use pagination and pass-through query parameters such as sort, filter, include, fields, and q.
Run over stdio or streamable HTTP with JWT resource-server auth and either client-credentials or authorization-code OAuth flows.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@pingen-mcp-server Mail my PDF as a physical letter to 123 Main Street."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
pingen-mcp-server
Open-source MCP (Model Context Protocol) server for the Pingen API — programmable physical mail, email and eBill dispatch.
49 MCP tools — one per client-callable operation of the official Pingen OpenAPI specification (v2.0.0, JSON:API), with both OAuth 2.0 grant types supported. Responses are JSON:API documents passed through unchanged, so what you get back is exactly what the API returns.
Implementation is tracked in the a2aorch registry (project PINGEN) and planned with OpenSpec.
Scope
Domain | Tools | Covers |
Letters | 14 | list/create/show/delete/send/cancel, file, price calculator, events (per-letter + organisation-wide) |
Batches | 9 | list/create/show/edit/delete/send/cancel, statistics, events |
eBills | 9 | list/create/show/delete/send/cancel, file, events, event image |
Emails | 8 | list/create/show/delete/cancel, file, events, event image |
Webhooks | 4 | organisation webhook registrations (list/create/show/delete) |
User / Organisations / Associations | 4 | authenticated user, associations, organisation list/details |
Files | 1 | file-upload registration |
The five incoming webhook payload shapes (/your-webhook-url-for-*) are documentation, not tools — see Incoming webhooks.
Related MCP server: pingen-mcp
Install
git clone https://github.com/Elliot-Construct/pingen-mcp-server.git
cd pingen-mcp-server
python -m venv .venv
.venv/bin/pip install -e . # Windows: .venv\Scripts\pip install -e .Verify — no credentials required to list the tools:
python -c "import asyncio; from pingen_mcp_server.server import mcp; print(len(asyncio.run(mcp.list_tools())), 'tools')"Run the test suite (all HTTP mocked — no network, no credentials):
.venv/bin/pip install -e '.[dev]'
.venv/bin/python -m pytestMCP client configuration
{
"mcpServers": {
"pingen": {
"command": "/path/to/pingen-mcp-server/.venv/bin/python",
"args": ["-m", "pingen_mcp_server.server"],
"env": {
"PINGEN_ENVIRONMENT": "staging",
"PINGEN_GRANT_TYPE": "client_credentials",
"PINGEN_ENV_FILE": "/secure/location/credentials.env"
}
}
}
}pingen-mcp-server (installed console script) and python -m pingen_mcp_server.server both start the server over stdio.
Configuration
All configuration is environment-driven. Secrets never live in this repository.
Variable | Required | Default | Notes |
| no |
|
|
| no |
|
|
| yes* | – | from your Pingen developer app |
| no | – | path to an env file with the keys above (used when not set in the process environment) |
| auth-code only | – | registered redirect URI for the authorization-code grant |
| no | app defaults | space-separated scopes ( |
| no |
| access/refresh token storage, always outside the repo |
| no | env defaults | overrides, mainly for tests |
* needed when a tool actually fetches a token; listing tools works without them.
Environments
Resource API | Identity (tokens) | |
Production |
|
|
Staging |
|
|
Staging is a fully separate 1:1 environment — register at https://identity-staging.pingen.com/auth/register and create separate developer-app credentials. Letters are simulated (nothing is printed).
Authentication
Client credentials (default, server-to-server)
On first tool use the server POSTs grant_type=client_credentials to the identity host, caches the access token until expires_in minus a 60-second skew, then re-fetches automatically. This grant issues no refresh token.
Authorization code (delegated access to a foreign account)
Interactive flows cannot complete inside an MCP tool call, so the exchange is driven through the auth module's Python API:
from pingen_mcp_server.auth import provider_for
from pingen_mcp_server.config import load_config
provider = provider_for(load_config())
step1 = provider.build_authorize_url()
# Open step1["url"] in a browser; the user consents; the redirect
# carries ?code=...&state=...
provider.exchange_code(
code="...", # from the redirect
state="...", # from the redirect
expected_state=step1["state"], # verified with a constant-time compare
code_verifier=step1["code_verifier"],
)Subsequent tool calls refresh transparently with grant_type=refresh_token. Pingen revokes the used refresh token on every use — the server persists the rotated token before the next request. Tokens are stored at PINGEN_TOKEN_FILE (outside the repository); secrets are never committed, logged or printed.
Public deployment (streamable HTTP)
Without HTTP configuration the entry point runs stdio exactly as above. Set
PINGEN_MCP_PUBLIC_URL and it instead serves streamable HTTP on
PINGEN_MCP_PORT, gated by resource-server authentication:
Variable | Required in HTTP mode | Meaning |
| yes | Canonical resource URL, e.g. |
| yes | Expected JWT |
| yes | Where signing keys are fetched from |
| yes | Expected JWT |
| no (8747) | Listen port |
| no (127.0.0.1) | Bind address; containers use |
HTTP mode is all or nothing: a partial set of these variables fails at startup with an error naming the missing ones, rather than silently serving an unauthenticated endpoint.
Behaviour when deployed. Unauthenticated requests get 401 with
WWW-Authenticate: Bearer resource_metadata="…" pointing at the RFC 9728
document served at /.well-known/oauth-protected-resource/<path>, which in
turn names the authorization server. Tokens are validated against the identity
layer's JWKS for signature, issuer, expiry and audience — a validly signed
token minted for a different audience is rejected. Any Host other than the
configured public hostname is refused with 421 before authentication runs.
Behind a reverse proxy
Point a Host() router at the container/process and give it its own
certificate. Do not put a basicAuth/forwardAuth middleware in front of
it: those consume the Authorization header the MCP client sends, and the
discovery paths must stay reachable anonymously. Authentication belongs to this
server. The container publishes no port at all, so the proxy is the only path
in.
Provisioning a consumer client
The authorization server must be given a client before any consumer can obtain a token. Create a confidential OpenID Connect client with:
standard flow enabled,
S256PKCE (authorization code + refresh token)service accounts enabled if the consumer is headless (client credentials)
an audience protocol mapper whose value equals
PINGEN_MCP_PUBLIC_URL, otherwise the resource server rejects every token onaudthe consumer's exact redirect URI(s). Redirect URIs are matched exactly, so interactive consumers must use the registered port — this deployment registers
http://127.0.0.1:8747/callbackandhttp://localhost:8747/callback
Store the resulting client id and secret outside the repository. An idempotent
example script for Keycloak lives beside the deployment, not in this repo
(C:/ProgramData/pingen-mcp/provision_idp_client.py), because it reads that
stack's admin credentials.
Consumer configuration
{
"mcpServers": {
"pingen": {
"url": "https://pingen-mcp.datawyse.ai/mcp",
"authorization": {
"client_id": "<from your IdP client>",
"token_endpoint": "<identity layer token endpoint>"
}
}
}
}Clients that support OAuth discovery need no manual wiring: the 401
challenge → RFC 9728 metadata → RFC 8414 authorization-server metadata chain
leads to the token endpoint automatically.
Verifying a deployment
python scripts/verify_public_deploy.py # c1–c4, restarts Traefik
python scripts/verify_public_deploy.py --json # machine-readable
python scripts/verify_public_deploy.py --skip-restartExit code 0 only when every executed check passed; a check that could not run
(for example, missing consumer credentials) reports skip and does not
count as a pass.
Tools
Naming rule: the spec's operationId with ./- replaced by _ (e.g. letters.create → letters_create). Every tool mirrors exactly one documented operation — the test suite re-derives the expected list from reference/openapi.json and fails on any drift.
Letters (14): letters_list, letters_create, letters_show, letters_delete, letters_send, letters_cancel, letters_file, letters_price_calculator, letters_events, letters_events_image, organisations_letters_events_delivered, organisations_letters_events_issues, organisations_letters_events_sent, organisations_letters_events_undeliverable
Batches (9): batches_list, batches_create, batches_show, batches_edit, batches_delete, batches_send, batches_cancel, batches_events, organisations_batches_statistics_details
eBills (9): deliveries_ebills_list, deliveries_ebills_create, deliveries_ebills_show, deliveries_ebills_delete, deliveries_ebills_send, deliveries_ebills_cancel, deliveries_ebills_file, deliveries_ebills_events, deliveries_ebills_events_image
Emails (8): deliveries_emails_list, deliveries_emails_create, deliveries_emails_show, deliveries_emails_delete, deliveries_emails_cancel, deliveries_emails_file, deliveries_emails_events, deliveries_emails_events_image
Webhooks (4): webhooks_index, webhooks_create, webhooks_show, webhooks_destroy
Directory (4): users_show, user_associations_list, organisations_index, organisations_show
Files (1): files_file_upload
Conventions
Pagination — list tools take optional
page_number/page_limit(mapped to the documentedpage[number]/page[limit], default 20, max 100) plus an optionalquerymapping passed through verbatim for spec-defined keys (sort,filter,include,fields[...],q).Pass-through — tools return the JSON:API document as parsed JSON, unmodified (
data/attributes/relationshipsintact).File & image endpoints — these answer
302to the actual binary; tools return{"redirect_url": ..., "status_code": 302}so the caller fetches the file directly. The server never proxies file contents.Errors — non-2xx responses raise an error containing the HTTP status, a summary of the JSON:API error payload and the
X-Request-Idheader (always quote it in support requests).
Incoming webhooks
Pingen POSTs these payload shapes to a URL you register with webhooks_create — they are not MCP tools:
| Meaning |
| deliverable (letter/email/eBill) delivered |
| deliverable dispatched / sent |
| issue with a deliverable |
| deliverable undeliverable |
| recipient subscription change for a channel |
Development
# per-domain operation slices of the vendored spec (keeps context bounded)
python scripts/extract_ops.py --list
python scripts/extract_ops.py --domain letters
# unit tests (mocked HTTP only)
python -m pytest
# LIVE smoke test - staging by default, read-only, opt-in; production needs
# an explicit --environment production flag
python scripts/staging_smoke.pyReference material
reference/openapi.json— the official Pingen OpenAPI 3.0 specification (downloaded fromhttps://api.pingen.com/documentation/swagger-docs), vendored so builds are reproducible.Live docs: https://api.pingen.com/documentation
Licence
MIT — see LICENSE.
Pingen API and the Pingen name are trademarks of Pingen GmbH; this is an unofficial community integration.
Available Tools
49 toolsbatches_cancelBatches CancelC
Cancel a batch. PATCH /organisations/{organisationId}/batches/{batchId}/cancel
No request body.
Inputs: batch_id (required), organisation_id (required).
batches_createBatches CreateB
Create a new batch. POST /organisations/{organisationId}/batches
payload is the full JSON:API document (CreateBatchPOST), sent verbatim.
Inputs: payload (required), organisation_id (required).
batches_deleteBatches DeleteB
Delete a batch. DELETE /organisations/{organisationId}/batches/{batchId}
The spec marks a required JSON:API request body for this DELETE
(schema BatchDeleteDELETE); payload is sent verbatim.
Inputs: payload (required), batch_id (required), organisation_id (required).
batches_editBatches EditB
Edit a batch. PATCH /organisations/{organisationId}/batches/{batchId}
payload is the full JSON:API document (BatchEditPATCH), sent verbatim.
Inputs: payload (required), batch_id (required), organisation_id (required).
batches_eventsBatches EventsB
Get a collection of batch events. GET /organisations/{organisationId}/batches/{batchId}/events
page_number/page_limit map to page[number]/page[limit];
query keys (language, sort, filter, q, include, fields[...]) pass
through verbatim.
Inputs: batch_id (required), organisation_id (required), query, page_limit, +1 more.
batches_listBatches ListB
List batches. GET /organisations/{organisationId}/batches
page_number/page_limit map to page[number]/page[limit];
query keys (sort, filter, q, include, fields[...]) pass through verbatim.
Inputs: organisation_id (required), query, page_limit, page_number.
batches_sendBatches SendB
Send a batch. PATCH /organisations/{organisationId}/batches/{batchId}/send
payload is the full JSON:API document (one of the BatchSendChannel*
schemas), sent verbatim.
Inputs: payload (required), batch_id (required), organisation_id (required).
batches_showBatches ShowC
Get details of a batch. GET /organisations/{organisationId}/batches/{batchId}
query keys (fields[batches]) pass through verbatim.
Inputs: batch_id (required), organisation_id (required), query.
deliveries_ebills_cancelDeliveries Ebills CancelB
Cancel an ebill. PATCH /organisations/{organisationId}/deliveries/ebills/{ebillId}/cancel
Cancels a pending ebill; the request carries no body.
Inputs: ebill_id (required), organisation_id (required).
deliveries_ebills_createDeliveries Ebills CreateB
Create a new ebill. POST /organisations/{organisationId}/deliveries/ebills
payload is the full JSON:API document, sent through unchanged.
Inputs: payload (required), organisation_id (required).
deliveries_ebills_deleteDeliveries Ebills DeleteC
Delete a eBill. DELETE /organisations/{organisationId}/deliveries/ebills/{ebillId}
Inputs: ebill_id (required), organisation_id (required).
deliveries_ebills_eventsDeliveries Ebills EventsA
Get a collection of ebill events. GET /organisations/{organisationId}/deliveries/ebills/{ebillId}/events
Extra query parameters (language, sort, filter, q, include, fields[...])
pass through verbatim via query.
Inputs: ebill_id (required), organisation_id (required), query, page_limit, +1 more.
deliveries_ebills_events_imageDeliveries Ebills Events ImageA
Get an image of an ebill event. GET /organisations/{organisationId}/deliveries/ebills/{ebillId}/events/{deliverableEventId}/image
Answers 302 to the image; returns the {"redirect_url", "status_code"}
envelope without following the redirect.
Inputs: ebill_id (required), organisation_id (required), deliverable_event_id (required).
deliveries_ebills_fileDeliveries Ebills FileA
Get file of ebill. GET /organisations/{organisationId}/deliveries/ebills/{ebillId}/file
Answers 302 to the stored PDF; returns the {"redirect_url", "status_code"} envelope without following the redirect.
Inputs: ebill_id (required), organisation_id (required).
deliveries_ebills_listDeliveries Ebills ListB
Get a collection of ebills. GET /organisations/{organisationId}/deliveries/ebills
Extra query parameters (sort, filter, q, include, fields[...]) pass
through verbatim via query; page_number/page_limit map to
page[number]/page[limit].
Inputs: organisation_id (required), query, page_limit, page_number.
deliveries_ebills_sendDeliveries Ebills SendB
Send an eBill. PATCH /organisations/{organisationId}/deliveries/ebills/{ebillId}/send
Sends the eBill immediately; the request carries no body.
Inputs: ebill_id (required), organisation_id (required).
deliveries_ebills_showDeliveries Ebills ShowB
Get details of an ebill. GET /organisations/{organisationId}/deliveries/ebills/{ebillId}
query keys (include, fields[...]) pass through verbatim.
Inputs: ebill_id (required), organisation_id (required), query.
deliveries_emails_cancelDeliveries Emails CancelB
Cancel an email. PATCH /organisations/{organisationId}/deliveries/emails/{emailId}/cancel
Cancels a pending email; the request carries no body.
Inputs: email_id (required), organisation_id (required).
deliveries_emails_createDeliveries Emails CreateB
Create a new email. POST /organisations/{organisationId}/deliveries/emails
payload is the full JSON:API document, sent through unchanged.
Inputs: payload (required), organisation_id (required).
deliveries_emails_deleteDeliveries Emails DeleteC
Delete an email. DELETE /organisations/{organisationId}/deliveries/emails/{emailId}
Inputs: email_id (required), organisation_id (required).
deliveries_emails_eventsDeliveries Emails EventsB
Get a collection of email events. GET /organisations/{organisationId}/deliveries/emails/{emailId}/events
Extra query parameters (language, sort, filter, q, include, fields[...])
pass through verbatim via query.
Inputs: email_id (required), organisation_id (required), query, page_limit, +1 more.
deliveries_emails_events_imageDeliveries Emails Events ImageA
Get an image of an email event. GET /organisations/{organisationId}/deliveries/emails/{emailId}/events/{deliverableEventId}/image
Answers 302 to the image; returns the {"redirect_url", "status_code"}
envelope without following the redirect.
Inputs: email_id (required), organisation_id (required), deliverable_event_id (required).
deliveries_emails_fileDeliveries Emails FileB
Get file of email. GET /organisations/{organisationId}/deliveries/emails/{emailId}/file
Answers 302 to the stored file; returns the {"redirect_url", "status_code"} envelope without following the redirect.
Inputs: email_id (required), organisation_id (required).
deliveries_emails_listDeliveries Emails ListA
Get a collection of emails. GET /organisations/{organisationId}/deliveries/emails
Extra query parameters (sort, filter, q, include, fields[...]) pass
through verbatim via query; page_number/page_limit map to
page[number]/page[limit].
Inputs: organisation_id (required), query, page_limit, page_number.
deliveries_emails_showDeliveries Emails ShowB
Get details of an email. GET /organisations/{organisationId}/deliveries/emails/{emailId}
query keys (include, fields[...]) pass through verbatim.
Inputs: email_id (required), organisation_id (required), query.
files_file_uploadFiles File UploadB
Get details for file upload (upload registration/destination etc). GET /file-upload
Registration metadata only: the server never proxies file bytes, so the
JSON:API response passes through unchanged. The optional
fields_file_uploads argument maps to the query parameter
fields[file_uploads] (which attributes of file_uploads to return)
and is omitted from the request when not given.
Inputs: fields_file_uploads.
letters_cancelLetters CancelB
Cancel a letter. PATCH /organisations/{organisationId}/deliveries/letters/{letterId}/cancel
No request body. Answers 202 once the cancellation is queued.
Inputs: letter_id (required), organisation_id (required).
letters_createLetters CreateC
Create a new letter. POST /organisations/{organisationId}/deliveries/letters
payload is the full JSON:API document (LetterCreatePOST) and is sent
unchanged as the request body.
Inputs: payload (required), organisation_id (required).
letters_deleteLetters DeleteB
Delete a letter. DELETE /organisations/{organisationId}/deliveries/letters/{letterId}
Answers 204; the client returns an empty document for empty bodies.
Inputs: letter_id (required), organisation_id (required).
letters_eventsLetters EventsB
Get a collection of letter events. GET /organisations/{organisationId}/deliveries/letters/{letterId}/events
Paginated collection. page_number maps to page[number] and
page_limit to page[limit]; query keys (language, sort, filter,
q, include, fields[...]) pass through verbatim.
Inputs: letter_id (required), organisation_id (required), query, page_limit, +1 more.
letters_events_imageLetters Events ImageA
Get an image of a letter event. GET /organisations/{organisationId}/deliveries/letters/{letterId}/events/{letterEventId}/image
Answers 302 to the actual image; the redirect is NOT followed. Returns
{"redirect_url": ..., "status_code": 302} so the caller can fetch the
image themselves.
Inputs: letter_id (required), letter_event_id (required), organisation_id (required).
letters_fileLetters FileA
Get file of letter. GET /organisations/{organisationId}/deliveries/letters/{letterId}/file
Answers 302 to the rendered PDF; the redirect is NOT followed. Returns
{"redirect_url": ..., "status_code": 302} so the caller can fetch the
binary themselves.
Inputs: letter_id (required), organisation_id (required).
letters_listLetters ListB
List letters. GET /organisations/{organisationId}/deliveries/letters
Paginated collection. page_number maps to page[number] and
page_limit to page[limit]; query keys (sort, filter, q,
include, fields[...]) pass through verbatim.
Inputs: organisation_id (required), query, page_limit, page_number.
letters_price_calculatorLetters Price CalculatorB
Calculate price for a letter configuration. POST /organisations/{organisationId}/deliveries/letters/price-calculator
payload is the full JSON:API document (LetterPriceCalculatorPOST) and
is sent unchanged as the request body.
Inputs: payload (required), organisation_id (required).
letters_sendLetters SendC
Send a letter. PATCH /organisations/{organisationId}/deliveries/letters/{letterId}/send
payload is the full JSON:API document (LetterSendPATCH) and is sent
unchanged as the request body.
Inputs: payload (required), letter_id (required), organisation_id (required).
letters_showLetters ShowA
Get details of a letter. GET /organisations/{organisationId}/deliveries/letters/{letterId}
Returns the JSON:API document for a single letter, unchanged.
query keys (include, fields[...]) pass through verbatim.
Inputs: letter_id (required), organisation_id (required), query.
organisations_batches_statistics_detailsOrganisations Batches Statistics DetailsC
Get statistics of a batch. GET /organisations/{organisationId}/batches/{batchId}/statistics
Inputs: batch_id (required), organisation_id (required).
organisations_indexOrganisations IndexB
Get collection of organisations. GET /organisations
page_number/page_limit map to page[number]/page[limit];
query passes extra query parameters (sort, filter, q,
fields[organisations]) through verbatim.
Inputs: query, page_limit, page_number.
organisations_letters_events_deliveredOrganisations Letters Events DeliveredB
Get a collection of all delivered events. GET /organisations/{organisationId}/deliveries/letters/events/delivered
Organisation-wide, paginated collection. page_number maps to
page[number] and page_limit to page[limit]; query keys
(language, filter, q, include, fields[...]) pass through verbatim.
Inputs: organisation_id (required), query, page_limit, page_number.
organisations_letters_events_issuesOrganisations Letters Events IssuesB
Get a collection of all issue events. GET /organisations/{organisationId}/deliveries/letters/events/issues
Organisation-wide, paginated collection. page_number maps to
page[number] and page_limit to page[limit]; query keys
(language, filter, q, include, fields[...]) pass through verbatim.
Inputs: organisation_id (required), query, page_limit, page_number.
organisations_letters_events_sentOrganisations Letters Events SentB
Get a collection of all sent events. GET /organisations/{organisationId}/deliveries/letters/events/sent
Organisation-wide, paginated collection. page_number maps to
page[number] and page_limit to page[limit]; query keys
(language, filter, q, include, fields[...]) pass through verbatim.
Inputs: organisation_id (required), query, page_limit, page_number.
organisations_letters_events_undeliverableOrganisations Letters Events UndeliverableA
Get a collection of all undeliverable events. GET /organisations/{organisationId}/deliveries/letters/events/undeliverable
Organisation-wide, paginated collection. page_number maps to
page[number] and page_limit to page[limit]; query keys
(language, filter, q, include, fields[...]) pass through verbatim.
Inputs: organisation_id (required), query, page_limit, page_number.
organisations_showOrganisations ShowC
Get details of an organisation. GET /organisations/{organisationId}
query keys (fields[organisations]) pass through verbatim.
Inputs: organisation_id (required), query.
user_associations_listUser Associations ListA
Get collection of associations of the authenticated user.
GET /user/associations
page_number/page_limit map to page[number]/page[limit];
query passes extra query parameters (sort, filter, q, include,
fields[...]) through verbatim.
Inputs: query, page_limit, page_number.
users_showUsers ShowA
Get details of the authenticated user. GET /user
query keys (fields[users]) pass through verbatim.
Inputs: query.
webhooks_createWebhooks CreateC
Create new webhook. POST /organisations/{organisationId}/webhooks
payload is the full JSON:API document (data/attributes),
passed through unchanged.
Inputs: payload (required), organisation_id (required).
webhooks_destroyWebhooks DestroyC
Delete a webhook. DELETE /organisations/{organisationId}/webhooks/{webhookId}
Inputs: webhook_id (required), organisation_id (required).
webhooks_indexWebhooks IndexB
List organisation webhooks. GET /organisations/{organisationId}/webhooks
Pagination maps to page[number]/page[limit]; query keys
(filter, q, include, fields[...]) pass through verbatim.
Inputs: organisation_id (required), query, page_limit, page_number.
webhooks_showWebhooks ShowB
Get details of a webhook. GET /organisations/{organisationId}/webhooks/{webhookId}
Inputs: webhook_id (required), organisation_id (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 49 tools
Each tool maps to a distinct REST endpoint and the resource prefix (letters, emails, ebills, batches, webhooks, organisations) plus action suffix usually makes selection clear. A few pairs need care — organisation-wide event feeds (organisations_letters_events_sent) versus per-letter events (letters_events), and files_file_upload which actually only fetches upload metadata rather than uploading anything.
All names are snake_case and mostly follow a resource_action shape, but the verb vocabulary is inconsistent (list vs index, show vs get, delete vs destroy, edit vs update) and the ordering flips between resource-first (letters_list) and path-first (organisations_letters_events_delivered, files_file_upload). Readable, but not predictable enough for an agent to guess names.
49 tools is well beyond a comfortable working set for an agent, even though it mirrors a real API surface of three delivery channels times roughly ten operations each. Much of the weight comes from repetitive per-channel variants (file, events, events_image, send, cancel) that could be consolidated.
CRUD plus lifecycle actions (send, cancel, file, events, statistics) are covered for letters, emails, ebills and batches, along with organisations, user, associations and webhooks. Minor gaps: no webhook update or webhook delivery/event listing, no letter or email edit operation, and no price calculator for channels other than letters.
Maintenance
Related MCP Connectors
Transactional email API: send, read delivery timelines, explain bounces, manage domains (OAuth).
Browse photo prints, estimate delivery prices, prepare uploads and track orders with scoped OAuth.
Document API for AI-native software: render PDFs, e-sign, PAdES-seal, and verify.
The agentic layer of letters. Agents send real printed mail worldwide, German compliance built in.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables sending transactional emails, managing templates, suppression lists, sending domains, webhooks, subaccounts, and retrieving account metrics via the SparkPost API.20356 npmMIT
- AlicenseAqualityBmaintenanceEnables sending physical letters (including registered mail) from PDFs via the Pingen API, with tools to manage drafts, submit, track, and cancel letters.918 npmMIT
- FlicenseNot gradedqualityCmaintenanceEnables AI assistants to prepare, price, review, pay for, and send real physical letters and postcards via a hosted MCP server.-

DocuQueue MCP Serverofficial
AlicenseNot gradedqualityCmaintenanceEnables creating professional documents (invoices, contracts, certificates, proposals, reports) via the DocuQueue API, with tools for template management, filling, previewing, and PDF generation.28 npm1MIT