Surprise Buddy

What is Surprise Buddy?

От сообществаРаботаетБез входаГлобальныйБесплатноТолько чтение

Что умеет

  • 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 require
  • 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.

Какие данные видит

Нужен ли аккаунт

Не нужен: сервер работает без входа

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 © Surprise Buddy

Как подключить

Как подключить Surprise Buddy к Claude

Адрес сервера, который нужно вставить в настройках Claude:

https://mcp-server--surprise-buddy.run.tools

  1. Откройте Claude (сайт claude.ai или приложение для компьютера).
  2. Перейдите в Настройки → Коннекторы (в английском интерфейсе: Settings → Connectors).
  3. Нажмите Добавить пользовательский коннектор (Add custom connector).
  4. Вставьте адрес сервера, скопированный ниже, в поле URL удалённого MCP-сервера и нажмите Добавить.
  5. В чате нажмите + → Коннекторы и включите новый коннектор.

Пользовательские коннекторы доступны на тарифах Free, Pro, Max, Team и Enterprise. На Free можно добавить только один. В Team и Enterprise коннектор сначала добавляет владелец организации в Настройки организации → Коннекторы.

Авторизация

После нажатия Добавить откроется окно входа в сервис. Войдите под своим аккаунтом и подтвердите доступ. Пароль Claude не видит.

Как подключить Surprise Buddy к ChatGPT

Адрес сервера, который нужно вставить в настройках ChatGPT:

https://mcp-server--surprise-buddy.run.tools

  1. Откройте ChatGPT в браузере (chatgpt.com). Нужен тариф Plus, Pro, Business, Enterprise или Edu.
  2. Один раз включите режим разработчика: Настройки → Приложения → Дополнительные настройки → Режим разработчика (Settings → Apps → Advanced settings → Developer mode).
  3. Откройте Настройки → Коннекторы и нажмите Создать (Create).
  4. Заполните форму: Название (любое), Описание (одна фраза, что делает сервис), URL MCP-сервера (скопируйте ниже).
  5. В поле Аутентификация выберите OAuth, если сервис требует вход, иначе Нет. Нажмите Создать.
  6. В новом чате откройте + → Приложения/Коннекторы и включите коннектор.

Название раздела у OpenAI менялось (Connectors → Apps/Plugins). Если пункт называется иначе, ищите «режим разработчика» в настройках. В рабочих пространствах Business/Enterprise администратор должен разрешить пользовательские коннекторы.

Авторизация

При первом использовании ChatGPT откроет окно входа в сервис. Войдите и подтвердите доступ.

Как подключить Surprise Buddy к Cursor

Адрес сервера, который нужно вставить в настройках Cursor:

https://mcp-server--surprise-buddy.run.tools

Быстрый способ: нажмите кнопку Открыть в Cursor ниже, Cursor сам предложит добавить сервер.

Вручную:

  1. В Cursor откройте Settings → Cursor Settings → MCP и нажмите Add new global MCP server.
  2. Вставьте JSON, скопированный ниже, в открывшийся файл ~/.cursor/mcp.json (для одного проекта: .cursor/mcp.json в корне проекта).
  3. Сохраните файл. Сервер появится в списке MCP; при необходимости пройдите авторизацию по кнопке рядом с ним.

Авторизация

Если сервис требует вход, рядом с сервером в списке MCP появится кнопка авторизации.

Список инструментов сервера (5)

Технические названия из tools/list. Нужны только разработчикам.

find_giftsSearch 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 hard filter — results are scoped to the marketplace + currency of that country.
list_supported_countriesList ISO-2 country codes that currently have at least one active gift entry in the database. Coverage grows over time.
list_supported_occasionsList occasion codes that have active gift entries, optionally narrowed to a specific country.
list_supported_interestsList the canonical interest/hobby tag vocabulary used by find_gifts.interests. Matches the tags shown in the website UI.
list_supported_colorsList the canonical favorite-color vocabulary used by find_gifts.favorite_color. Matches the color picker shown in the website UI.