# catalogapi

Публичный MCP-сервер CatalogAPI: ассистент отвечает про покрытие наград по странам и содержимое каталога по живым данным, без ключа и регистрации.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Автор: catalogapi
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/catalogapi/mcp-server
- Обновлён: 2026-08-09
- HTML: https://affpapa.org/nevibecode/mcp/catalogapi

## Что делает

Сервер подключается по адресу `https://api.catalogapi.com/mcp` и даёт ассистенту четыре инструмента. `check_coverage` показывает, в каких странах есть покрытие и какие категории доступны в каждой. `search_rewards` вытаскивает примеры позиций из демонстрационного каталога по одной стране. `get_reward_details` отдаёт подробности по отдельной позиции, а `how_it_works` отвечает на вопросы про сам сервис: покрытие, доставку наград, цены, интеграцию.

Все четыре инструмента только читают. Сервер не открывает ничего сверх того, что уже лежит в публичном доступе на `api.catalogapi.com/browse`. Ключ API и регистрация не нужны, ставить тоже нечего.

Есть нюанс, который стоит держать в голове. `search_rewards` возвращает примеры, а не реальные остатки, и цен в ответе нет. Если нужно точно знать, что поддерживает страна, спрашивайте `check_coverage` — при расхождении верен именно он. В репозитории лежит коллекция Postman для REST API: запросы по корзине, каталогу и заказам плюс песочница. В песочнице поле `apiKey` пустое, ключ создаётся в личном кабинете после регистрации.

## Требования
- Удалённый сервер: `https://api.catalogapi.com/mcp`

## Установка

### Claude Code (родная платформа)

**Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http catalogapi https://api.catalogapi.com/mcp
```

### Codex

**Командой платформы: удалённый сервер**
```bash
codex mcp add catalogapi --url https://api.catalogapi.com/mcp
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "catalogapi": {
            "url": "https://api.catalogapi.com/mcp"
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "catalogapi": {
            "type": "http",
            "url": "https://api.catalogapi.com/mcp"
        }
    }
}
```

### Gemini CLI

**Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http catalogapi https://api.catalogapi.com/mcp
```

## Когда брать
- узнать, в каких странах доступны награды
- посмотреть примеры позиций каталога для конкретной страны
- получить детали одной позиции каталога
- разобраться, как награда доходит до получателя
- понять, что означает цена в каталоге

## Примеры запросов агенту
- Можно ли отправить награды получателям в Польше, Бразилии и Японии?
- Какие награды доступны в Германии?
- Как награда доходит до получателя?

## Похожие
- [shopify-loyalty-program](https://affpapa.org/nevibecode/skills/shopify-loyalty-program.md) — скилл · 1000 установок
- [backend-architect](https://affpapa.org/nevibecode/agents/backend-architect.md) — субагент · 23691 установка
- [resend](https://affpapa.org/nevibecode/skills/resend.md) — скилл · 23400 установок
- [cf-cli](https://affpapa.org/nevibecode/skills/cf-cli.md) — скилл · 11500 установок
- [developer-platform-career](https://affpapa.org/nevibecode/skills/developer-platform-career.md) — скилл · 8100 установок
- [api-idempotency-retry](https://affpapa.org/nevibecode/skills/api-idempotency-retry.md) — скилл · 8000 установок

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md