llms.txt Content
# Surprise Buddy
> Surprise Buddy is an AI-powered gift recommendation app that helps users find the perfect gift for any occasion. It supports 70+ countries, 11 languages, and multiple currencies.
Surprise Buddy uses Google Gemini AI to generate personalized gift suggestions based on the recipient's age, gender, interests, occasion, and budget. Each recommendation includes a product name, description, and a direct link to shop (Amazon, Etsy, Mercado Libre, or other region-specific stores).
The app is available at [https://www.surprise-buddy.com](https://www.surprise-buddy.com).
## Supported Languages
- English (en), German (de), Spanish (es), French (fr), Italian (it), Portuguese (pt), Dutch (nl), Polish (pl), Swedish (sv), Danish (da), Norwegian (no)
All routes are locale-prefixed: `/{locale}/page`
## Main Pages
- [Home](https://www.surprise-buddy.com/en/): Gift finder form — select occasion, recipient details, interests, and budget to get AI-generated gift recommendations
- [FAQ](https://www.surprise-buddy.com/en/faq): Frequently asked questions about how Surprise Buddy works
- [Contact](https://www.surprise-buddy.com/en/contact): Contact form
- [Imprint](https://www.surprise-buddy.com/en/imprint): Legal imprint
- [Privacy](https://www.surprise-buddy.com/en/privacy): Privacy policy
## Occasion Pages
- [Birthday](https://www.surprise-buddy.com/en/birthday): Birthday gift ideas with countdown
- [Christmas](https://www.surprise-buddy.com/en/christmas): Christmas gift ideas with countdown
- [Easter](https://www.surprise-buddy.com/en/easter): Easter gift ideas with countdown
- [Valentine's Day](https://www.surprise-buddy.com/en/valentines): Valentine's Day gift ideas with countdown
- [Mother's Day](https://www.surprise-buddy.com/en/mothers-day): Mother's Day gift ideas with countdown
- [Father's Day](https://www.surprise-buddy.com/en/fathers-day): Father's Day gift ideas with countdown
- [Wedding](https://www.surprise-buddy.com/en/wedding): Wedding gift id
OpenAPI Spec (preview)
openapi: 3.1.0
info:
title: SurpriseBuddy MCP / Gift Search API
version: 0.1.0
description: |
Curated gift database served via the Model Context Protocol (MCP) over HTTP JSON-RPC 2.0.
The single endpoint is `POST /api/mcp` which speaks MCP. The four tools below are
documented here as if they were plain REST operations, for agents that do not yet
speak MCP (e.g. OpenAI Custom GPT Actions).
Every result row is country-scoped: `country` is a hard filter and `product_url`