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_postcard

act imperative

Validate, price, and prepare one postcard 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.
`frontImageAssetId`	string	no	Optional postcard-image asset ID returned by upload_mail_asset.
`idempotencyKey`	string	yes	Stable caller-generated key for safe retries of this exact draft.
`locale`	string	no	—
`message`	string	yes	Exact final postcard text, with line breaks preserved.
`recipient`	object	yes	One normalized postal recipient. Address lines exclude the recipient name; do not infer missing address details.

Raw JSON schema

{
  "additionalProperties": false,
  "properties": {
    "acceptUsAddressWarnings": {
      "description": "Set true only after reviewing details.addressWarnings from an earlier attempt.",
      "type": "boolean"
    },
    "frontImageAssetId": {
      "description": "Optional postcard-image asset ID returned by upload_mail_asset.",
      "maxLength": 140,
      "type": "string"
    },
    "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 postcard text, with line breaks preserved.",
      "maxLength": 1200,
      "minLength": 1,
      "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"
    }
  },
  "required": [
    "idempotencyKey",
    "message",
    "recipient"
  ],
  "type": "object"
}