# Surprise Buddy

> Use this tool when you need to find curated gift ideas tailored to a specific country and occasion, or when you want to filter gifts by interests, colors, or other criteria. Surprise Buddy solves the problem of discovering unique and relevant gifts by providing a searchable database of real products from various marketplaces. It takes in parameters such as country, occasion, and interests, and outputs a list of gift ideas with direct links to product pages.

Canonical page: https://skillsregistry.net/skills/surprise-buddy-mcp-server  
JSON: https://api.skillsregistry.net/v1/skills/surprise-buddy-mcp-server

## Description

## 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

## Trust

- **Trust score (0–1):** 0.30
- **Verification tier:** unverified
- **Last scanned:** 2026-08-30

## Facts

- **Version:** 1.0.0
- **Skill type:** atomic
- **Execution layer:** mcp-remote
- **Runtime environment:** api
- **Category:** database
- **Updated:** 2026-08-30

## Source

- **Source listing:** [Smithery](https://smithery.ai/server/surprise-buddy/mcp-server)

## Use it

Resolve this record through the SkillsRegistry MCP server (no auth, read-only):

```
claude mcp add --transport http --scope user skillsregistry https://api.skillsregistry.net/mcp
```

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_skill",
    "arguments": {
      "slug": "surprise-buddy-mcp-server"
    }
  }
}
```

REST: `GET https://api.skillsregistry.net/v1/skills/surprise-buddy-mcp-server` · pull for local use: `GET https://api.skillsregistry.net/v1/skills/surprise-buddy-mcp-server/pull`

---
SkillsRegistry indexes agent skills from public registries and GitHub. Skills we have analysed are scanned with Circle-IR and scored on six dimensions; each listing states its scan coverage. More: https://skillsregistry.net/llms.txt