Surprise Buddy
## 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](LICENSE) © Surprise Buddy
How to connect
Same URL, five paste targets. Ready surface · Auth required. Not a safe-to-install badge. Handshake this URL
Paste into Settings → MCP or .cursor/mcp.json.
{
"mcpServers": {
"surprise-buddy-mcp-server": {
"url": "https://mcp-server--surprise-buddy.run.tools"
}
}
}
Paste into .vscode/mcp.json.
{
"mcpServers": {
"surprise-buddy-mcp-server": {
"url": "https://mcp-server--surprise-buddy.run.tools"
}
}
}
Settings → Connectors → Add → Custom → Web. Paste the URL. Enable in a new chat.
Claude → Settings → Connectors → Add → Custom → Web
Name: Surprise Buddy
URL: https://mcp-server--surprise-buddy.run.tools
OAuth only if this server requires it.
Save, start a new chat, enable the connector.
Developer mode custom connector. ChatGPT cannot reach localhost.
Settings → Apps & Connectors → Advanced → Developer mode ON
Create custom connector
Name: Surprise Buddy
MCP server URL: https://mcp-server--surprise-buddy.run.tools
Auth: none unless the server requires OAuth
New chat → + → Developer mode → enable the connector
Register the HTTPS URL, then claude mcp list.
claude mcp add --transport http surprise-buddy-mcp-server \
https://mcp-server--surprise-buddy.run.tools
Pass on session/new as mcpServers when the agent advertised HTTP MCP.
[
{
"type": "http",
"name": "surprise-buddy-mcp-server",
"url": "https://mcp-server--surprise-buddy.run.tools"
}
]
Paste into a README or docs site. The widget loads snippets from Influzer — still not a SAFE badge.
Same handshake clock as this listing (overlay / warm / seed; live tools/list only if that is missing). Indigo is live_ok, amber is auth_required, gray is unreachable. Not a SAFE badge. Stdio listings have no badge.
[](https://www.influzer.ai/mcp/probe?url=https%3A%2F%2Fmcp-server--surprise-buddy.run.tools)
<div data-influzer-install="surprise-buddy-mcp-server"></div>
<script async src="https://www.influzer.ai/embed/install.js"></script>
https://www.influzer.ai/embed/mcp/surprise-buddy-mcp-server.md
JSON: https://www.influzer.ai/api/v1/install/surprise-buddy-mcp-server
Recipes using this server
No published recipes yet for this server.
Listing quality
Observable facts from our catalog and daily probe — not a safe-to-install badge.
- Surface
- Ready surface
- Auth gate
- Auth gate
- Tools source
- tools/list (live)
Observable catalog + probe facts — not a safe-to-install badge. How we verify.
Verification summary
Stored signals only. Not a safety score.
- Verification grade
- A (85)
- Last verified
- Status
- Auth required
- Response time
- 0 ms
- Auth
- Auth gate
- Transport
- http, HTTPS
- Tools indexed
- 5
- 30-day uptime
- 100% of 6 samples over 6 days
Probe history
- · auth_required · 0 ms
- · auth_required · 0 ms
- · auth_required · 0 ms
- · auth_required · 0 ms
- · auth_required · 0 ms
Tools
(5)-
find_giftsSearch 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.
-
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_occasionsList occasion codes that have active gift entries, optionally narrowed to a specific country.
-
list_supported_interestsList the canonical interest/hobby tag vocabulary used by find_gifts.interests. Matches the tags shown in the website UI.
-
list_supported_colorsList the canonical favorite-color vocabulary used by find_gifts.favorite_color. Matches the color picker shown in the website UI.
Tool source: tools/list (live) · last probed 2026-11-04