Free invitation API

Any agent can create and send a Magic Envelope invitation without an account or a key: compose it from typed blocks, pick a style, add guests and publish. Every guest gets their own addressed link. TheeditKey returned on creation is the only credential, and only for editing.

MCP server (Streamable HTTP)
https://magic-envelope.com/api/mcp

Just ask your agent

Once Magic Envelope is connected (below), plain language is enough. The agent reads the catalog, builds the letter and hands back one link per guest.

Using Magic Envelope, make a Spanish invitation for Ana's 8th birthday:
Saturday 14 November at 17:00, Parque del Retiro (Madrid), RSVP by WhatsApp to +34 600 123 123.
Playful style. Give me one link for each guest: Lucía, Tom, Marco.

Claude

Claude Code: one command. Claude apps (web, desktop, mobile): Settings → Connectors → Add custom connector, and paste the URL.

Terminal
claude mcp add --transport http magic-envelope https://magic-envelope.com/api/mcp
Custom connector URL
https://magic-envelope.com/api/mcp

ChatGPT

Add it as an app with developer mode on (Settings → Apps), using the MCP URL and no authentication. For a custom GPT, add an Action and import the OpenAPI schema from its URL.

MCP server URL
https://magic-envelope.com/api/mcp
GPT Action → Import from URL
https://magic-envelope.com/api/v1/openapi.json

Cursor, VS Code, Windsurf

Add the server to the editor's MCP config file.

~/.cursor/mcp.json
{
  "mcpServers": {
    "magic-envelope": {
      "url": "https://magic-envelope.com/api/mcp"
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "magic-envelope": {
      "type": "http",
      "url": "https://magic-envelope.com/api/mcp"
    }
  }
}
~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "magic-envelope": {
      "serverUrl": "https://magic-envelope.com/api/mcp"
    }
  }
}

Clients that only speak stdio

Bridge the remote server with mcp-remote.

mcp config
{
  "mcpServers": {
    "magic-envelope": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://magic-envelope.com/api/mcp"
      ]
    }
  }
}

curl

Create and publish a letter. The response has the letter's link, one link and one image per guest, and the editKey (keep it to make changes or delete it).

Create
ME=https://magic-envelope.com
curl -X POST "$ME/api/v1/letters" \
  -H "content-type: application/json" \
  -d '{
  "lang": "en",
  "style": "romance",
  "preset": "wedding",
  "seal": "duo:L|T",
  "blocks": [
    { "type": "heading", "text": "{name}, we're getting married!" },
    { "type": "date", "start": "2026-11-14T18:00" },
    { "type": "place", "name": "The Orangery", "address": "Kew Gardens, London" },
    { "type": "rsvp", "channel": "email", "contacts": { "email": "us@example.com", "whatsapp": "", "sms": "" } },
    { "type": "signature", "text": "Lucía & Tom" }
  ],
  "guests": [{ "name": "Emma" }, { "name": "Noah" }]
}'
Change it later (only what you send changes; same links)
ME=https://magic-envelope.com
curl -X PATCH "$ME/api/v1/letters/$LETTER_ID" \
  -H "authorization: Bearer $EDIT_KEY" \
  -H "content-type: application/json" \
  -d '{ "style": "midnight", "addGuests": [{ "name": "Olivia" }] }'
Who's coming
ME=https://magic-envelope.com
curl "$ME/api/v1/letters/$LETTER_ID" -H "authorization: Bearer $EDIT_KEY" | jq .rsvps
Every guest's letter as an image (ZIP named after the letter)
ME=https://magic-envelope.com
curl -L -O -J "$ME/api/v1/letters/$LETTER_ID/images.zip" \
  -H "authorization: Bearer $EDIT_KEY"
Copy a photo (Drive, Dropbox or any public image) and use it on the letter
ME=https://magic-envelope.com
curl -X POST "$ME/api/v1/media" \
  -H "content-type: application/json" \
  -d '{ "url": "https://drive.google.com/file/d/FILE_ID/view" }'
Delete it
ME=https://magic-envelope.com
curl -X DELETE "$ME/api/v1/letters/$LETTER_ID" -H "authorization: Bearer $EDIT_KEY"

JavaScript / TypeScript

Works in Node 18+, Deno, Bun, browsers and edge functions (CORS is open).

