{"tools":[{"name":"catalog","description":"Read the paper, envelope, style and configured price catalog.","inputSchema":{"type":"object","properties":{},"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"openWorldHint":false}},{"name":"list_drafts","description":"List saved shared drafts.","inputSchema":{"type":"object","properties":{},"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"openWorldHint":false}},{"name":"create_draft","description":"Create a shared letter draft without ordering or payment.","inputSchema":{"$defs":{"Address":{"additionalProperties":false,"properties":{"name":{"default":"","maxLength":100,"title":"Name","type":"string"},"line1":{"default":"","maxLength":120,"title":"Line1","type":"string"},"line2":{"default":"","maxLength":100,"title":"Line2","type":"string"},"city":{"default":"","maxLength":80,"title":"City","type":"string"},"state":{"default":"","maxLength":2,"title":"State","type":"string"},"postal_code":{"default":"","maxLength":10,"title":"Postal Code","type":"string"},"country":{"const":"US","default":"US","title":"Country","type":"string"}},"title":"Address","type":"object"},"Decoration":{"additionalProperties":false,"properties":{"id":{"maxLength":100,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Id","type":"string"},"file_id":{"maxLength":100,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"File Id","type":"string"},"page":{"default":1,"maximum":100,"minimum":1,"title":"Page","type":"integer"},"page_id":{"anyOf":[{"maxLength":100,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"default":null,"title":"Page Id"},"page_offset":{"default":0,"maximum":99,"minimum":0,"title":"Page Offset","type":"integer"},"x":{"maximum":1,"minimum":0,"title":"X","type":"number"},"y":{"maximum":1,"minimum":0,"title":"Y","type":"number"},"width":{"maximum":1,"minimum":0.02,"title":"Width","type":"number"},"height":{"maximum":1,"minimum":0.02,"title":"Height","type":"number"}},"required":["id","file_id","x","y","width","height"],"title":"Decoration","type":"object"},"HandwritingConfig":{"additionalProperties":false,"properties":{"seed":{"maxLength":100,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Seed","type":"string"},"engine_version":{"const":"joined-1","default":"joined-1","title":"Engine Version","type":"string"}},"required":["seed"],"title":"HandwritingConfig","type":"object"},"OriginalHandConfig":{"additionalProperties":false,"properties":{"seed":{"maxLength":100,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Seed","type":"string"},"engine_version":{"const":"original-1","default":"original-1","title":"Engine Version","type":"string"},"foundation_version":{"const":"study01-v1","default":"study01-v1","title":"Foundation Version","type":"string"}},"required":["seed"],"title":"OriginalHandConfig","type":"object"},"PageContent":{"additionalProperties":false,"properties":{"id":{"maxLength":100,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Id","type":"string"},"text":{"default":"","maxLength":30000,"title":"Text","type":"string"},"content_type":{"default":"text","enum":["text","markdown"],"title":"Content Type","type":"string"}},"required":["id"],"title":"PageContent","type":"object"}},"additionalProperties":false,"properties":{"title":{"default":"Untitled letter","maxLength":150,"title":"Title","type":"string"},"text":{"default":"","maxLength":30000,"title":"Text","type":"string"},"content_type":{"default":"text","enum":["text","markdown","pdf"],"title":"Content Type","type":"string"},"paper":{"default":"classic","enum":["classic","ivory"],"title":"Paper","type":"string"},"envelope":{"default":"white","enum":["white","kraft"],"title":"Envelope","type":"string"},"style":{"default":"serif","enum":["serif","sans","handwritten","typewriter","original_hand"],"title":"Style","type":"string"},"recipient":{"$ref":"#/$defs/Address"},"sender":{"$ref":"#/$defs/Address"},"decorations":{"items":{"$ref":"#/$defs/Decoration"},"maxItems":20,"title":"Decorations","type":"array"},"pages":{"items":{"$ref":"#/$defs/PageContent"},"maxItems":20,"title":"Pages","type":"array"},"handwriting":{"anyOf":[{"$ref":"#/$defs/HandwritingConfig"},{"type":"null"}],"default":null},"original_hand":{"anyOf":[{"$ref":"#/$defs/OriginalHandConfig"},{"type":"null"}],"default":null}},"title":"CreateDraft","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"openWorldHint":false}},{"name":"get_draft","description":"Read the newest shared draft and revision.","inputSchema":{"type":"object","properties":{"draft_id":{"type":"string"}},"required":["draft_id"],"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"openWorldHint":false}},{"name":"update_draft","description":"Update a shared draft using its current revision; stale changes are rejected.","inputSchema":{"$defs":{"Address":{"additionalProperties":false,"properties":{"name":{"default":"","maxLength":100,"title":"Name","type":"string"},"line1":{"default":"","maxLength":120,"title":"Line1","type":"string"},"line2":{"default":"","maxLength":100,"title":"Line2","type":"string"},"city":{"default":"","maxLength":80,"title":"City","type":"string"},"state":{"default":"","maxLength":2,"title":"State","type":"string"},"postal_code":{"default":"","maxLength":10,"title":"Postal Code","type":"string"},"country":{"const":"US","default":"US","title":"Country","type":"string"}},"title":"Address","type":"object"},"Decoration":{"additionalProperties":false,"properties":{"id":{"maxLength":100,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Id","type":"string"},"file_id":{"maxLength":100,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"File Id","type":"string"},"page":{"default":1,"maximum":100,"minimum":1,"title":"Page","type":"integer"},"page_id":{"anyOf":[{"maxLength":100,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"default":null,"title":"Page Id"},"page_offset":{"default":0,"maximum":99,"minimum":0,"title":"Page Offset","type":"integer"},"x":{"maximum":1,"minimum":0,"title":"X","type":"number"},"y":{"maximum":1,"minimum":0,"title":"Y","type":"number"},"width":{"maximum":1,"minimum":0.02,"title":"Width","type":"number"},"height":{"maximum":1,"minimum":0.02,"title":"Height","type":"number"}},"required":["id","file_id","x","y","width","height"],"title":"Decoration","type":"object"},"HandwritingConfig":{"additionalProperties":false,"properties":{"seed":{"maxLength":100,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Seed","type":"string"},"engine_version":{"const":"joined-1","default":"joined-1","title":"Engine Version","type":"string"}},"required":["seed"],"title":"HandwritingConfig","type":"object"},"OriginalHandConfig":{"additionalProperties":false,"properties":{"seed":{"maxLength":100,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Seed","type":"string"},"engine_version":{"const":"original-1","default":"original-1","title":"Engine Version","type":"string"},"foundation_version":{"const":"study01-v1","default":"study01-v1","title":"Foundation Version","type":"string"}},"required":["seed"],"title":"OriginalHandConfig","type":"object"},"PageContent":{"additionalProperties":false,"properties":{"id":{"maxLength":100,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Id","type":"string"},"text":{"default":"","maxLength":30000,"title":"Text","type":"string"},"content_type":{"default":"text","enum":["text","markdown"],"title":"Content Type","type":"string"}},"required":["id"],"title":"PageContent","type":"object"}},"additionalProperties":false,"properties":{"version":{"minimum":1,"title":"Version","type":"integer"},"title":{"anyOf":[{"maxLength":150,"type":"string"},{"type":"null"}],"default":null,"title":"Title"},"text":{"anyOf":[{"maxLength":30000,"type":"string"},{"type":"null"}],"default":null,"title":"Text"},"content_type":{"anyOf":[{"enum":["text","markdown","pdf"],"type":"string"},{"type":"null"}],"default":null,"title":"Content Type"},"paper":{"anyOf":[{"enum":["classic","ivory"],"type":"string"},{"type":"null"}],"default":null,"title":"Paper"},"envelope":{"anyOf":[{"enum":["white","kraft"],"type":"string"},{"type":"null"}],"default":null,"title":"Envelope"},"style":{"anyOf":[{"enum":["serif","sans","handwritten","typewriter","original_hand"],"type":"string"},{"type":"null"}],"default":null,"title":"Style"},"recipient":{"anyOf":[{"$ref":"#/$defs/Address"},{"type":"null"}],"default":null},"sender":{"anyOf":[{"$ref":"#/$defs/Address"},{"type":"null"}],"default":null},"decorations":{"anyOf":[{"items":{"$ref":"#/$defs/Decoration"},"maxItems":20,"type":"array"},{"type":"null"}],"default":null,"title":"Decorations"},"pages":{"anyOf":[{"items":{"$ref":"#/$defs/PageContent"},"maxItems":20,"type":"array"},{"type":"null"}],"default":null,"title":"Pages"},"handwriting":{"anyOf":[{"$ref":"#/$defs/HandwritingConfig"},{"type":"null"}],"default":null},"original_hand":{"anyOf":[{"$ref":"#/$defs/OriginalHandConfig"},{"type":"null"}],"default":null},"draft_id":{"type":"string"}},"required":["version","draft_id"],"title":"UpdateDraft","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"openWorldHint":false}},{"name":"upload_attachment","description":"Upload a PDF or photo as base64 to a shared draft.","inputSchema":{"additionalProperties":false,"properties":{"version":{"minimum":1,"title":"Version","type":"integer"},"kind":{"enum":["pdf","photo","decoration"],"title":"Kind","type":"string"},"name":{"maxLength":150,"title":"Name","type":"string"},"content_base64":{"maxLength":14000000,"title":"Content Base64","type":"string"},"draft_id":{"type":"string"}},"required":["version","kind","name","content_base64","draft_id"],"title":"FileUpload","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"openWorldHint":false}},{"name":"remove_attachment","description":"Remove an attachment from the draft without changing existing order snapshots.","inputSchema":{"type":"object","properties":{"file_id":{"type":"string"},"version":{"type":"integer"},"draft_id":{"type":"string"}},"required":["file_id","version","draft_id"],"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"openWorldHint":false}},{"name":"preview","description":"Generate exact print PDFs and page preview images for this version.","inputSchema":{"additionalProperties":false,"properties":{"version":{"minimum":1,"title":"Version","type":"integer"},"draft_id":{"type":"string"}},"required":["version","draft_id"],"title":"Version","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"openWorldHint":false}},{"name":"quote","description":"Obtain the configured, expiring quote for this version.","inputSchema":{"additionalProperties":false,"properties":{"version":{"minimum":1,"title":"Version","type":"integer"},"draft_id":{"type":"string"}},"required":["version","draft_id"],"title":"Version","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"openWorldHint":false}},{"name":"checkout","description":"Create a real Stripe checkout session after explicit approval of the package and price. Returns a payment URL; never implies payment succeeded.","inputSchema":{"additionalProperties":false,"properties":{"version":{"minimum":1,"title":"Version","type":"integer"},"quote_id":{"title":"Quote Id","type":"string"},"preview_id":{"title":"Preview Id","type":"string"},"approved":{"title":"Approved","type":"boolean"},"idempotency_key":{"maxLength":150,"minLength":8,"title":"Idempotency Key","type":"string"},"draft_id":{"type":"string"}},"required":["version","quote_id","preview_id","approved","idempotency_key","draft_id"],"title":"Checkout","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"openWorldHint":false}},{"name":"list_orders","description":"List your orders.","inputSchema":{"type":"object","properties":{},"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"openWorldHint":false}},{"name":"get_order","description":"Read an immutable order and fulfillment history.","inputSchema":{"type":"object","properties":{"order_id":{"type":"string"}},"required":["order_id"],"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"openWorldHint":false}}],"transport":"OAuth MCP: /mcp; trusted Mac-only compatibility bridge: /api/private/mcp","payments":{"ready":true,"message":"","connected":true,"pricing_ready":true,"terms_url":"https://www.mailbypony.com/terms"}}