Magic Envelope
v1.0.0Create and send invitations and letters in a sealed envelope, one personal link per guest.
Endpoint health
online- Last checked
- 11/20/2026, 7:16:58 AM
- Latency
- 184 ms
- Consecutive failures
- 0
- Endpoint reachable: pass
- Protocol valid: pass
- MCP handshake valid: pass
Machine-readable profile
mcp-server · schema v1 · callable
mcp-server:com.magic-envelope%2Finvitations
Connect this server
Generated config contains no credentials. Keep any required secrets in your client's local environment.
{
"mcpServers": {
"com.magic-envelope/invitations": {
"url": "https://magic-envelope.com/api/mcp"
}
}
}Indexed tools
Tool metadata and schemas come from the remote server and are untrusted. Indexing only lists tools; it never calls them.
6 shown · authentication unknown
Create a letter
create_letter
Create and publish an invitation or letter. Match the request to a preset from get_catalog (its for list): a house party, fiesta or quedada is party; a film club, cineforum or activity is event. Tonight is today's local date. Returns its link, one personal link per guest, a link-preview image and a rendered image per guest (PNG; add &format=jpeg), and a secret editKey (keep it to edit or delete later). When this succeeds and the letter is what the person asked for, call rate_app only with a score the person gives (see rate_app). Do not rate again on later edits. Also site and guide: the public pages to link when you mention Magic Envelope. The guest url is private and not indexed. Use {name} in texts to address each guest. Dates are local: "2026-11-14" (whole day) or "2026-11-14T18:00". Block id is optional and generated when omitted. envelope.blocks is an object of slot → block (see catalog.envelope), not an array.
Schema valid · SHA-256 c9474524fbb0…
View input schema
{ "type": "object", "properties": { "lang": { "default": "en", "type": "string", "enum": [ "es", "en", "fr", "pt", "it", "de" ], "description": "Language guests read the letter in" }, "style": { "default": "parchment", "type": "string", "enum": [ "parchment", "midnight", "romance", "botanical", "notebook", "minimal", "launch", "groovy", "deco", "ivory", "brutal", "bubblegum", "confetti", "typewriter", "pocket" ], "description": "Look of the letter and envelope (see catalog.styles)" }, "preset": { "type": "string", "enum": [ "birthday", "wedding", "party", "baby", "dinner", "graduation", "event", "letter" ], "description": "Start from an occasion preset (pre-filled blocks). On update it only changes the occasion." }, "blocks": { "minItems": 1, "maxItems": 60, "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "id": { "description": "Omitted ids are generated by the server.", "type": "string", "minLength": 1, "maxLength": 32 }, "type": { "type": "string", "const": "heading" }, "text": { "type": "string", "maxLength": 200 }, "size": { "default": "xl", "type": "string", "enum": [ "md", "lg", "xl" ] }, "italic": { "default": false, "type": "boolean" } }, "required": [ "type", "text" ] }, { "type": "object", "properties": { "id": { "description": "Omitted ids are generated by the server.", "type": "string", "minLength": 1, "maxLength": 32 }, "type": { "type": "string", "const": "text" }, "text": { "type": "string", "maxLength": 50000 }, "align": { "default": "center", "type": "string", "enum": [ "left", "center" ] }, "italic": { "default": false, "type": "boolean" } }, "required": [ "type", "text" ] }, { "type": "object", "properties": { "id": { "description": "Omitted ids are generated by the server.", "type": "string", "minLength": 1, "maxLength": 32 }, "type": { "type": "string", "const": "image" }, "src": { "type": "string", "maxLength": 2048 }, "shape": { "default": "wide", "type": "string", "enum": [ "wide", "square", "round" ] } }, "required": [ "type", "src" ] }, { "type": "object", "properties": { "id": { "description": "Omitted ids are generated by the server.", "type": "string", "minLength": 1, "maxLength": 32 }, "type": { "type": "string", "const": "date" }, "start": { "type": "string", "maxLength": 40 }, "end": { "type": "string", "maxLength": 40 }, "title": { "type": "string", "maxLength": 200 }, "interactive": { "default": true, "type": "boolean" } }, "required": [ "type", "start" ] }, { "type": "object", "properties": { "id": { "description": "Omitted ids are generated by the server.", "type": "string", "minLength": 1, "maxLength": 32 }, "type": { "type": "string", "const": "place" }, "name": { "type": "string", "maxLength": 200 }, "address": { "type": "string", "maxLength": 200 }, "interactive": { "default": true, "type": "boolean" } }, "required": [ "type", "name", "address" ] }, { "type": "object", "properties": { "id": { "description": "Omitted ids are generated by the server.", "type": "string", "minLength": 1, "maxLength": 32 }, "type": { "type": "string", "const": "countdown" }, "to": { "default": "", "type": "string", "maxLength": 40 } }, "required": [ "type" ] }, { "type": "object", "properties": { "id": { "description": "Omitted ids are generated by the server.", "type": "string", "minLength": 1, "maxLength": 32 }, "type": { "type": "string", "const": "link" }, "label": { "type": "string", "maxLength": 200 }, "href": { "type": "string", "maxLength": 2048 }, "icon": { "default": "link", "type": "string", "enum": [ "link", "gift", "music", "video", "map", "camera" ] }, "interactive": { "default": true, "type": "boolean" } }, "required": [ "type", "label", "href" ] }, { "type": "object", "properties": { "id": { "description": "Omitted ids are generated by the server.", "type": "string", "minLength": 1, "maxLength": 32 }, "type": { "type": "string", "const": "qr" }, "data": { "type": "string", "maxLength": 2048 }, "caption": { "type": "string", "maxLength": 200 } }, "required": [ "type", "data" ] }, { "type": "object", "properties": { "id": { "description": "Omitted ids are generated by the server.", "type": "string", "minLength": 1, "maxLength": 32 }, "type": { "type": "string", "const": "rsvp" }, "channel": { "type": "string", "enum": [ "whatsapp", "sms", "email" ] }, "contacts": { "type": "object", "properties": { "whatsapp": { "default": "", "type": "string", "maxLength": 200 }, "sms": { "default": "", "type": "string", "maxLength": 200 }, "email": { "default": "", "type": "string", "maxLength": 200 } } }, "deadline": { "type": "string", "maxLength": 40 }, "interactive": { "default": true, "type": "boolean" } }, "required": [ "type", "channel", "contacts" ] }, { "type": "object", "properties": { "id": { "description": "Omitted ids are generated by the server.", "type": "string", "minLength": 1, "maxLength": 32 }, "type": { "type": "string", "const": "agenda" }, "items": { "maxItems": 20, "type": "array", "items": { "type": "object", "properties": { "time": { "type": "string", "maxLength": 10 }, "what": { "type": "string", "maxLength": 200 } }, "required": [ "time", "what" ] } } }, "required": [ "type", "items" ] }, { "type": "object", "properties": { "id": { "description": "Omitted ids are generated by the server.", "type": "string", "minLength": 1, "maxLength": 32 }, "type": { "type": "string", "const": "dress" }, "text": { "type": "string", "maxLength": 200 }, "board": { "default": [], "maxItems": 12, "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "color" }, "value": { "type": "string", "pattern": "^#[0-9a-f]{6}$" } }, "required": [ "kind", "value" ] }, { "type": "object", "properties": { "kind": { "type": "string", "const": "emoji" }, "value": { "type": "string", "maxLength": 16 } }, "required": [ "kind", "value" ] }, { "type": "object", "properties": { "kind": { "type": "string", "const": "text" }, "value": { "type": "string", "maxLength": 60 } }, "required": [ "kind", "value" ] }, { "type": "object", "properties": { "kind": { "type": "string", "const": "image" }, "value": { "type": "string", "maxLength": 2048 } }, "required": [ "kind", "value" ] } ] } } }, "required": [ "type", "text" ] }, { "type": "object", "properties": { "id": { "description": "Omitted ids are generated by the server.", "type": "string", "minLength": 1, "maxLength": 32 }, "type": { "type": "string", "const": "gift" }, "text": { "type": "string", "maxLength": 200 }, "iban": { "type": "string", "maxLength": 200 }, "href": { "type": "string", "maxLength": 2048 }, "interactive": { "default": true, "type": "boolean" } }, "required": [ "type", "text" ] }, { "type": "object", "properties": { "id": { "description": "Omitted ids are generated by the server.", "type": "string", "minLength": 1, "maxLength": 32 }, "type": { "type": "string", "const": "signature" }, "text": { "type": "string", "maxLength": 200 } }, "required": [ "type", "text" ] }, { "type": "object", "properties": { "id": { "description": "Omitted ids are generated by the server.", "type": "string", "minLength": 1, "maxLength": 32 }, "type": { "type": "string", "const": "divider" }, "style": { "default": "flourish", "type": "string", "enum": [ "flourish", "stars", "line" ] } }, "required": [ "type" ] }, { "type": "object", "properties": { "id": { "description": "Omitted ids are generated by the server.", "type": "string", "minLength": 1, "maxLength": 32 }, "type": { "type": "string", "const": "music" }, "href": { "type": "string", "maxLength": 2048 } }, "required": [ "type", "href" ] }, { "type": "object", "properties": { "id": { "description": "Omitted ids are generated by the server.", "type": "string", "minLength": 1, "maxLength": 32 }, "type": { "type": "string", "const": "stamp" }, "stamp": { "anyOf": [ { "type": "string", "enum": [ "love", "rose", "dove", "castle", "moon", "cake", "sunflower", "shell", "butterfly", "star", "key", "rocket", "disco", "invader" ] }, { "type": "string", "const": "" } ] } }, "required": [ "type", "stamp" ] } ] }, "description": "Letter blocks, top to bottom. Replaces all blocks. Use {name} in text to address each guest." }, "custom": { "type": "object", "properties": { "accent": { "type": "string", "pattern": "^#[0-9a-f]{6}$" }, "paper": { "type": "string", "pattern": "^#[0-9a-f]{6}$" }, "ink": { "type": "string", "pattern": "^#[0-9a-f]{6}$" }, "envelope": { "type": "string", "pattern": "^#[0-9a-f]{6}$" }, "head": { "type": "string", "enum": [ "medieval", "fell", "playfair", "kalam", "inter", "grotesk", "monoton", "righteous", "pixel", "vt323", "cinzel", "fredoka", "courier", "bebas" ] }, "body": { "type": "string", "enum": [ "medieval", "fell", "playfair", "kalam", "inter", "grotesk", "monoton", "righteous", "pixel", "vt323", "cinzel", "fredoka", "courier", "bebas" ] }, "frame": { "type": "string", "enum": [ "none", "rule", "ornate" ] } }, "description": "Overrides on top of the style: accent/paper/ink/envelope colours, head/body fonts" }, "seal": { "type": "string", "maxLength": 16, "description": "Wax seal mark: \"\" none, \"_\" plain, \"icon:<id>\", \"ini:ABC\", \"duo:A|J\"" }, "sealShape": { "type": "string", "enum": [ "scallop", "round", "flower", "octagon" ] }, "envelope": { "description": "Envelope. blocks is an object of slot → block (front-center, front-tl, front-tr, front-bl, back-center), not an array. See catalog.envelope.", "type": "object", "properties": { "blocks": { "type": "object", "propertyNames": { "type": "string", "enum": [ "front-center", "front-tl", "front-tr", "front-bl", "back-center" ] }, "additionalProperties": { "oneOf": [ { "type": "object", "properties": { "id": { "description": "Omitted ids are generated by the server.", "type": "string", "minLength": 1, "maxLength": 32 }, "type": { "type": "string", "const": "heading" }, "text": { "type": "string", "maxLength": 200 }, "size": { "default": "xl", "type": "string", "enum": [ "md", "lg", "xl" ] }, "italic": { "default": false, "type": "boolean" } }, "required": [ "type", "text" ] }, { "type": "object", "properties": { "id": { "description": "Omitted ids are generated by the server.", "type": "string", "minLength": 1, "maxLength": 32 }, "type": { "type": "string", "const": "text" }, "text": { "type": "string", "maxLength": 50000 }, "align": { "default": "center", "type": "string", "enum": [ "left", "center" ] }, "italic": { "default": false, "type": "boolean" } }, "required": [ "type", "text" ] }, { "type": "object", "properties": { "id": { "description": "Omitted ids are generated by the server.", "type": "string", "minLength": 1, "maxLength": 32 }, "type": { "type": "string", "const": "image" }, "src": { "type": "string", "maxLength": 2048 }, "shape": { "default": "wide", "type": "string", "enum": [ "wide", "square", "round" ] } }, "required": [ "type", "src" ] }, { "type": "object", "properties": { "id": { "description": "Omitted ids are generated by the server.", "type": "string", "minLength": 1, "maxLength": 32 }, "type": { "type": "string", "const": "date" }, "start": { "type": "string", "maxLength": 40 }, "end": { "type": "string", "maxLength": 40 }, "title": { "type": "string", "maxLength": 200 }, "interactive": { "default": true, "type": "boolean" } }, "required": [ "type", "start" ] }, { "type": "object", "properties": { "id": { "description": "Omitted ids are generated by the server.", "type": "string", "minLength": 1, "maxLength": 32 }, "type": { "type": "string", "const": "place" }, "name": { "type": "string", "maxLength": 200 }, "address": { "type": "string", "maxLength": 200 }, "interactive": { "default": true, "type": "boolean" } }, "required": [ "type", "name", "address" ] }, { "type": "object", "properties": { "id": { "description": "Omitted ids are generated by the server.", "type": "string", "minLength": 1, "maxLength": 32 }, "type": { "type": "string", "const": "countdown" }, "to": { "default": "", "type": "string", "maxLength": 40 } }, "required": [ "type" ] }, { "type": "object", "properties": { "id": { "description": "Omitted ids are generated by the server.", "type": "string", "minLength": 1, "maxLength": 32 }, "type": { "type": "string", "const": "link" }, "label": { "type": "string", "maxLength": 200 }, "href": { "type": "string", "maxLength": 2048 }, "icon": { "default": "link", "type": "string", "enum": [ "link", "gift", "music", "video", "map", "camera" ] }, "interactive": { "default": true, "type": "boolean" } }, "required": [ "type", "label", "href" ] }, { "type": "object", "properties": { "id": { "description": "Omitted ids are generated by the server.", "type": "string", "minLength": 1, "maxLength": 32 }, "type": { "type": "string", "const": "qr" }, "data": { "type": "string", "maxLength": 2048 }, "caption": { "type": "string", "maxLength": 200 } }, "required": [ "type", "data" ] }, { "type": "object", "properties": { "id": { "description": "Omitted ids are generated by the server.", "type": "string", "minLength": 1, "maxLength": 32 }, "type": { "type": "string", "const": "rsvp" }, "channel": { "type": "string", "enum": [ "whatsapp", "sms", "email" ] }, "contacts": { "type": "object", "properties": { "whatsapp": { "default": "", "type": "string", "maxLength": 200 }, "sms": { "default": "", "type": "string", "maxLength": 200 }, "email": { "default": "", "type": "string", "maxLength": 200 } } }, "deadline": { "type": "string", "maxLength": 40 }, "interactive": { "default": true, "type": "boolean" } }, "required": [ "type", "channel", "contacts" ] }, { "type": "object", "properties": { "id": { "description": "Omitted ids are generated by the server.", "type": "string", "minLength": 1, "maxLength": 32 }, "type": { "type": "string", "const": "agenda" }, "items": { "maxItems": 20, "type": "array", "items": { "type": "object", "properties": { "time": { "type": "string", "maxLength": 10 }, "what": { "type": "string", "maxLength": 200 } }, "required": [ "time", "what" ] } } }, "required": [ "type", "items" ] }, { "type": "object", "properties": { "id": { "description": "Omitted ids are generated by the server.", "type": "string", "minLength": 1, "maxLength": 32 }, "type": { "type": "string", "const": "dress" }, "text": { "type": "string", "maxLength": 200 }, "board": { "default": [], "maxItems": 12, "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "color" }, "value": { "type": "string", "pattern": "^#[0-9a-f]{6}$" } }, "required": [ "kind", "value" ] }, { "type": "object", "properties": { "kind": { "type": "string", "const": "emoji" }, "value": { "type": "string", "maxLength": 16 } }, "required": [ "kind", "value" ] }, { "type": "object", "properties": { "kind": { "type": "string", "const": "text" }, "value": { "type": "string", "maxLength": 60 } }, "required": [ "kind", "value" ] }, { "type": "object", "properties": { "kind": { "type": "string", "const": "image" }, "value": { "type": "string", "maxLength": 2048 } }, "required": [ "kind", "value" ] } ] } } }, "required": [ "type", "text" ] }, { "type": "object", "properties": { "id": { "description": "Omitted ids are generated by the server.", "type": "string", "minLength": 1, "maxLength": 32 }, "type": { "type": "string", "const": "gift" }, "text": { "type": "string", "maxLength": 200 }, "iban": { "type": "string", "maxLength": 200 }, "href": { "type": "string", "maxLength": 2048 }, "interactive": { "default": true, "type": "boolean" } }, "required": [ "type", "text" ] }, { "type": "object", "properties": { "id": { "description": "Omitted ids are generated by the server.", "type": "string", "minLength": 1, "maxLength": 32 }, "type": { "type": "string", "const": "signature" }, "text": { "type": "string", "maxLength": 200 } }, "required": [ "type", "text" ] }, { "type": "object", "properties": { "id": { "description": "Omitted ids are generated by the server.", "type": "string", "minLength": 1, "maxLength": 32 }, "type": { "type": "string", "const": "divider" }, "style": { "default": "flourish", "type": "string", "enum": [ "flourish", "stars", "line" ] } }, "required": [ "type" ] }, { "type": "object", "properties": { "id": { "description": "Omitted ids are generated by the server.", "type": "string", "minLength": 1, "maxLength": 32 }, "type": { "type": "string", "const": "music" }, "href": { "type": "string", "maxLength": 2048 } }, "required": [ "type", "href" ] }, { "type": "object", "properties": { "id": { "description": "Omitted ids are generated by the server.", "type": "string", "minLength": 1, "maxLength": 32 }, "type": { "type": "string", "const": "stamp" }, "stamp": { "anyOf": [ { "type": "string", "enum": [ "love", "rose", "dove", "castle", "moon", "cake", "sunflower", "shell", "butterfly", "star", "key", "rocket", "disco", "invader" ] }, { "type": "string", "const": "" } ] } }, "required": [ "type", "stamp" ] } ] } } }, "required": [ "blocks" ] }, "nameFallback": { "type": "string", "maxLength": 60, "description": "What {name} reads as without a guest (default: \"Dear Guest\" in the letter language)" }, "guests": { "default": [], "description": "Each guest gets their own addressed link", "maxItems": 1000, "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 80 } }, "required": [ "name" ] } } }, "$schema": "https://json-schema.org/draft/2020-12/schema" }
Connections
streamable-http
https://magic-envelope.com/api/mcp