# Magic Envelope

> Free invitations and letters that arrive in a sealed envelope. Pick a style, write it with typed blocks (date, place with map, RSVP, schedule, dress code, gifts, music, QR…), and send it: each guest gets their own link with their name on the envelope and in the text. No account.

Agents can do everything through the API, without a browser.

## Use it as an agent

- [MCP server](https://magic-envelope.com/api/mcp): tools get_catalog, create_letter, get_letter, update_letter (Streamable HTTP)
- [REST API](https://magic-envelope.com/api/v1): POST /api/v1/letters to create and publish; GET/PATCH /api/v1/letters/{id} with "Authorization: Bearer <editKey>"
- [OpenAPI](https://magic-envelope.com/api/v1/openapi.json): full schema
- [Catalog](https://magic-envelope.com/api/v1/catalog): styles, presets, block types with examples, envelope slots, stamps, seals
- [Developer docs](https://magic-envelope.com/developers)

Minimal request:

```json
POST https://magic-envelope.com/api/v1/letters
{ "lang": "es", "style": "romance", "preset": "wedding",
  "blocks": [
    { "type": "heading", "text": "{name}, ¡nos casamos!" },
    { "type": "date", "start": "2026-11-14T18:00" },
    { "type": "place", "name": "Finca La Alameda", "address": "Calle Mayor 1, Madrid" },
    { "type": "rsvp", "channel": "whatsapp", "contacts": { "whatsapp": "+34600123123", "sms": "", "email": "" } }
  ],
  "guests": [{ "name": "Lucía" }, { "name": "Tom" }] }
```

The response has `url`, one `guests[].url` per guest (send each guest their own), `previewImage` and a secret `editKey`.

## Styles

- parchment: Parchment (Classic)
- midnight: Midnight (Classic)
- romance: Romance (Classic)
- botanical: Botanical (Classic)
- notebook: Notebook (Modern)
- minimal: Minimal (Modern)
- launch: Launch (Modern)
- groovy: Groovy 80s (Retro)
- deco: Gatsby (Elegant)
- ivory: Ivory (Elegant)
- brutal: Brutal (Modern)
- bubblegum: Bubblegum (Playful)
- confetti: Confetti (Playful)
- typewriter: Typewriter (Retro)
- pocket: Pocket 8-bit (Retro)

## Occasions (presets)

- birthday: Birthday — [make one](https://magic-envelope.com/for/birthday)
- wedding: Wedding — [make one](https://magic-envelope.com/for/wedding)
- party: Party — [make one](https://magic-envelope.com/for/party)
- baby: Baby shower — [make one](https://magic-envelope.com/for/baby)
- dinner: Dinner — [make one](https://magic-envelope.com/for/dinner)
- graduation: Graduation — [make one](https://magic-envelope.com/for/graduation)
- event: Event — [make one](https://magic-envelope.com/for/event)
- letter: Letter — [make one](https://magic-envelope.com/for/letter)

## Rules

- Write {name} in heading, text, signature or envelope text: each guest's link shows their name.
- Blocks may be partial: missing fields take the editor's defaults. Dates are local ISO, e.g. 2026-11-14T18:00.
- Envelope slots have fixed block types and limits: front-center (Recipient: heading, ≤36 chars); front-tl (Sender: text, ≤90 chars); front-tr (Postage: stamp); front-bl (Note: text, ≤60 chars); back-center (Under the seal: text, ≤40 chars).
- Languages: es, en, fr, pt, it, de.

## Support

- [Buy me a coffee](https://buymeacoffee.com/jaimehuman)
- Made by [Jaime Alonso](https://jaimealonso.dev)