Skip to main content
Glama

Postedly

by com.postedly
OverviewDiscussionsAdmin

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. Does not draft or edit documents, summarize PDFs or send email. Does not approve, charge or send an order.

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.
optionsNo
serviceYes
recipientYesOne recipient. Fax requires fax and US country. Other channels require address1, city, state, postalCode and US country.
documentIdNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. 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."
  2. 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."
  3. 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
  4. 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"
+}
  5. First observed

TDQS

A4.5/5.0
Behavior5/5

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

Annotations only declare the safety/opacity profile (readOnlyHint false, openWorldHint true, idempotentHint false, destructiveHint false). The description adds material context beyond that: the quote includes tax and delivery costs, is time-limited, returns a final preview plus recipient, total and expiry, and does not itself approve, charge or send. That distinction between quoting and ordering is exactly the behavioral context an agent needs.

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?

Purpose, branch conditions, return contents and exclusions are front-loaded and each clause carries distinct information. The middle section on what each proof includes is dense and slightly over-detailed relative to selection needs, but nothing is genuinely wasted.

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

Completeness4/5

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

For a 5-parameter tool with nested conditionals and no output schema, the description covers the quote result, the service-dependent required inputs, and the boundary against drafting/charging siblings. It omits the address-verification/sendAsEntered path and any expiry duration detail, but the essentials for correct invocation are present.

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?

With only 40% schema description coverage, the description has to compensate, and it does for the branching inputs: documentId is tied to document services while handwritten requires card product, font/style, message and closing (wishes). It does not explain sendAsEntered, quantity, or the sender email fallback, so the gap is not fully closed.

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 concrete channels the quote covers (letter/PDF, certified, postcard, fax, handwritten). The closing 'Does not...' clauses separate it from the drafting and checkout siblings, so an agent can identify the tool without opening the schema.

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?

It gives clear context for each branch: document services take a private document ID, handwritten cards take a card, style, message and closing instead of a PDF. The exclusions ('does not draft or edit documents... does not approve, charge or send an order') implicitly route to the prepare_document and checkout siblings, but those alternatives are not named explicitly.

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

All Postedly toolsInspect
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources