Surprise Buddy
One of the ways to connect 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
- Version:
- hosted
- Publisher:
- surprise-buddy
Install
Generated from the server’s transport data — never hand-written. Placeholders in angle brackets are yours to fill.
Run it with its own identity, a budget you set, and every call audited — no local config to keep in sync.
Add to a connect0 projectYou will sign in first, then land back on this page.
What it can do
As declared by the publisher
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_colorsList the canonical favorite-color vocabulary used by find\_gifts.favorite\_color. Matches the color picker shown in the website UI.
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_interestsList the canonical interest/hobby tag vocabulary used by find\_gifts.interests. Matches the tags shown in the website UI.
list_supported_occasionsList occasion codes that have active gift entries, optionally narrowed to a specific country.