Back to search
100
MCP live http

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](LICENSE) © Surprise Buddy

Uptime
100.0%
10 probes
Response
764ms
last probe
Tools
5
callable
Primary URL
https://surprise-buddy.com/api/mcp

Tools · 5

find_gifts

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 h…

list_supported_countries

List ISO-2 country codes that currently have at least one active gift entry in the database. Coverage grows over time.

list_supported_occasions

List occasion codes that have active gift entries, optionally narrowed to a specific country.

list_supported_interests

List the canonical interest/hobby tag vocabulary used by find_gifts.interests. Matches the tags shown in the website UI.

list_supported_colors

List the canonical favorite-color vocabulary used by find_gifts.favorite_color. Matches the color picker shown in the website UI.

How to use

Add to your Claude Desktop / Cursor / Cline MCP config:

{
  "mcpServers": {
    "surprise_buddy": {
      "url": "https://surprise-buddy.com/api/mcp",
      "transport": "http"
    }
  }
}