Skip to main content
Glama

postedly_quote

Creates a time-limited price quote for one physical delivery: mailing a letter or PDF, certified mail, a postcard, a fax, a handwritten card or another available Postedly delivery service. Each quote covers one exact document or product and one recipient, and includes tax and delivery costs. Document services take the private document ID of an uploaded PDF; their quote includes a final proof of every page, including the document body and any generated cover. Handwritten cards take a selected card, handwriting style, message and optional closing instead of a PDF; their quote includes the immutable text and address details with card-design and handwriting-style samples, not an image of the finished message. Returns the quote with its final preview, recipient, total and expiry. A postal address that cannot be verified returns an error naming the recipient or sender role; with details.canSendAsEntered true, a new quote with options.sendAsEntered for that role only returns addressWarnings that the payer accepts on the browser review page. Does not draft or edit documents, summarize PDFs or send email. Does not approve, charge or send an order.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "service": "<service>",
      "recipient": "<recipient>",
      "sender": "<sender>"
    },
    "name": "postedly_quote"
  }
}

Input Schema

NameRequiredDescriptionDefault
senderYesSender identity and billing location. When email is omitted, the connected account’s verified email is used. Fax needs US country, state and postalCode. Postal letters, certified mail, postcards and handwritten cards also need the full return address. The private browser review verifies the human payer’s receipt email separately; it does not change the quoted sender or the connected creator.
optionsNoHandwritten only: productId, fontLabel and message are required (wishes is optional); recipient and sender need name, address1, city, state, postalCode and country US; message plus wishes must fit the selected card’s combinedCharacterLimit, never above 1000. Other services: optional settings, and any message is limited to 500 characters. The server checks these rules and names the field that is missing or wrong.
serviceYesThe delivery service. handwritten takes no documentId and requires options.productId, options.fontLabel and options.message; every other service requires documentId.
recipientYesOne recipient. Fax requires fax and US country. Other channels require address1, city, state, postalCode and US country.
documentIdNoPrivate document ID of an uploaded PDF or a composed postcard. Required for fax, letter, certified and postcard. Not allowed for handwritten.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedInput schema / properties / options / properties / promoCode
      Added value: +{
      +  "description": "Optional discount code. HOLIDAY takes $1 off an eligible holiday handwritten card or composed holiday postcard before tax through December 31, 2026 Pacific time.",
      +  "maxLength": 40,
      +  "type": "string"
      +}
  2. Changed1 schema field changed
    • changedInput schema / properties / documentId / description
      Previous value: -"Private document ID from postedly_upload_document. Required for fax, letter, certified and postcard. Not allowed for handwritten."New value: +"Private document ID of an uploaded PDF or a composed postcard. Required for fax, letter, certified and postcard. Not allowed for handwritten."
  3. Changed4 schema fields changed
    • removedInput schema / allOf
      Removed value: -[
      -  {
      -    "else": {
      -      "properties": {
      -        "options": {
      -          "properties": {
      -            "message": {
      -              "maxLength": 500,
      -              "type": "string"
      -            }
      -          }
      -        }
      -      }
      -    },
      -    "if": {
      -      "properties": {
      -        "service": {
      -          "const": "handwritten"
      -        }
      -      },
      -      "required": [
      -        "service"
      -      ]
      -    },
      -    "then": {
      -      "properties": {
      -        "options": {
      -          "additionalProperties": false,
      -          "description": "The selected card’s catalog limits are authoritative. Raw message.length plus wishes.length must fit combinedCharacterLimit, never above 1000. Plain text only; signature codes, QR codes and template substitutions are not supported.",
      -          "properties": {
      -            "fontLabel": {
      -              "maxLength": 100,
      -              "minLength": 1,
      -              "type": "string"
      -            },
      -            "message": {
      -              "maxLength": 1000,
      -              "minLength": 1,
      -              "pattern": "\\S",
      -              "type": "string"
      -            },
      -            "productId": {
      -              "pattern": "^[1-9]\\d{0,14}$",
      -              "type": "string"
      -            },
      -            "quantity": {
      -              "const": 1,
      -              "type": "integer"
      -            },
      -            "wishes": {
      -              "default": "",
      -              "maxLength": 200,
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "productId",
      -            "fontLabel",
      -            "message"
      -          ],
      -          "type": "object"
      -        },
      -        "recipient": {
      -          "properties": {
      -            "country": {
      -              "const": "US"
      -            }
      -          },
      -          "required": [
      -            "name",
      -            "address1",
      -            "city",
      -            "state",
      -            "postalCode",
      -            "country"
      -          ],
      -          "type": "object"
      -        },
      -        "sender": {
      -          "description": "When email is omitted, the connected account’s verified email is used; unverified sessions must supply it.",
      -          "properties": {
      -            "country": {
      -              "const": "US"
      -            }
      -          },
      -          "required": [
      -            "name",
      -            "address1",
      -            "city",
      -            "state",
      -            "postalCode",
      -            "country"
      -          ],
      -          "type": "object"
      -        }
      -      },
      -      "required": [
      -        "options"
      -      ]
      -    }
      -  }
      -]
    • addedInput schema / properties / documentId / description
      Added value: +"Private document ID from postedly_upload_document. Required for fax, letter, certified and postcard. Not allowed for handwritten."
    • addedInput schema / properties / options / description
      Added value: +"Handwritten only: productId, fontLabel and message are required (wishes is optional); recipient and sender need name, address1, city, state, postalCode and country US; message plus wishes must fit the selected card’s combinedCharacterLimit, never above 1000. Other services: optional settings, and any message is limited to 500 characters. The server checks these rules and names the field that is missing or wrong."
    • addedInput schema / properties / service / description
      Added value: +"The delivery service. handwritten takes no documentId and requires options.productId, options.fontLabel and options.message; every other service requires documentId."
  4. Changed4 schema fields changed
    • changedInput schema / allOf
      Previous value: -[
      -  {
      -    "else": {
      -      "properties": {
      -        "options": {
      -          "properties": {
      -            "message": {
      -              "maxLength": 500,
      -              "type": "string"
      -            }
      -          }
      -        }
      -      }
      -    },
      -    "if": {
      -      "properties": {
      -        "service": {
      -          "const": "handwritten"
      -        }
      -      },
      -      "required": [
      -        "service"
      -      ]
      -    },
      -    "then": {
      -      "properties": {
      -        "options": {
      -          "additionalProperties": false,
      -          "description": "The selected card’s catalog limits are authoritative. Raw message.length plus wishes.length must fit combinedCharacterLimit, never above 1000. Plain text only; signature codes, QR codes and template substitutions are not supported.",
      -          "properties": {
      -            "fontLabel": {
      -              "maxLength": 100,
      -              "minLength": 1,
      -              "type": "string"
      -            },
      -            "message": {
      -              "maxLength": 1000,
      -              "minLength": 1,
      -              "pattern": "\\S",
      -              "type": "string"
      -            },
      -            "productId": {
      -              "pattern": "^[1-9]\\d{0,14}$",
      -              "type": "string"
      -            },
      -            "quantity": {
      -              "const": 1,
      -              "type": "integer"
      -            },
      -            "wishes": {
      -              "default": "",
      -              "maxLength": 200,
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "productId",
      -            "fontLabel",
      -            "message"
      -          ],
      -          "type": "object"
      -        },
      -        "recipient": {
      -          "properties": {
      -            "country": {
      -              "const": "US"
      -            }
      -          },
      -          "required": [
      -            "name",
      -            "address1",
      -            "city",
      -            "state",
      -            "postalCode",
      -            "country"
      -          ],
      -          "type": "object"
      -        },
      -        "sender": {
      -          "description": "Omit email to reuse the connected account’s verified email; unverified sessions must supply it.",
      -          "properties": {
      -            "country": {
      -              "const": "US"
      -            }
      -          },
      -          "required": [
      -            "name",
      -            "address1",
      -            "city",
      -            "state",
      -            "postalCode",
      -            "country"
      -          ],
      -          "type": "object"
      -        }
      -      },
      -      "required": [
      -        "options"
      -      ]
      -    }
      -  }
      -]New value: +[
      +  {
      +    "else": {
      +      "properties": {
      +        "options": {
      +          "properties": {
      +            "message": {
      +              "maxLength": 500,
      +              "type": "string"
      +            }
      +          }
      +        }
      +      }
      +    },
      +    "if": {
      +      "properties": {
      +        "service": {
      +          "const": "handwritten"
      +        }
      +      },
      +      "required": [
      +        "service"
      +      ]
      +    },
      +    "then": {
      +      "properties": {
      +        "options": {
      +          "additionalProperties": false,
      +          "description": "The selected card’s catalog limits are authoritative. Raw message.length plus wishes.length must fit combinedCharacterLimit, never above 1000. Plain text only; signature codes, QR codes and template substitutions are not supported.",
      +          "properties": {
      +            "fontLabel": {
      +              "maxLength": 100,
      +              "minLength": 1,
      +              "type": "string"
      +            },
      +            "message": {
      +              "maxLength": 1000,
      +              "minLength": 1,
      +              "pattern": "\\S",
      +              "type": "string"
      +            },
      +            "productId": {
      +              "pattern": "^[1-9]\\d{0,14}$",
      +              "type": "string"
      +            },
      +            "quantity": {
      +              "const": 1,
      +              "type": "integer"
      +            },
      +            "wishes": {
      +              "default": "",
      +              "maxLength": 200,
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "productId",
      +            "fontLabel",
      +            "message"
      +          ],
      +          "type": "object"
      +        },
      +        "recipient": {
      +          "properties": {
      +            "country": {
      +              "const": "US"
      +            }
      +          },
      +          "required": [
      +            "name",
      +            "address1",
      +            "city",
      +            "state",
      +            "postalCode",
      +            "country"
      +          ],
      +          "type": "object"
      +        },
      +        "sender": {
      +          "description": "When email is omitted, the connected account’s verified email is used; unverified sessions must supply it.",
      +          "properties": {
      +            "country": {
      +              "const": "US"
      +            }
      +          },
      +          "required": [
      +            "name",
      +            "address1",
      +            "city",
      +            "state",
      +            "postalCode",
      +            "country"
      +          ],
      +          "type": "object"
      +        }
      +      },
      +      "required": [
      +        "options"
      +      ]
      +    }
      +  }
      +]
    • changedInput schema / properties / options / properties / sendAsEntered / description
      Previous value: -"PostGrid postal mail only. Request an exact-address quote after a failed live verification. Each role is explicit. This is not approval: the sender must review addressWarnings and accept the delivery risk on the secure approval page before payment."New value: +"PostGrid postal mail only. Requests an exact-address quote for an address that failed live verification, set separately for each role. Does not grant approval; the delivery risk shown in addressWarnings is accepted only on the secure approval page before payment."
    • changedInput schema / properties / sender / description
      Previous value: -"Sender identity and billing location. Omit email to reuse the verified connected account; do not ask the user to repeat it or pass an email code through chat. Fax needs US country, state and postalCode. Postal letters, certified mail, postcards and handwritten cards also need the full return address. The private browser review verifies the human payer’s receipt email separately; it does not change the quoted sender or the connected creator."New value: +"Sender identity and billing location. When email is omitted, the connected account’s verified email is used. Fax needs US country, state and postalCode. Postal letters, certified mail, postcards and handwritten cards also need the full return address. The private browser review verifies the human payer’s receipt email separately; it does not change the quoted sender or the connected creator."
    • changedInput schema / properties / sender / properties / email / description
      Previous value: -"Omit to reuse this connected account’s verified email. Required when the session has no verified email. An explicitly supplied email is never overwritten."New value: +"When omitted, the connected account’s verified email is used. Required when the session has no verified email. An explicitly supplied email is never overwritten."
  5. Changed1 schema field changed
    • changedInput schema / properties / sender / description
      Previous value: -"Sender identity and billing location. Omit email to reuse the verified connected account; do not ask the user to repeat it or pass an email code through chat. Fax needs US country, state and postalCode. Postal letters, certified mail, postcards and handwritten cards also need the full return address. Checkout requires the resolved sender email to match the verified connected account."New value: +"Sender identity and billing location. Omit email to reuse the verified connected account; do not ask the user to repeat it or pass an email code through chat. Fax needs US country, state and postalCode. Postal letters, certified mail, postcards and handwritten cards also need the full return address. The private browser review verifies the human payer’s receipt email separately; it does not change the quoted sender or the connected creator."
  6. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -{
      -  "$schema": "https://json-schema.org/draft/2020-12/schema",
      -  "anyOf": [
      -    {
      -      "additionalProperties": false,
      -      "properties": {
      -        "addressWarnings": {
      -          "items": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "address": {
      -                "additionalProperties": false,
      -                "properties": {
      -                  "address1": {
      -                    "type": "string"
      -                  },
      -                  "address2": {
      -                    "type": "string"
      -                  },
      -                  "city": {
      -                    "type": "string"
      -                  },
      -                  "country": {
      -                    "type": "string"
      -                  },
      -                  "email": {
      -                    "type": "string"
      -                  },
      -                  "fax": {
      -                    "type": "string"
      -                  },
      -                  "name": {
      -                    "type": "string"
      -                  },
      -                  "phone": {
      -                    "type": "string"
      -                  },
      -                  "postalCode": {
      -                    "type": "string"
      -                  },
      -                  "state": {
      -                    "type": "string"
      -                  }
      -                },
      -                "required": [
      -                  "name"
      -                ],
      -                "type": "object"
      -              },
      -              "code": {
      -                "enum": [
      -                  "address_unit_required",
      -                  "address_unverified"
      -                ]
      -              },
      -              "message": {
      -                "type": "string"
      -              },
      -              "role": {
      -                "enum": [
      -                  "recipient",
      -                  "sender"
      -                ]
      -              }
      -            },
      -            "required": [
      -              "role",
      -              "code",
      -              "message",
      -              "address"
      -            ],
      -            "type": "object"
      -          },
      -          "type": "array"
      -        },
      -        "amountCents": {
      -          "minimum": 0,
      -          "type": "integer"
      -        },
      -        "currency": {
      -          "const": "USD"
      -        },
      -        "document": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "bytes": {
      -              "maximum": 10485760,
      -              "minimum": 1,
      -              "type": "integer"
      -            },
      -            "contentType": {
      -              "const": "application/pdf"
      -            },
      -            "id": {
      -              "minLength": 1,
      -              "type": "string"
      -            },
      -            "name": {
      -              "type": "string"
      -            },
      -            "pages": {
      -              "maximum": 50,
      -              "minimum": 1,
      -              "type": "integer"
      -            },
      -            "previewUrl": {
      -              "format": "uri-reference",
      -              "type": "string"
      -            },
      -            "sha256": {
      -              "pattern": "^[a-f0-9]{64}$",
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "id",
      -            "name",
      -            "pages",
      -            "bytes",
      -            "sha256",
      -            "previewUrl",
      -            "contentType"
      -          ],
      -          "type": "object"
      -        },
      -        "emailMessage": {
      -          "additionalProperties": true,
      -          "type": "object"
      -        },
      -        "estimatedDelivery": {
      -          "type": "string"
      -        },
      -        "expiresAt": {
      -          "type": "string"
      -        },
      -        "handwritten": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "cardId": {
      -              "minLength": 1,
      -              "type": "string"
      -            },
      -            "cardImageUrl": {
      -              "format": "uri",
      -              "type": "string"
      -            },
      -            "cardName": {
      -              "type": "string"
      -            },
      -            "fontId": {
      -              "minLength": 1,
      -              "type": "string"
      -            },
      -            "fontImageUrl": {
      -              "format": "uri",
      -              "type": "string"
      -            },
      -            "fontLabel": {
      -              "type": "string"
      -            },
      -            "message": {
      -              "type": "string"
      -            },
      -            "previewKind": {
      -              "const": "design_and_style_samples"
      -            },
      -            "recipient": {
      -              "additionalProperties": false,
      -              "properties": {
      -                "address1": {
      -                  "type": "string"
      -                },
      -                "address2": {
      -                  "type": "string"
      -                },
      -                "city": {
      -                  "type": "string"
      -                },
      -                "country": {
      -                  "type": "string"
      -                },
      -                "email": {
      -                  "type": "string"
      -                },
      -                "fax": {
      -                  "type": "string"
      -                },
      -                "name": {
      -                  "type": "string"
      -                },
      -                "phone": {
      -                  "type": "string"
      -                },
      -                "postalCode": {
      -                  "type": "string"
      -                },
      -                "state": {
      -                  "type": "string"
      -                }
      -              },
      -              "required": [
      -                "name"
      -              ],
      -              "type": "object"
      -            },
      -            "sender": {
      -              "additionalProperties": false,
      -              "properties": {
      -                "address1": {
      -                  "type": "string"
      -                },
      -                "address2": {
      -                  "type": "string"
      -                },
      -                "city": {
      -                  "type": "string"
      -                },
      -                "country": {
      -                  "type": "string"
      -                },
      -                "email": {
      -                  "type": "string"
      -                },
      -                "fax": {
      -                  "type": "string"
      -                },
      -                "name": {
      -                  "type": "string"
      -                },
      -                "phone": {
      -                  "type": "string"
      -                },
      -                "postalCode": {
      -                  "type": "string"
      -                },
      -                "state": {
      -                  "type": "string"
      -                }
      -              },
      -              "required": [
      -                "name"
      -              ],
      -              "type": "object"
      -            },
      -            "stampName": {
      -              "type": "string"
      -            },
      -            "stampOptionId": {
      -              "minimum": 0,
      -              "type": "integer"
      -            },
      -            "wishes": {
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "cardId",
      -            "cardName",
      -            "cardImageUrl",
      -            "fontId",
      -            "fontLabel",
      -            "fontImageUrl",
      -            "message",
      -            "wishes",
      -            "sender",
      -            "recipient",
      -            "previewKind",
      -            "stampOptionId",
      -            "stampName"
      -          ],
      -          "type": "object"
      -        },
      -        "id": {
      -          "minLength": 1,
      -          "type": "string"
      -        },
      -        "lineItems": {
      -          "items": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "amountCents": {
      -                "minimum": 0,
      -                "type": "integer"
      -              },
      -              "label": {
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "label",
      -              "amountCents"
      -            ],
      -            "type": "object"
      -          },
      -          "type": "array"
      -        },
      -        "options": {
      -          "additionalProperties": true,
      -          "type": "object"
      -        },
      -        "recipient": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "address1": {
      -              "type": "string"
      -            },
      -            "address2": {
      -              "type": "string"
      -            },
      -            "city": {
      -              "type": "string"
      -            },
      -            "country": {
      -              "type": "string"
      -            },
      -            "email": {
      -              "type": "string"
      -            },
      -            "fax": {
      -              "type": "string"
      -            },
      -            "name": {
      -              "type": "string"
      -            },
      -            "phone": {
      -              "type": "string"
      -            },
      -            "postalCode": {
      -              "type": "string"
      -            },
      -            "state": {
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "name"
      -          ],
      -          "type": "object"
      -        },
      -        "sender": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "address1": {
      -              "type": "string"
      -            },
      -            "address2": {
      -              "type": "string"
      -            },
      -            "city": {
      -              "type": "string"
      -            },
      -            "country": {
      -              "type": "string"
      -            },
      -            "email": {
      -              "type": "string"
      -            },
      -            "fax": {
      -              "type": "string"
      -            },
      -            "name": {
      -              "type": "string"
      -            },
      -            "phone": {
      -              "type": "string"
      -            },
      -            "postalCode": {
      -              "type": "string"
      -            },
      -            "state": {
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "name"
      -          ],
      -          "type": "object"
      -        },
      -        "service": {
      -          "enum": [
      -            "fax",
      -            "letter",
      -            "certified",
      -            "postcard",
      -            "handwritten"
      -          ]
      -        },
      -        "summary": {
      -          "type": "string"
      -        }
      -      },
      -      "required": [
      -        "id",
      -        "service",
      -        "amountCents",
      -        "currency",
      -        "lineItems",
      -        "expiresAt",
      -        "estimatedDelivery",
      -        "summary",
      -        "recipient",
      -        "sender",
      -        "options"
      -      ],
      -      "type": "object"
      -    },
      -    {
      -      "additionalProperties": false,
      -      "properties": {
      -        "error": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "code": {
      -              "minLength": 1,
      -              "type": "string"
      -            },
      -            "details": {
      -              "additionalProperties": false,
      -              "properties": {
      -                "addressRole": {
      -                  "enum": [
      -                    "recipient",
      -                    "sender"
      -                  ]
      -                },
      -                "canSendAsEntered": {
      -                  "type": "boolean"
      -                }
      -              },
      -              "required": [
      -                "addressRole",
      -                "canSendAsEntered"
      -              ],
      -              "type": "object"
      -            },
      -            "message": {
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "code",
      -            "message"
      -          ],
      -          "type": "object"
      -        }
      -      },
      -      "required": [
      -        "error"
      -      ],
      -      "type": "object"
      -    }
      -  ],
      -  "type": "object"
      -}New value: +null
  7. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "$schema": "https://json-schema.org/draft/2020-12/schema",
      +  "anyOf": [
      +    {
      +      "additionalProperties": false,
      +      "properties": {
      +        "addressWarnings": {
      +          "items": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "address": {
      +                "additionalProperties": false,
      +                "properties": {
      +                  "address1": {
      +                    "type": "string"
      +                  },
      +                  "address2": {
      +                    "type": "string"
      +                  },
      +                  "city": {
      +                    "type": "string"
      +                  },
      +                  "country": {
      +                    "type": "string"
      +                  },
      +                  "email": {
      +                    "type": "string"
      +                  },
      +                  "fax": {
      +                    "type": "string"
      +                  },
      +                  "name": {
      +                    "type": "string"
      +                  },
      +                  "phone": {
      +                    "type": "string"
      +                  },
      +                  "postalCode": {
      +                    "type": "string"
      +                  },
      +                  "state": {
      +                    "type": "string"
      +                  }
      +                },
      +                "required": [
      +                  "name"
      +                ],
      +                "type": "object"
      +              },
      +              "code": {
      +                "enum": [
      +                  "address_unit_required",
      +                  "address_unverified"
      +                ]
      +              },
      +              "message": {
      +                "type": "string"
      +              },
      +              "role": {
      +                "enum": [
      +                  "recipient",
      +                  "sender"
      +                ]
      +              }
      +            },
      +            "required": [
      +              "role",
      +              "code",
      +              "message",
      +              "address"
      +            ],
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "amountCents": {
      +          "minimum": 0,
      +          "type": "integer"
      +        },
      +        "currency": {
      +          "const": "USD"
      +        },
      +        "document": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "bytes": {
      +              "maximum": 10485760,
      +              "minimum": 1,
      +              "type": "integer"
      +            },
      +            "contentType": {
      +              "const": "application/pdf"
      +            },
      +            "id": {
      +              "minLength": 1,
      +              "type": "string"
      +            },
      +            "name": {
      +              "type": "string"
      +            },
      +            "pages": {
      +              "maximum": 50,
      +              "minimum": 1,
      +              "type": "integer"
      +            },
      +            "previewUrl": {
      +              "format": "uri-reference",
      +              "type": "string"
      +            },
      +            "sha256": {
      +              "pattern": "^[a-f0-9]{64}$",
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "id",
      +            "name",
      +            "pages",
      +            "bytes",
      +            "sha256",
      +            "previewUrl",
      +            "contentType"
      +          ],
      +          "type": "object"
      +        },
      +        "emailMessage": {
      +          "additionalProperties": true,
      +          "type": "object"
      +        },
      +        "estimatedDelivery": {
      +          "type": "string"
      +        },
      +        "expiresAt": {
      +          "type": "string"
      +        },
      +        "handwritten": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "cardId": {
      +              "minLength": 1,
      +              "type": "string"
      +            },
      +            "cardImageUrl": {
      +              "format": "uri",
      +              "type": "string"
      +            },
      +            "cardName": {
      +              "type": "string"
      +            },
      +            "fontId": {
      +              "minLength": 1,
      +              "type": "string"
      +            },
      +            "fontImageUrl": {
      +              "format": "uri",
      +              "type": "string"
      +            },
      +            "fontLabel": {
      +              "type": "string"
      +            },
      +            "message": {
      +              "type": "string"
      +            },
      +            "previewKind": {
      +              "const": "design_and_style_samples"
      +            },
      +            "recipient": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "address1": {
      +                  "type": "string"
      +                },
      +                "address2": {
      +                  "type": "string"
      +                },
      +                "city": {
      +                  "type": "string"
      +                },
      +                "country": {
      +                  "type": "string"
      +                },
      +                "email": {
      +                  "type": "string"
      +                },
      +                "fax": {
      +                  "type": "string"
      +                },
      +                "name": {
      +                  "type": "string"
      +                },
      +                "phone": {
      +                  "type": "string"
      +                },
      +                "postalCode": {
      +                  "type": "string"
      +                },
      +                "state": {
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "name"
      +              ],
      +              "type": "object"
      +            },
      +            "sender": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "address1": {
      +                  "type": "string"
      +                },
      +                "address2": {
      +                  "type": "string"
      +                },
      +                "city": {
      +                  "type": "string"
      +                },
      +                "country": {
      +                  "type": "string"
      +                },
      +                "email": {
      +                  "type": "string"
      +                },
      +                "fax": {
      +                  "type": "string"
      +                },
      +                "name": {
      +                  "type": "string"
      +                },
      +                "phone": {
      +                  "type": "string"
      +                },
      +                "postalCode": {
      +                  "type": "string"
      +                },
      +                "state": {
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "name"
      +              ],
      +              "type": "object"
      +            },
      +            "stampName": {
      +              "type": "string"
      +            },
      +            "stampOptionId": {
      +              "minimum": 0,
      +              "type": "integer"
      +            },
      +            "wishes": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "cardId",
      +            "cardName",
      +            "cardImageUrl",
      +            "fontId",
      +            "fontLabel",
      +            "fontImageUrl",
      +            "message",
      +            "wishes",
      +            "sender",
      +            "recipient",
      +            "previewKind",
      +            "stampOptionId",
      +            "stampName"
      +          ],
      +          "type": "object"
      +        },
      +        "id": {
      +          "minLength": 1,
      +          "type": "string"
      +        },
      +        "lineItems": {
      +          "items": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "amountCents": {
      +                "minimum": 0,
      +                "type": "integer"
      +              },
      +              "label": {
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "label",
      +              "amountCents"
      +            ],
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "options": {
      +          "additionalProperties": true,
      +          "type": "object"
      +        },
      +        "recipient": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "address1": {
      +              "type": "string"
      +            },
      +            "address2": {
      +              "type": "string"
      +            },
      +            "city": {
      +              "type": "string"
      +            },
      +            "country": {
      +              "type": "string"
      +            },
      +            "email": {
      +              "type": "string"
      +            },
      +            "fax": {
      +              "type": "string"
      +            },
      +            "name": {
      +              "type": "string"
      +            },
      +            "phone": {
      +              "type": "string"
      +            },
      +            "postalCode": {
      +              "type": "string"
      +            },
      +            "state": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "name"
      +          ],
      +          "type": "object"
      +        },
      +        "sender": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "address1": {
      +              "type": "string"
      +            },
      +            "address2": {
      +              "type": "string"
      +            },
      +            "city": {
      +              "type": "string"
      +            },
      +            "country": {
      +              "type": "string"
      +            },
      +            "email": {
      +              "type": "string"
      +            },
      +            "fax": {
      +              "type": "string"
      +            },
      +            "name": {
      +              "type": "string"
      +            },
      +            "phone": {
      +              "type": "string"
      +            },
      +            "postalCode": {
      +              "type": "string"
      +            },
      +            "state": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "name"
      +          ],
      +          "type": "object"
      +        },
      +        "service": {
      +          "enum": [
      +            "fax",
      +            "letter",
      +            "certified",
      +            "postcard",
      +            "handwritten"
      +          ]
      +        },
      +        "summary": {
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "id",
      +        "service",
      +        "amountCents",
      +        "currency",
      +        "lineItems",
      +        "expiresAt",
      +        "estimatedDelivery",
      +        "summary",
      +        "recipient",
      +        "sender",
      +        "options"
      +      ],
      +      "type": "object"
      +    },
      +    {
      +      "additionalProperties": false,
      +      "properties": {
      +        "error": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "code": {
      +              "minLength": 1,
      +              "type": "string"
      +            },
      +            "details": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "addressRole": {
      +                  "enum": [
      +                    "recipient",
      +                    "sender"
      +                  ]
      +                },
      +                "canSendAsEntered": {
      +                  "type": "boolean"
      +                }
      +              },
      +              "required": [
      +                "addressRole",
      +                "canSendAsEntered"
      +              ],
      +              "type": "object"
      +            },
      +            "message": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "code",
      +            "message"
      +          ],
      +          "type": "object"
      +        }
      +      },
      +      "required": [
      +        "error"
      +      ],
      +      "type": "object"
      +    }
      +  ],
      +  "type": "object"
      +}
  8. First observed