const ME = "https://magic-envelope.com";
const res = await fetch(ME + "/api/v1/letters", {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({
    "lang": "en",
    "style": "romance",
    "preset": "wedding",
    "seal": "duo:L|T",
    "blocks": [
      { "type": "heading", "text": "{name}, we're getting married!" },
      { "type": "date", "start": "2026-11-14T18:00" },
      { "type": "place", "name": "The Orangery", "address": "Kew Gardens, London" },
      { "type": "rsvp", "channel": "email", "contacts": { "email": "us@example.com", "whatsapp": "", "sms": "" } },
      { "type": "signature", "text": "Lucía & Tom" }
    ],
    "guests": [{ "name": "Emma" }, { "name": "Noah" }]
  }),
});
if (!res.ok) throw new Error(JSON.stringify(await res.json()));
const letter = await res.json();
for (const guest of letter.guests) console.log(guest.name, guest.url);

Python

With requests.

import requests

ME = "https://magic-envelope.com"
letter = requests.post(
    ME + "/api/v1/letters",
    json={
        "lang": "en", "style": "parchment", "preset": "birthday",
        "blocks": [
            {"type": "heading", "text": "{name}, come to my party!"},
            {"type": "date", "start": "2026-11-14T17:00"},
            {"type": "place", "name": "Home", "address": "221B Baker Street, London"},
        ],
        "guests": [{"name": "Emma"}, {"name": "Noah"}],
    },
    timeout=30,
).json()

for guest in letter["guests"]:
    print(guest["name"], guest["url"])

Google Sheets

Guest names in column A (row 1 is a header). Extensions → Apps Script, paste, run: each guest's personal link lands in column B.

function sendInvitations() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const rows = sheet.getRange(2, 1, sheet.getLastRow() - 1, 1).getValues();
  const guests = rows.map(([name]) => ({ name: String(name).trim() })).filter((g) => g.name);

  const ME = "https://magic-envelope.com";
  const res = UrlFetchApp.fetch(ME + "/api/v1/letters", {
    method: "post",
    contentType: "application/json",
    payload: JSON.stringify({
      lang: "en", style: "botanical", preset: "dinner",
      blocks: [
        { type: "heading", text: "{name}, dinner at ours?" },
        { type: "date", start: "2026-11-21T20:30" },
      ],
      guests,
    }),
  });
  const letter = JSON.parse(res.getContentText());
  sheet.getRange(2, 2, letter.guests.length, 1).setValues(letter.guests.map((g) => [g.url]));
}

n8n

In an AI Agent workflow, add an MCP Client Tool with the endpoint below (HTTP Streamable, no auth). Without an agent, use an HTTP Request node: POST, body JSON.

MCP Client Tool → Endpoint
https://magic-envelope.com/api/mcp
HTTP Request → URL
https://magic-envelope.com/api/v1/letters
HTTP Request → JSON body
{
  "lang": "en",
  "style": "romance",
  "preset": "wedding",
  "seal": "duo:L|T",
  "blocks": [
    { "type": "heading", "text": "{name}, we're getting married!" },
    { "type": "date", "start": "2026-11-14T18:00" },
    { "type": "place", "name": "The Orangery", "address": "Kew Gardens, London" },
    { "type": "rsvp", "channel": "email", "contacts": { "email": "us@example.com", "whatsapp": "", "sms": "" } },
    { "type": "signature", "text": "Lucía & Tom" }
  ],
  "guests": [{ "name": "Emma" }, { "name": "Noah" }]
}

Zapier / Make

Webhooks by Zapier → Custom Request (or Make's HTTP → Make a request): method POST, header content-type: application/json, raw body below. Map guest names from your trigger into "guests".

URL
https://magic-envelope.com/api/v1/letters
Body
{
  "lang": "en",
  "style": "romance",
  "preset": "wedding",
  "seal": "duo:L|T",
  "blocks": [
    { "type": "heading", "text": "{name}, we're getting married!" },
    { "type": "date", "start": "2026-11-14T18:00" },
    { "type": "place", "name": "The Orangery", "address": "Kew Gardens, London" },
    { "type": "rsvp", "channel": "email", "contacts": { "email": "us@example.com", "whatsapp": "", "sms": "" } },
    { "type": "signature", "text": "Lucía & Tom" }
  ],
  "guests": [{ "name": "Emma" }, { "name": "Noah" }]
}

Reference

Good to know

Write {name} in a title, text, signature or envelope line to address each guest. Blocks may be partial — missing fields take the editor's defaults. A block id is optional; the server assigns one when you leave it out. envelope.blocks is an object of slot to block (front-center, front-tl, front-tr, front-bl, back-center), not an array. A text block has no character limit; set italic: true or fontStyle: "italic" for italics, and custom.frame to none, rule or ornate. Dates are the local time at the venue: 2026-11-14T18:00, or 2026-11-14 for a whole day. Guest names are stored server-side and each guest page only ever receives its own name. Letters are in English, Spanish, French, Portuguese, Italian or German (lang).