PIETERPOST API

API dashboard

Generate secure compose links, launch hosted checkout, top up credits, and track letter or postcard orders from one place.

Create an account to get your first test key, try the sandbox checkout flow, and move to live hosted checkout when you are ready.

MCP

Model Context Protocol

Connect ChatGPT, Claude, Vercel AI SDK clients, and other MCP hosts to use PieterPost API context, sending tools, uploads, credit flows, and API key management through scoped OAuth access.

0 active

Server URL

https://pieterpost.com/mcp/

Transport

Streamable HTTP

Authorization

OAuth authorization code with PKCE

Scopes

api:read api:send api:keys mailbook:read mailbook:write

{
  "type": "mcp",
  "server_label": "pieterpost",
  "server_url": "https://pieterpost.com/mcp/",
  "allowed_tools": [
    "search",
    "fetch",
    "quote_order",
    "upload_asset",
    "create_compose_link",
    "create_checkout_link",
    "create_direct_order",
    "get_wallet",
    "get_order",
    "get_topup",
    "list_topups",
    "create_credit_topup",
    "list_api_keys",
    "create_api_key",
    "revoke_api_key"
  ],
  "require_approval": {
    "never": {
      "read_only": true
    }
  }
}

Tools

Available tools

The server exposes read tools for docs, pricing, wallets, orders, and top-ups plus write tools for uploads, hosted checkout, wallet-funded mail, credits, and API key management.

Find API docs, account status, keys, wallets, orders, activity, and MCP connections.

fetch

Retrieve a full document returned by search for citation and context.

quote_order

Validate and price a letter or postcard payload before creating a live order.

upload_asset

Upload postcard images or letter attachments from base64 or a public HTTPS URL.

create_compose_link

Prepare a PieterPost review link with a recipient and message.

create_checkout_link

Create hosted payment links for bulk letters or postcards.

create_direct_order

Send wallet-funded letters or postcards. Live mode requires explicit confirmation, a max amount, and an idempotency key.

get_wallet

Read test or live credit balances.

get_order

Fetch current order status.

get_topup

Fetch one wallet top-up by id.

list_topups

List recent wallet top-ups for live or test mode.

create_credit_topup

Add test credits or create a live Stripe top-up checkout URL with card or EUR iDEAL.

list_api_keys

List API key metadata without revealing secrets.

create_api_key

Create test or live API keys. The secret is returned once.

revoke_api_key

Revoke an existing public API key.