Hosted MCP server · #121 most used on Smithery
Surprise Buddy
surprise-buddy/mcp-server
## What is Surprise Buddy? Surprise Buddy is a curated, country-scoped gift database exposed via a public Model Context Protocol (MCP) server. International coverage — every result is a real product page on a real marketplace (Amazon, Etsy, Mercado Libre, Otto, Bol.com, Allegro, Jochen Schweizer) and the link can be presented to the user as-is. **Live MCP endpoint:** `https://www.surprise-buddy.com/api/mcp` ## Exposed tools - **`find_gifts`** — main search (country required, all other filters optional) - `list_supported_countries` - `list_supported_occasions(country?)` - `list_supported_interests` - `list_supported_colors` ## Authentication None — the MCP server is fully open. Reasonable rate limiting may apply. ## License MIT © Surprise Buddy
- Uses
- 4.7k
- Tools
- 5
- Runs
- Hosted
- Listed
- 6mo ago
Get started
Add it to your agent
npx -y @smithery/cli@latest install surprise-buddy/mcp-server --client claudeSwap --client claude for cursor, vscode, windsurf or another client. The CLI asks for any required settings.
claude mcp add --transport http surprise-buddy https://server.smithery.ai/surprise-buddy/mcp-server/mcpA hosted server: nothing to install. Run /mcp in Claude Code to sign in if it asks.
[mcp_servers.surprise-buddy]
url = "https://server.smithery.ai/surprise-buddy/mcp-server/mcp"Add to ~/.codex/config.toml.
{
"mcpServers": {
"surprise-buddy": {
"url": "https://server.smithery.ai/surprise-buddy/mcp-server/mcp"
}
}
}Add to ~/.cursor/mcp.json.
{
"servers": {
"surprise-buddy": {
"type": "http",
"url": "https://server.smithery.ai/surprise-buddy/mcp-server/mcp"
}
}
}Add to .vscode/mcp.json.
gemini mcp add --transport http surprise-buddy https://server.smithery.ai/surprise-buddy/mcp-server/mcpSaved to .gemini/settings.json.
What it can do
5 tools
find_gifts10 paramsSearch the curated Surprise Buddy database for gift ideas matching a recipient. Returns product cards with title, image, price, why-it-fi…
Search the curated Surprise Buddy database for gift ideas matching a recipient. Returns product cards with title, image, price, why-it-fits, and a clickable product URL. Country is required and is a hard filter — results are scoped to the marketplace + currency of that country.
| Parameter | Type | Description |
|---|---|---|
age | integer | Recipient age in years. Filters gifts whose age range covers this value. |
limit | integer | Maximum number of gifts to return (1–20, default 5). |
gender | string | Recipient gender. Gifts tagged "unisex" are always included regardless of this value. |
country | string | ISO-3166 alpha-2 country code (e.g. "DE", "US", "MX"). REQUIRED. |
occasion | string | Occasion code. Common values: birthday | christmas | easter | valentines | mothers-day | fathers-day | wedding | anniversary | graduation. Locale-specific occasions are also supported (e.g. einschulun |
interests | array | Interest/hobby tags used for soft-match scoring (more matches rank higher). Call list_supported_interests for the canonical vocabulary. |
profession | string | Recipient profession used as an exact-match filter, e.g. "teacher", "developer", "chef", "athlete", "photographer", "gamer". |
favorite_color | string | Recipient's favorite color. Only returns gifts that explicitly match this color; color-agnostic gifts are skipped when this filter is set. |
budget_max_cents | integer | Maximum budget in cents of the country currency (e.g. 10000 = 100.00 EUR for DE). |
budget_min_cents | integer | Minimum budget in cents of the country currency (e.g. 5000 = 50.00 EUR for DE). |
list_supported_countriesList ISO-2 country codes that currently have at least one active gift entry in the database. Coverage grows over time.
list_supported_occasions1 paramList occasion codes that have active gift entries, optionally narrowed to a specific country.
| Parameter | Type | Description |
|---|---|---|
country | string | Optional ISO-2 country code to scope the result (e.g. "DE" returns Einschulung; "NL" returns Sinterklaas). |