TDQS

A4.6/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Goes well beyond the annotations by disclosing that quotes expire, that document quotes include a proof of every page while handwritten quotes include only text/address plus style samples, and the exact error/warning flow for unverifiable addresses (details.canSendAsEntered, options.sendAsEntered, addressWarnings accepted only on the browser review page). This clarifies the non-destructive but stateful nature implied by readOnlyHint=false and idempotentHint=false.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Dense but front-loaded: the core action, scope, per-service input rules, return payload, error path, and exclusions arrive in that order. A few clauses restate schema rules (e.g., what handwritten cards take) and could be trimmed, but almost every sentence carries information an agent would otherwise have to infer.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a five-parameter, nested-object tool with no output schema, the description covers the missing return contract ('Returns the quote with its final preview, recipient, total and expiry') and the failure mode for address verification. Combined with full schema coverage and annotation-declared safety profile, an agent has what it needs to call this correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3, but the description adds meaning on top: documentId applies to all services except handwritten, and handwritten instead requires productId, fontLabel and message. It also explains what sendAsEntered is for and who it applies to, which the schema only partly conveys.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a specific verb and resource ('Creates a time-limited price quote for one physical delivery') and enumerates the supported channels (letter/PDF, certified, postcard, fax, handwritten). It distinguishes quoting from downstream actions by stating it 'Does not approve, charge or send an order', which separates it from checkout/order siblings without needing to name them.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Use context is clear: quote one document/product to one recipient before paying, and the negative clauses ('Does not draft or edit documents, summarize PDFs or send email') exclude adjacent tools. It stops short of naming the sibling to call next for payment (e.g., checkout), leaving that routing to inference.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources