pieterpost.com WebMCP Tools, Schemas & Agent Capabilities

pieterpost.com

live Unverified (seed import) Commerce 7 tools imperative implementation

Write your letter or upload a PDF. Pieterpost prints, stamps and mails it for you, with no printer, envelope or post office trip.

First seen 2026-08-31 · Last seen 2026-08-31 · Source: webmcp.com

Answer 2 · Act 3 · Transact 2 · Score: Not yet scored

Tool inspector

prepare_letter

act imperative

Validate, price, and prepare one letter without paying or sending it. Returns an expiring order with orderRef, amountCents, currency, recipient summary, status fields, nextActions, and payment endpoints; address-warning errors include details.addressWarnings.

Page: /

Input schema

Property	Type	Required	Description
`acceptUsAddressWarnings`	boolean	no	Set true only after reviewing details.addressWarnings from an earlier attempt.
`attachmentAssetIds`	array	no	Up to three asset IDs returned by upload_mail_asset.
`idempotencyKey`	string	yes	Stable caller-generated key for safe retries of this exact draft.
`locale`	string	no	—
`message`	string	no	Exact final letter text, with line breaks preserved.
`recipient`	object	yes	One normalized postal recipient. Address lines exclude the recipient name; do not infer missing address details.
`stampImageAssetId`	string	no	Optional letter-stamp-image asset ID returned by upload_mail_asset.

Raw JSON schema

{
  "additionalProperties": false,
  "anyOf": [
    {
      "required": [
        "message"
      ]
    },
    {
      "required": [
        "attachmentAssetIds"
      ]
    }
  ],
  "properties": {
    "acceptUsAddressWarnings": {
      "description": "Set true only after reviewing details.addressWarnings from an earlier attempt.",
      "type": "boolean"
    },
    "attachmentAssetIds": {
      "description": "Up to three asset IDs returned by upload_mail_asset.",
      "items": {
        "maxLength": 140,
        "type": "string"
      },
      "maxItems": 3,
      "minItems": 1,
      "type": "array"
    },
    "idempotencyKey": {
      "description": "Stable caller-generated key for safe retries of this exact draft.",
      "maxLength": 140,
      "minLength": 1,
      "type": "string"
    },
    "locale": {
      "enum": [
        "de",
        "en",
        "es",
        "fr",
        "it",
        "nl",
        "pl",
        "pt"
      ],
      "type": "string"
    },
    "message": {
      "description": "Exact final letter text, with line breaks preserved.",
      "maxLength": 6000,
      "type": "string"
    },
    "recipient": {
      "additionalProperties": false,
      "description": "One normalized postal recipient. Address lines exclude the recipient name; do not infer missing address details.",
      "properties": {
        "addressLines": {
          "items": {
            "maxLength": 140,
            "type": "string"
          },
          "maxItems": 4,
          "minItems": 1,
          "type": "array"
        },
        "city": {
          "maxLength": 140,
          "type": "string"
        },
        "country": {
          "maxLength": 140,
          "type": "string"
        },
        "name": {
          "maxLength": 140,
          "minLength": 1,
          "type": "string"
        },
        "postalCode": {
          "maxLength": 140,
          "type": "string"
        },
        "state": {
          "maxLength": 140,
          "type": "string"
        }
      },
      "required": [
        "name",
        "addressLines"
      ],
      "type": "object"
    },
    "stampImageAssetId": {
      "description": "Optional letter-stamp-image asset ID returned by upload_mail_asset.",
      "maxLength": 140,
      "type": "string"
    }
  },
  "required": [
    "idempotencyKey",
    "recipient"
  ],
  "type": "object"
}