# Surprise Buddy

Surprise Buddy connects AI assistants to a country-scoped gift database with direct links to real marketplace products.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 4734 installs
- Author: surprise-buddy
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://smithery.ai/server/surprise-buddy/mcp-server
- Updated: 2026-05-16
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/surprise-buddy

## What it does

Surprise Buddy exposes gift recommendation queries to your assistant via MCP. The service matches recipients to items from marketplaces like Amazon, Etsy, Bol.com, Allegro, and Otto, returning item titles, images, prices, and links ready to open.

Search queries through `find_gifts` require an ISO-2 country code. That parameter is mandatory because results adapt to local currencies and regionally available stores. Companion tools list supported regions, occasion codes, hobby tags, and color filters before running a search.

Authentication is omitted entirely, making the server publicly accessible. Rate limits can still apply under heavy traffic.

## Requirements
- Remote server: `https://mcp-server--surprise-buddy.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http mcp-server https://mcp-server--surprise-buddy.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add surprise-buddy --url https://mcp-server--surprise-buddy.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "surprise-buddy": {
            "url": "https://mcp-server--surprise-buddy.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "surprise-buddy": {
            "type": "http",
            "url": "https://mcp-server--surprise-buddy.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http surprise-buddy https://mcp-server--surprise-buddy.run.tools
```

## When to use it
- search for gifts tailored to a specific country and currency
- fetch direct product links from marketplaces like Etsy or Allegro
- inspect valid occasion and hobby tags before querying gifts
- match presents based on recipient interests and preferred colors

## Example prompts
- Find a birthday gift for a coffee lover in Germany using Surprise Buddy
- List the countries and occasions supported by Surprise Buddy
- Suggest a gift in France for someone interested in board games

## Similar
- [menlo-labs-shopping-mcp](https://affpapa.org/en/nevibecode/mcp/menlo-labs-shopping-mcp.md) — MCP server · 181 installs
- [iwant.fyi](https://affpapa.org/en/nevibecode/mcp/iwantfyi.md) — MCP server · 6979 installs
- [UCP Gateway](https://affpapa.org/en/nevibecode/mcp/ucp-gateway.md) — MCP server · 3618 installs
- [firecrawl-shop](https://affpapa.org/en/nevibecode/skills/firecrawl-shop.md) — skill · 31600 installs
- [ShopGraph](https://affpapa.org/en/nevibecode/mcp/shopgraph.md) — MCP server · 327 installs
- [humannotrequiredv2](https://affpapa.org/en/nevibecode/mcp/humannotrequiredv2.md) — MCP server · 119 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
