Plan Secret Santa draw
plan_gift_exchangeUse this when the user wants to draw names for a Secret Santa or gift exchange (secret santa generator, name draw, no email needed), including exclusions such as couples, households, "Ana can't draw Bo", or last year's pairs, an optional no 2-person loops rule, a budget, an exchange date, wish lists, and an organizer note. Returns one private reveal link per participant plus copy-ready messages; each pairing is encrypted inside the link, so the result never shows who drew whom. Explains exactly why when no valid draw exists. Handles 3 to 60 people. Does not send emails or texts and does not store anything. Do not use for White Elephant or Yankee Swap games (use plan_white_elephant) or for picking one random winner.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"participants": "<participants>"
},
"name": "plan_gift_exchange"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| budget | No | Gift budget as the group says it, e.g. $30, 25 EUR, or £20-£25. | |
| language | No | Language of the reveal pages and share messages: en, es, fr, de, pl, pt, or ja (e.g. pl). Default en. | |
| event_name | No | Name of the exchange shown on every link, e.g. Office Holiday Party 2026. | |
| exclusions | No | One-way rules such as "Ana can't draw Cy" or last year's pairs, e.g. [{"giver":"Ana","cannot_draw":"Cy"}]. Cy may still draw Ana unless a second rule says otherwise. | |
| households | No | Couples or households whose members must not draw each other (both directions), e.g. [["Ana","Bo"],["Cy","Dee","Eli"]]. | |
| wish_lists | No | Optional wish lists. Each one is shown only to the person who draws that participant. | |
| participants | Yes | Everyone taking part (3 to 60 people), e.g. ["Ana","Bo","Cy","Dee","Eli","Fay"]. Names must be unique; add a last initial to tell two people with the same name apart. Any language or script works. | |
| exchange_date | No | Gift exchange date as YYYY-MM-DD, e.g. 2026-12-18. | |
| organizer_note | No | Optional note shown on every reveal page, e.g. Wrap gifts and bring them to the kitchen by 3 pm. | |
| no_two_person_loops | No | true = never let two people draw each other (no A gives to B while B gives to A). Default false. | |
| include_organizer_list | No | true only when the organizer explicitly asks to see every pairing; adds a link to the full list, which spoils the surprise for them. Default false. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | Yes | ||
| rules | Yes | ||
| budget | Yes | ||
| language | Yes | ||
| sampling | Yes | ||
| warnings | Yes | ||
| downloads | Yes | ||
| draw_code | Yes | ||
| event_name | Yes | ||
| exclusions | Yes | ||
| households | Yes | ||
| participants | Yes | ||
| exchange_date | Yes | ||
| message_template | Yes | ||
| valid_arrangements | Yes | ||
| exchange_date_label | Yes |