Skip to main content
Glama

Postedly

by com.postedly
OverviewDiscussionsAdmin

postedly_quote

Creates a price quote for mailing a physical letter or PDF, sending a fax or postcard, or ordering another available Postedly delivery service. It does not draft or edit documents, summarize PDFs, or send email. Creates a time-limited quote for one exact document or product and one recipient, including tax and delivery costs. Documents require an existing private document ID. Handwritten cards use a selected card, handwriting style, message and optional closing; no PDF is required. Their quote includes immutable text and address details with card-design and handwriting-style samples, not an image of the finished message. Returns the final preview, recipient, total and expiry. Quoting does not approve, charge or send an order.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
senderYesSender 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.
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. 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
  2. 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"
+}
  3. First observed

TDQS

A4.3/5.0
Behavior5/5

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

Beyond the sparse annotations, it discloses several important behaviors: the quote is time-limited, requires an existing private document ID, contains immutable text and address details, uses card-design/handwriting-style samples rather than a finished image, and does not approve, charge, or send. This significantly extends the readOnlyHint=false/destructiveHint=false annotations and sets accurate expectations for side effects.

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?

The description is long but every sentence carries distinct information: purpose, exclusions, prerequisites, handwritten-card special case, behavioral caveats, and return contents. It is front-loaded with purpose and exclusions, and the length is justified by the tool's complexity.

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?

Given the complex nested schema and no output schema, the description appropriately summarizes the return value ('final preview, recipient, total and expiry') and service-specific cases. It could be more complete about service-specific required fields and the follow-up approval/checkout flow, but the schema and sibling context fill most of those gaps.

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

Parameters3/5

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

Schema description coverage is only 40%, so the description must compensate. It does add meaning for document ID and handwritten-card options ('no PDF is required', 'message and optional closing'), but it does not explain the service enum values, sender/recipient postal requirements, productId sourcing, or sendAsEntered. Those details remain in the schema, so compensation is only partial.

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 names a specific action and resource: 'Creates a price quote for mailing a physical letter or PDF, sending a fax or postcard, or ordering another available Postedly delivery service.' It also explicitly lists non-goals ('does not draft or edit documents, summarize PDFs, or send email'), which separates it clearly from the document-preparation and order-execution sibling tools.

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?

The description gives clear contextual guidance: documents require an existing private document ID, handwritten cards need a selected card/handwriting style/message, and quoting does not approve, charge, or send an order. It does not explicitly name postedly_checkout as the follow-up tool, so the routing could be slightly more direct, but the boundaries are clear.

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