# catalogapi

A public MCP server for CatalogAPI that lets your assistant answer reward-coverage and catalog questions from live data, with no key and no signup.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: catalogapi
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/catalogapi/mcp-server
- Updated: 2026-08-09
- HTML: https://affpapa.org/en/nevibecode/mcp/catalogapi

## What it does

Point your client at `https://api.catalogapi.com/mcp` and the assistant gets four tools. `check_coverage` lists which countries are supported and what categories each one carries. `search_rewards` pulls sample items from a demonstration catalog for a single country. `get_reward_details` returns detail on one item, and `how_it_works` covers the service itself: coverage, fulfillment, pricing, integration.

Every tool is read-only. Nothing is exposed beyond what already sits in the public browse area at `api.catalogapi.com/browse`. There is no API key to obtain and no signup step.

One caveat matters. `search_rewards` gives examples rather than live inventory, and it omits pricing. For a firm answer on what a country supports, call `check_coverage` — when the two disagree, that one wins. The repository also ships a Postman collection for the REST API, covering cart, catalog and order requests along with a sandbox. Its `apiKey` field starts empty; you create a sandbox key in your dashboard after registering.

## Requirements
- Remote server: `https://api.catalogapi.com/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http catalogapi https://api.catalogapi.com/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add catalogapi --url https://api.catalogapi.com/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "catalogapi": {
            "url": "https://api.catalogapi.com/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "catalogapi": {
            "type": "http",
            "url": "https://api.catalogapi.com/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http catalogapi https://api.catalogapi.com/mcp
```

## When to use it
- find out which countries reward coverage reaches
- browse sample catalog items for one country
- pull details on a single catalog item
- understand how a reward reaches its recipient
- work out what a catalog price actually represents

## Example prompts
- What rewards are available in Germany?
- How does a reward reach the recipient?

## Similar
- [shopify-loyalty-program](https://affpapa.org/en/nevibecode/skills/shopify-loyalty-program.md) — skill · 1000 installs
- [backend-architect](https://affpapa.org/en/nevibecode/agents/backend-architect.md) — subagent · 23691 installs
- [resend](https://affpapa.org/en/nevibecode/skills/resend.md) — skill · 23400 installs
- [cf-cli](https://affpapa.org/en/nevibecode/skills/cf-cli.md) — skill · 11500 installs
- [developer-platform-career](https://affpapa.org/en/nevibecode/skills/developer-platform-career.md) — skill · 8100 installs
- [api-idempotency-retry](https://affpapa.org/en/nevibecode/skills/api-idempotency-retry.md) — skill · 8000 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