Free Secret Santa draws with private links. The assistant never sees who gives to whom.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Add one person before anyone has opened their link (pressed reveal). If the draw was already made and nobody has opened it, it is redrawn with the same private links for the people who were already in it. Refuses once anyone has opened their link. Does not reveal assignments. Optional couple is the name of a person they must not draw.
Organizer secret returned by create_draw: the token, or the full /m/ URL. It cannot reveal who gives to whom.
Name of someone already in the draw who lives with this person.
Region code from list_regions (US, ES, CT for Catalonia, DE, MX, …). Sets the local name of the game, the default language and the currency.
Language of the reply and the share messages: en, es, ca, de, pt, fr, it, nl, pl, da, no, sv, ru, ko, ja. Defaults from region.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http secret-santa https://secretsanta.name/mcp
Add one person before anyone has opened their link (pressed reveal). If the draw was already made and nobody has opened it, it is redrawn with the same private links for the people who were already in it. Refuses once anyone has opened their link. Does not reveal assignments. Optional couple is the name of a person they must not draw.
| Argument | Type | Description |
|---|---|---|
| name* | string | |
| string | ||
| couple | string | Name of someone already in the draw who lives with this person. |
| region | string | Region code from list_regions (US, ES, CT for Catalonia, DE, MX, …). Sets the local name of the game, the default language and the currency. |
| language | string | Language of the reply and the share messages: en, es, ca, de, pt, fr, it, nl, pl, da, no, sv, ru, ko, ja. Defaults from region. |
| admin_token* | string | Organizer secret returned by create_draw: the token, or the full /m/ URL. It cannot reveal who gives to whom. |
{
"type": "object",
"required": [
"admin_token",
"name"
],
"properties": {
"name": {
"type": "string"
},
"email": {
"type": "string"
},
"couple": {
"type": "string",
"description": "Name of someone already in the draw who lives with this person."
},
"region": {
"type": "string",
"description": "Region code from list_regions (US, ES, CT for Catalonia, DE, MX, …). Sets the local name of the game, the default language and the currency."
},
"language": {
"type": "string",
"description": "Language of the reply and the share messages: en, es, ca, de, pt, fr, it, nl, pl, da, no, sv, ru, ko, ja. Defaults from region."
},
"admin_token": {
"type": "string",
"description": "Organizer secret returned by create_draw: the token, or the full /m/ URL. It cannot reveal who gives to whom."
}
},
"additionalProperties": false
}Append items to one participant's own wish list (name, optional http(s) URL, optional note), up to 10. Uses their private token. replace=true overwrites the list. Does not reveal who they give a gift to. Only their Secret Santa sees the list, on the website, after revealing.
| Argument | Type | Description |
|---|---|---|
| items* | array | |
| replace | boolean | When true, replace the whole list instead of appending. |
| language | string | Language of the reply and the share messages: en, es, ca, de, pt, fr, it, nl, pl, da, no, sv, ru, ko, ja. Defaults from region. |
| participant_token* | string |
{
"type": "object",
"required": [
"participant_token",
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"name"
],
"properties": {
"url": {
"type": "string"
},
"name": {
"type": "string"
},
"note": {
"type": "string"
}
}
}
},
"replace": {
"type": "boolean",
"description": "When true, replace the whole list instead of appending."
},
"language": {
"type": "string",
"description": "Language of the reply and the share messages: en, es, ca, de, pt, fr, it, nl, pl, da, no, sv, ru, ko, ja. Defaults from region."
},
"participant_token": {
"type": "string"
}
},
"additionalProperties": false
}Create a draw and run it. Returns the organizer link plus one private link per person who has no email. NEVER returns who gives to whom. People with an email get their link only by email: call send_invites. Couples and households are groups of names who must not draw each other. Exclusions are one-way unless both is true. If the rules are impossible, nobody is assigned and the result explains why. Do not open the private links.
| Argument | Type | Description |
|---|---|---|
| name* | string | Group name, shown on every private page. |
| budget | any | Number or text. Combined with currency. |
| region | string | Region code from list_regions (US, ES, CT for Catalonia, DE, MX, …). Sets the local name of the game, the default language and the currency. |
| couples | array | Couples or households. Each inner list is two or more names who must not give to each other. |
| message | string | Optional note shown on the private pages. Do not put assignments here. |
| currency | string | ISO currency code. Defaults from the region. |
| language | string | Language of the reply and the share messages: en, es, ca, de, pt, fr, it, nl, pl, da, no, sv, ru, ko, ja. Defaults from region. |
| exclusions |
Organizer status for one draw: who has opened their private link (pressed the button; a chat preview does not count), who has filled a wish list, and email status. Does not return wish-list text, shipping addresses, or who gives to whom.
| Argument | Type | Description |
|---|---|---|
| region | string | Region code from list_regions (US, ES, CT for Catalonia, DE, MX, …). Sets the local name of the game, the default language and the currency. |
| language | string | Language of the reply and the share messages: en, es, ca, de, pt, fr, it, nl, pl, da, no, sv, ru, ko, ja. Defaults from region. |
| admin_token* | string | Organizer secret returned by create_draw: the token, or the full /m/ URL. It cannot reveal who gives to whom. |
{
"type": "object",
"required": [
"admin_token"
],
"properties": {
"region": {
"type": "string",
"description": "Region code from list_regions (US, ES, CT for Catalonia, DE, MX, …). Sets the local name of the game, the default language and the currency."
},
"language": {
"type": "string",
"description": "Language of the reply and the share messages: en, es, ca, de, pt, fr, it, nl, pl, da, no, sv, ru, ko, ja. Defaults from region."
},
"admin_token": {
"type": "string",
"description": "Organizer secret returned by create_draw: the token, or the full /m/ URL. It cannot reveal who gives to whom."
}
},
"additionalProperties": false
}Text the organizer can paste in WhatsApp, Telegram, or Slack. The group text has no private links and names nobody's assignment. Also returns one private message per person, which must be sent only to that person. Localized to language/region. Refuses if the draw has not been made.
| Argument | Type | Description |
|---|---|---|
| region | string | Region code from list_regions (US, ES, CT for Catalonia, DE, MX, …). Sets the local name of the game, the default language and the currency. |
| language | string | Language of the reply and the share messages: en, es, ca, de, pt, fr, it, nl, pl, da, no, sv, ru, ko, ja. Defaults from region. |
| admin_token* | string | Organizer secret returned by create_draw: the token, or the full /m/ URL. It cannot reveal who gives to whom. |
{
"type": "object",
"required": [
"admin_token"
],
"properties": {
"region": {
"type": "string",
"description": "Region code from list_regions (US, ES, CT for Catalonia, DE, MX, …). Sets the local name of the game, the default language and the currency."
},
"language": {
"type": "string",
"description": "Language of the reply and the share messages: en, es, ca, de, pt, fr, it, nl, pl, da, no, sv, ru, ko, ja. Defaults from region."
},
"admin_token": {
"type": "string",
"description": "Organizer secret returned by create_draw: the token, or the full /m/ URL. It cannot reveal who gives to whom."
}
},
"additionalProperties": false
}Read one participant's own wish list, using their private token (the /s/ link). Does not return who they give a gift to, their Secret Santa's wishes, or anyone else's list. The organizer token cannot read wish lists.
| Argument | Type | Description |
|---|---|---|
| language | string | Language of the reply and the share messages: en, es, ca, de, pt, fr, it, nl, pl, da, no, sv, ru, ko, ja. Defaults from region. |
| participant_token* | string | That person's private token or /s/ URL. |
{
"type": "object",
"required": [
"participant_token"
],
"properties": {
"language": {
"type": "string",
"description": "Language of the reply and the share messages: en, es, ca, de, pt, fr, it, nl, pl, da, no, sv, ru, ko, ja. Defaults from region."
},
"participant_token": {
"type": "string",
"description": "That person's private token or /s/ URL."
}
},
"additionalProperties": false
}Suggest a few gift ideas for a budget, optional interests, and language, plus the site's own shops when one fits. Ideas are suggestions, not a catalog. Read-only. No draw and no personal data.
| Argument | Type | Description |
|---|---|---|
| budget | any | Number or text. |
| region | string | Region code from list_regions (US, ES, CT for Catalonia, DE, MX, …). Sets the local name of the game, the default language and the currency. |
| currency | string | |
| language | string | Language of the reply and the share messages: en, es, ca, de, pt, fr, it, nl, pl, da, no, sv, ru, ko, ja. Defaults from region. |
| interests | array |
{
"type": "object",
"required": [],
"properties": {
"budget": {
"oneOf": [
{
"type": "number"
},
{
"type": "string"
}
],
"description": "Number or text."
},
"region": {
"type": "string",
"description": "Region code from list_regions (US, ES, CT for Catalonia, DE, MX, …). Sets the local name of the game, the default language and the currency."
},
"currency": {
"type": "string"
},
"language": {
"type": "string",
"description": "Language of the reply and the share messages: en, es, ca, de, pt, fr, it, nl, pl, da, no, sv, ru, ko, ja. Defaults from region."
},
"interests": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
}List the regions secretsanta.name knows: code, local name of the game, language, and currency. Use a code as region on the other tools. CT is Catalonia. Read-only. Reveals no assignments.
| Argument | Type | Description |
|---|---|---|
| language | string | Language of the reply and the share messages: en, es, ca, de, pt, fr, it, nl, pl, da, no, sv, ru, ko, ja. Defaults from region. |
{
"type": "object",
"required": [],
"properties": {
"language": {
"type": "string",
"description": "Language of the reply and the share messages: en, es, ca, de, pt, fr, it, nl, pl, da, no, sv, ru, ko, ja. Defaults from region."
}
},
"additionalProperties": false
}Make a new draw with the same people and the same private links, before anyone has opened their link. If the rules are impossible, the previous draw is kept and the reason is returned. allow_reciprocal can be changed in the same call. Refuses once anyone has opened their link. Does not reveal who gives to whom.
| Argument | Type | Description |
|---|---|---|
| region | string | Region code from list_regions (US, ES, CT for Catalonia, DE, MX, …). Sets the local name of the game, the default language and the currency. |
| language | string | Language of the reply and the share messages: en, es, ca, de, pt, fr, it, nl, pl, da, no, sv, ru, ko, ja. Defaults from region. |
| admin_token* | string | Organizer secret returned by create_draw: the token, or the full /m/ URL. It cannot reveal who gives to whom. |
| allow_reciprocal | boolean |
{
"type": "object",
"required": [
"admin_token"
],
"properties": {
"region": {
"type": "string",
"description": "Region code from list_regions (US, ES, CT for Catalonia, DE, MX, …). Sets the local name of the game, the default language and the currency."
},
"language": {
"type": "string",
"description": "Language of the reply and the share messages: en, es, ca, de, pt, fr, it, nl, pl, da, no, sv, ru, ko, ja. Defaults from region."
},
"admin_token": {
"type": "string",
"description": "Organizer secret returned by create_draw: the token, or the full /m/ URL. It cannot reveal who gives to whom."
},
"allow_reciprocal": {
"type": "boolean"
}
},
"additionalProperties": false
}Remove one person before anyone has opened their link. If the draw was already made, it is redrawn, or left unchanged when the smaller group is impossible. Refuses once anyone has opened their link. Does not reveal assignments.
| Argument | Type | Description |
|---|---|---|
| name* | string | |
| region | string | Region code from list_regions (US, ES, CT for Catalonia, DE, MX, …). Sets the local name of the game, the default language and the currency. |
| language | string | Language of the reply and the share messages: en, es, ca, de, pt, fr, it, nl, pl, da, no, sv, ru, ko, ja. Defaults from region. |
| admin_token* | string | Organizer secret returned by create_draw: the token, or the full /m/ URL. It cannot reveal who gives to whom. |
{
"type": "object",
"required": [
"admin_token",
"name"
],
"properties": {
"name": {
"type": "string"
},
"region": {
"type": "string",
"description": "Region code from list_regions (US, ES, CT for Catalonia, DE, MX, …). Sets the local name of the game, the default language and the currency."
},
"language": {
"type": "string",
"description": "Language of the reply and the share messages: en, es, ca, de, pt, fr, it, nl, pl, da, no, sv, ru, ko, ja. Defaults from region."
},
"admin_token": {
"type": "string",
"description": "Organizer secret returned by create_draw: the token, or the full /m/ URL. It cannot reveal who gives to whom."
}
},
"additionalProperties": false
}Send one person's invitation email again. Rate-limited like the website's email button. If that person has no email, returns only their private share message and not anyone else's. Does not reveal who they give a gift to.
| Argument | Type | Description |
|---|---|---|
| name* | string | Participant name, as stored on the draw. |
| region | string | Region code from list_regions (US, ES, CT for Catalonia, DE, MX, …). Sets the local name of the game, the default language and the currency. |
| language | string | Language of the reply and the share messages: en, es, ca, de, pt, fr, it, nl, pl, da, no, sv, ru, ko, ja. Defaults from region. |
| admin_token* | string | Organizer secret returned by create_draw: the token, or the full /m/ URL. It cannot reveal who gives to whom. |
{
"type": "object",
"required": [
"admin_token",
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Participant name, as stored on the draw."
},
"region": {
"type": "string",
"description": "Region code from list_regions (US, ES, CT for Catalonia, DE, MX, …). Sets the local name of the game, the default language and the currency."
},
"language": {
"type": "string",
"description": "Language of the reply and the share messages: en, es, ca, de, pt, fr, it, nl, pl, da, no, sv, ru, ko, ja. Defaults from region."
},
"admin_token": {
"type": "string",
"description": "Organizer secret returned by create_draw: the token, or the full /m/ URL. It cannot reveal who gives to whom."
}
},
"additionalProperties": false
}Email each person who has an address their own private link, using the site's normal mail flow and the same daily cap (EMAIL_DAILY_CAP) and per-network limit as the website. Does not return the links or who gives to whom. Fails clearly when email is off or the draw is not done.
| Argument | Type | Description |
|---|---|---|
| region | string | Region code from list_regions (US, ES, CT for Catalonia, DE, MX, …). Sets the local name of the game, the default language and the currency. |
| language | string | Language of the reply and the share messages: en, es, ca, de, pt, fr, it, nl, pl, da, no, sv, ru, ko, ja. Defaults from region. |
| admin_token* | string | Organizer secret returned by create_draw: the token, or the full /m/ URL. It cannot reveal who gives to whom. |
{
"type": "object",
"required": [
"admin_token"
],
"properties": {
"region": {
"type": "string",
"description": "Region code from list_regions (US, ES, CT for Catalonia, DE, MX, …). Sets the local name of the game, the default language and the currency."
},
"language": {
"type": "string",
"description": "Language of the reply and the share messages: en, es, ca, de, pt, fr, it, nl, pl, da, no, sv, ru, ko, ja. Defaults from region."
},
"admin_token": {
"type": "string",
"description": "Organizer secret returned by create_draw: the token, or the full /m/ URL. It cannot reveal who gives to whom."
}
},
"additionalProperties": false
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 22, 2026.
| array |
| Extra rules. from does not give to to. both means neither gives to the other. |
| participants* | array | People in the draw. At least 3, or 2 if allow_reciprocal is true. |
| exchange_date | string | Shown to participants. It does not reveal the list. YYYY-MM-DD or free text. |
| allow_reciprocal | boolean | When false (default), two people cannot draw each other. A draw of 2 people needs this set to true. |
{
"type": "object",
"required": [
"name",
"participants"
],
"properties": {
"name": {
"type": "string",
"description": "Group name, shown on every private page."
},
"budget": {
"oneOf": [
{
"type": "number"
},
{
"type": "string"
}
],
"description": "Number or text. Combined with currency."
},
"region": {
"type": "string",
"description": "Region code from list_regions (US, ES, CT for Catalonia, DE, MX, …). Sets the local name of the game, the default language and the currency."
},
"couples": {
"type": "array",
"items": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 2
},
"description": "Couples or households. Each inner list is two or more names who must not give to each other."
},
"message": {
"type": "string",
"description": "Optional note shown on the private pages. Do not put assignments here."
},
"currency": {
"type": "string",
"description": "ISO currency code. Defaults from the region."
},
"language": {
"type": "string",
"description": "Language of the reply and the share messages: en, es, ca, de, pt, fr, it, nl, pl, da, no, sv, ru, ko, ja. Defaults from region."
},
"exclusions": {
"type": "array",
"items": {
"type": "object",
"required": [
"from",
"to"
],
"properties": {
"to": {
"type": "string"
},
"both": {
"type": "boolean"
},
"from": {
"type": "string"
}
}
},
"description": "Extra rules. from does not give to to. both means neither gives to the other."
},
"participants": {
"type": "array",
"items": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Name as it should appear on their private page."
},
"email": {
"type": "string",
"description": "Optional. Used only to email that person's own private link. Never shared, and omitted from the result when email delivery is on."
}
},
"description": "One person. A plain string is also accepted as the name."
},
"maxItems": 300,
"minItems": 2,
"description": "People in the draw. At least 3, or 2 if allow_reciprocal is true."
},
"exchange_date": {
"type": "string",
"description": "Shown to participants. It does not reveal the list. YYYY-MM-DD or free text."
},
"allow_reciprocal": {
"type": "boolean",
"description": "When false (default), two people cannot draw each other. A draw of 2 people needs this set to true."
}
},
"additionalProperties": false
}