Skip to main content
Glama

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 pytest

MCP 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

PINGEN_ENVIRONMENT

no

production

production or staging (see hosts below)

PINGEN_GRANT_TYPE

no

client_credentials

client_credentials or authorization_code; invalid values fail at startup

PINGEN_CLIENT_ID / PINGEN_CLIENT_SECRET

yes*

–

from your Pingen developer app

PINGEN_ENV_FILE

no

–

path to an env file with the keys above (used when not set in the process environment)

PINGEN_REDIRECT_URI

auth-code only

–

registered redirect URI for the authorization-code grant

PINGEN_SCOPES

no

app defaults

space-separated scopes (letter batch email ebill template webhook organisation_read)

PINGEN_TOKEN_FILE

no

<user config dir>/pingen-mcp/tokens.json

access/refresh token storage, always outside the repo

PINGEN_API_BASE_URL / PINGEN_IDENTITY_BASE_URL

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

https://api.pingen.com

https://identity.pingen.com

Staging

https://api-staging.pingen.com

https://identity-staging.pingen.com

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

PINGEN_MCP_PUBLIC_URL

yes

Canonical resource URL, e.g. https://pingen-mcp.datawyse.ai/mcp

PINGEN_MCP_AUTH_ISSUER

yes

Expected JWT iss (the identity layer's realm issuer)

PINGEN_MCP_AUTH_JWKS_URI

yes

Where signing keys are fetched from

PINGEN_MCP_AUTH_AUDIENCE

yes

Expected JWT aud — normally the same as PINGEN_MCP_PUBLIC_URL

PINGEN_MCP_PORT

no (8747)

Listen port

PINGEN_MCP_BIND

no (127.0.0.1)

Bind address; containers use 0.0.0.0

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, S256 PKCE (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 on aud

  • the 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/callback and http://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-restart

Exit 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 documented page[number] / page[limit], default 20, max 100) plus an optional query mapping 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 / relationships intact).

  • File & image endpoints — these answer 302 to 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-Id header (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:

data.type

Meaning

webhook_delivered

deliverable (letter/email/eBill) delivered

webhook_sent

deliverable dispatched / sent

webhook_issues

issue with a deliverable

webhook_undeliverable

deliverable undeliverable

webhook_channel_subscriptions

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.py

Reference material

  • reference/openapi.json — the official Pingen OpenAPI 3.0 specification (downloaded from https://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 tools
batches_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

    B3.1/5.0

    Scored across 49 tools

    Disambiguation4/5

    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.

    Naming Consistency3/5

    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.

    Tool Count2/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Enables sending transactional emails, managing templates, suppression lists, sending domains, webhooks, subaccounts, and retrieving account metrics via the SparkPost API.
      20
      356 npm
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables sending physical letters (including registered mail) from PDFs via the Pingen API, with tools to manage drafts, submit, track, and cancel letters.
      9
      18 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables creating professional documents (invoices, contracts, certificates, proposals, reports) via the DocuQueue API, with tools for template management, filling, previewing, and PDF generation.
      28 npm
      1
      MIT