Back to search
100
MCP live MCP 2025-06-18 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

Website ↗

Watch this dependency

Get before/after evidence when observed tools, schemas, authentication access, availability or the endpoint changes.

Inspect evidence and set up a watch Share public evidence report
Uptime
100.0%
5 direct probes · 30d
Response
999ms
last probe
Tools
5
callable
Resources
0
readable
Prompts
0
available
Primary URL
https://surprise-buddy.com/api/mcp
Score: 100/100
Handshake verified by our own probe.
why this score
pass Answers the MCP handshake 50/50
The handshake and the list calls succeeded on the primary URL.
pass Lists tools, resources or prompts 30/30
5 tools, 0 resources, 0 prompts returned.
pass 3 or more catalogue items 10/10
5 items in total; 3 or more earns these points.
pass Describes itself 10/10
773 characters; more than 30 earns these points.

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"
    }
  }
}