Koskamo

Zovo Secret Santa MCP

Zovo Secret Santa draws names for holiday gift exchanges, office parties and family swaps. It respects couples and other exclusions, and it says why when no draw is possible. Each person gets a private link that shows only whom they buy for, the budget, the date and that person's wishlist. People add their own wishlist on their page. The organizer sees which links were opened, not who buys for whom.

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

Zovo Secret Santa MCP logo, by ZovoCommunity listingStreamable HTTPNo sign-inEndpoint checked 2026-11-08Published by Zovo
MCP endpoint (Streamable HTTP)
https://secret-santa.zovo.one/mcp
Vendor documentation

What its tools do

3 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.

3 of 3 have a description · 3 of 3 declare behavior hints · 3 of 3 with parameters document them all

Checks and signals

Each line is separate evidence, not a trust score.

  • Passed Endpoint answered the live check ·
  • Availability 1 of 1 checks passed in 30 days

What you can do with it

  • Draw names for Secret Santa and give everyone a private page with their match and wishlists
  • Respect couples and other exclusions, and it says why when no draw is possible
  • Each person adds or edits their own wishlist on their private page
  • Organizer page with every link and when each link was first opened, without the assignments

Source and maintenance

Community listingRegistry 1.0.0

Protocol and capabilities

Server
secret-santa 1.0.0
MCP protocol negotiated in check
2025-11-25
Tools
3 advertised
Resources
1 advertised
Resource templates
1 advertised
Prompts
Not advertised
Server-advertised capabilities
{
  "tools": {
    "listChanged": true
  },
  "resources": {
    "listChanged": true
  }
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

Zovo Secret Santa draws names for a gift exchange and hosts one private page per person. create_secret_santa returns one private link per participant and an organizer link. Give each person only their own link. The draw itself is not in the result, so do not guess or state who buys for whom. show_secret_santa_status reports which links were opened. redraw_secret_santa works only before anyone opened a link.

Tools

3 advertised

create_secret_santa — Create Secret Santa
Advertised by the server during the last successful anonymous check.
Open-world

Use this when the user wants to draw names for a Secret Santa or holiday gift exchange and give each person a private link. Takes 3 to 60 names, optional couples or households who must not draw each other, one-way exclusions (for example last year's match), a budget, an exchange date and a note. Publishes a hosted page: each private link shows one person whom they buy for, the budget, the date and the match's wishlist, and each person can add their own wishlist. Returns one private link per person and an organizer link; the draw itself is not returned. Explains why when no draw is possible. Does not send emails or texts. Do not use for White Elephant games or for picking one winner.

create_secret_santa input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "participants"
  ],
  "properties": {
    "note": {
      "type": "string",
      "maxLength": 1600,
      "description": "Short note from the organizer shown on every private page, e.g. Wrap it and bring it to the party. No links."
    },
    "budget": {
      "type": "string",
      "maxLength": 240,
      "description": "Spending limit as text, e.g. $25 or 20-30 EUR."
    },
    "couples": {
      "type": "array",
      "items": {
        "type": "array",
        "items": {
          "type": "string",
          "maxLength": 400
        },
        "maxItems": 60
      },
      "maxItems": 30,
      "description": "Groups whose members must not draw each other (couples, households), e.g. [[\"Ana\",\"Bo\"]]."
    },
    "time_zone": {
      "type": "string",
      "maxLength": 64,
      "description": "IANA time zone for showing when links were opened, e.g. America/Chicago. Default America/New_York."
    },
    "event_name": {
      "type": "string",
      "maxLength": 400,
      "description": "Name shown on every page, e.g. Office Secret Santa 2026."
    },
    "exclusions": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "giver",
          "cannot_draw"
        ],
        "properties": {
          "giver": {
            "type": "string",
            "maxLength": 400,
            "description": "Person who must not draw someone, e.g. Cy."
          },
          "cannot_draw": {
            "type": "string",
            "maxLength": 400,
            "description": "Person they must not draw, e.g. Dee (for example last year's match)."
          }
        }
      },
      "maxItems": 120,
      "description": "One-way rules, e.g. [{\"giver\":\"Cy\",\"cannot_draw\":\"Dee\"}] for last year's match."
    },
    "participants": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 400
      },
      "maxItems": 200,
      "description": "Everyone taking part, 3 to 60 first names or nicknames, each unique, e.g. [\"Ana\",\"Bo\",\"Cy\",\"Dee\"]."
    },
    "exchange_date": {
      "type": "string",
      "maxLength": 40,
      "description": "Day of the gift exchange as YYYY-MM-DD, e.g. 2026-12-18."
    },
    "no_two_person_loops": {
      "type": "boolean",
      "description": "true = no two people draw each other (A gives to B and B gives to A). Default false."
    }
  }
}
create_secret_santa output schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "event",
    "participant_count",
    "opened_count",
    "wishlist_count",
    "budget",
    "exchange_date",
    "closed",
    "can_redraw",
    "expires_on",
    "people",
    "publicUrl",
    "manageUrl",
    "rules",
    "warnings"
  ],
  "properties": {
    "event": {
      "type": "string"
    },
    "rules": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "budget": {
      "type": [
        "string",
        "null"
      ]
    },
    "closed": {
      "type": "boolean"
    },
    "people": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "name",
          "private_link",
          "opened",
          "first_opened",
          "wishlist_added"
        ],
        "properties": {
          "name": {
            "type": "string"
          },
          "opened": {
            "type": "boolean"
          },
          "first_opened": {
            "type": [
              "string",
              "null"
            ]
          },
          "private_link": {
            "type": "string"
          },
          "wishlist_added": {
            "type": "boolean"
          }
        },
        "additionalProperties": false
      }
    },
    "warnings": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "manageUrl": {
      "type": "string"
    },
    "publicUrl": {
      "type": "string"
    },
    "can_redraw": {
      "type": "boolean"
    },
    "expires_on": {
      "type": "string"
    },
    "opened_count": {
      "type": "number"
    },
    "exchange_date": {
      "type": [
        "string",
        "null"
      ]
    },
    "wishlist_count": {
      "type": "number"
    },
    "participant_count": {
      "type": "number"
    },
    "people_count_shown": {
      "type": "object",
      "required": [
        "shown",
        "total"
      ],
      "properties": {
        "shown": {
          "type": "number"
        },
        "total": {
          "type": "number"
        }
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}
create_secret_santa annotations
{
  "title": "Create Secret Santa",
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}
show_secret_santa_status — Show Secret Santa status
Advertised by the server during the last successful anonymous check.
Advertised read-only

Use this when the organizer asks who has opened their Secret Santa link, who added a wishlist, or wants the private links again. Takes the organizer link (it contains /m/). Returns each person's link, whether and when it was first opened, and whether they added a wishlist. Does not return who buys for whom. Does not change anything. Does not work with a person's private link.

show_secret_santa_status input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "manage_link"
  ],
  "properties": {
    "manage_link": {
      "type": "string",
      "maxLength": 400,
      "description": "The private organizer link from when the draw was made, e.g. https://secret-santa.zovo.one/m/AbC.../XyZ... (it contains /m/)."
    }
  }
}
show_secret_santa_status output schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "event",
    "participant_count",
    "opened_count",
    "wishlist_count",
    "budget",
    "exchange_date",
    "closed",
    "can_redraw",
    "expires_on",
    "people",
    "publicUrl",
    "manageUrl",
    "rules",
    "warnings"
  ],
  "properties": {
    "event": {
      "type": "string"
    },
    "rules": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "budget": {
      "type": [
        "string",
        "null"
      ]
    },
    "closed": {
      "type": "boolean"
    },
    "people": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "name",
          "private_link",
          "opened",
          "first_opened",
          "wishlist_added"
        ],
        "properties": {
          "name": {
            "type": "string"
          },
          "opened": {
            "type": "boolean"
          },
          "first_opened": {
            "type": [
              "string",
              "null"
            ]
          },
          "private_link": {
            "type": "string"
          },
          "wishlist_added": {
            "type": "boolean"
          }
        },
        "additionalProperties": false
      }
    },
    "warnings": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "manageUrl": {
      "type": "string"
    },
    "publicUrl": {
      "type": "string"
    },
    "can_redraw": {
      "type": "boolean"
    },
    "expires_on": {
      "type": "string"
    },
    "opened_count": {
      "type": "number"
    },
    "exchange_date": {
      "type": [
        "string",
        "null"
      ]
    },
    "wishlist_count": {
      "type": "number"
    },
    "participant_count": {
      "type": "number"
    },
    "people_count_shown": {
      "type": "object",
      "required": [
        "shown",
        "total"
      ],
      "properties": {
        "shown": {
          "type": "number"
        },
        "total": {
          "type": "number"
        }
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}
show_secret_santa_status annotations
{
  "title": "Show Secret Santa status",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
redraw_secret_santa — Redraw Secret Santa
Advertised by the server during the last successful anonymous check.
Advertised destructiveOpen-world

Use this when the organizer wants a new random draw for an existing Secret Santa, for example because they saw an assignment by mistake. Takes the organizer link. Works only while nobody has opened a private link; it replaces the old draw with the same rules, keeps the same private links and keeps wishlists. Does not add or remove people (make a new Secret Santa for that).

redraw_secret_santa input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "manage_link"
  ],
  "properties": {
    "manage_link": {
      "type": "string",
      "maxLength": 400,
      "description": "The private organizer link from when the draw was made, e.g. https://secret-santa.zovo.one/m/AbC.../XyZ... (it contains /m/)."
    }
  }
}
redraw_secret_santa output schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "event",
    "participant_count",
    "opened_count",
    "wishlist_count",
    "budget",
    "exchange_date",
    "closed",
    "can_redraw",
    "expires_on",
    "people",
    "publicUrl",
    "manageUrl",
    "rules",
    "warnings"
  ],
  "properties": {
    "event": {
      "type": "string"
    },
    "rules": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "budget": {
      "type": [
        "string",
        "null"
      ]
    },
    "closed": {
      "type": "boolean"
    },
    "people": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "name",
          "private_link",
          "opened",
          "first_opened",
          "wishlist_added"
        ],
        "properties": {
          "name": {
            "type": "string"
          },
          "opened": {
            "type": "boolean"
          },
          "first_opened": {
            "type": [
              "string",
              "null"
            ]
          },
          "private_link": {
            "type": "string"
          },
          "wishlist_added": {
            "type": "boolean"
          }
        },
        "additionalProperties": false
      }
    },
    "warnings": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "manageUrl": {
      "type": "string"
    },
    "publicUrl": {
      "type": "string"
    },
    "can_redraw": {
      "type": "boolean"
    },
    "expires_on": {
      "type": "string"
    },
    "opened_count": {
      "type": "number"
    },
    "exchange_date": {
      "type": [
        "string",
        "null"
      ]
    },
    "wishlist_count": {
      "type": "number"
    },
    "participant_count": {
      "type": "number"
    },
    "people_count_shown": {
      "type": "object",
      "required": [
        "shown",
        "total"
      ],
      "properties": {
        "shown": {
          "type": "number"
        },
        "total": {
          "type": "number"
        }
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}
redraw_secret_santa annotations
{
  "title": "Redraw Secret Santa",
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": true
}

Prompts

Not advertised

No prompt definitions available.

Resources

1 advertised

secret-santa-widget — Zovo Secret Santa view

Advertised by the server during the last successful anonymous check.

Interactive view for Zovo Secret Santa.

secret-santa-widget URI
ui://widget/secret-santa-v1-1.0.0-074c87227327f5868a98aeac62a88389240da7dba22052a58540be3f4d8c66a0.html

MIME type: text/html;profile=mcp-app

secret-santa-widget-legacy — Zovo Secret Santa view (previous versions)

Advertised by the server during the last successful anonymous check.

secret-santa-widget-legacy URI template
ui://widget/secret-santa-{version}.html

MIME type: text/html;profile=mcp-app

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks
1 of 1 (100%)
Average latency
589 ms
95th percentile latency
589 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 589 ms · metadata changed · 3 tool(s), 1 resource(s), 1 resource template(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http zovo-secret-santa-mcp https://secret-santa.zovo.one/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add zovo-secret-santa-mcp --url https://secret-santa.zovo.one/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable zovo-secret-santa-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "zovo-secret-santa-mcp": {
      "url": "https://secret-santa.zovo.one/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "zovo-secret-santa-mcp": {
      "type": "streamableHttp",
      "url": "https://secret-santa.zovo.one/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start zovo-secret-santa-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "zovo-secret-santa-mcp": {
      "type": "http",
      "url": "https://secret-santa.zovo.one/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http zovo-secret-santa-mcp https://secret-santa.zovo.one/mcp

Claude Desktop

Open Claude Settings > Connectors > Add custom connector, enter this server URL and enable it for the conversation. This is a manual remote-connector handoff, not a desktop JSON configuration.
Claude Desktop configuration
https://secret-santa.zovo.one/mcp

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "zovo-secret-santa-mcp": {
      "serverUrl": "https://secret-santa.zovo.one/mcp"
    }
  }
}

Let your agent find its tools

Find servers like Zovo Secret Santa MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.