com.catalogapi/catalogapi

Official4 toolsLive

by catalogapi

Check reward coverage by country, search real catalog items, and ask how CatalogAPI works.

CatalogAPI MCP Server (com.catalogapi/catalogapi)

This public, read-only Model Context Protocol (MCP) server provides access to CatalogAPI data for questions about reward coverage by country, searching real catalog items, and explaining how CatalogAPI works. It is designed to support assistant answers using real data rather than guessing.

🛠️ Key Features

Public and read-only MCP server
Covers reward coverage by country
Enables search of real catalog items
Explains integration: how CatalogAPI works
Tool availability: 4 tools

🚀 Use Cases

Check reward coverage by country
Look up items in the CatalogAPI catalog
Ask questions about CatalogAPI integration details

⚡ Developer Benefits

Uses real CatalogAPI data for accuracy
No API key, no signup, and nothing to install
Connect via https://api.catalogapi.com/mcp

⚠️ Limitations

Server is read-only

📚 Topics

api, gift-cards, mcp, model-context-protocol, rewards

Topics

apigift-cardsmcpmodel-context-protocolrewards

Captured live from the server via tools/list.

check_coverage

Check whether CatalogAPI can supply rewards in one or more countries, and which product categories are available there. Call this when someone asks if rewards, gift cards, or incentives can be offered in a particular country, when they have recipients in several countries, or when they ask which countries are supported. This is the authoritative answer about what a country supports.

Parameters1

countries

array

optional

ISO-2 country codes, for example ["US", "PL"]. Omit to list every covered country.

Raw schema

{
  "type": "object",
  "properties": {
    "countries": {
      "description": "ISO-2 country codes, for example [\"US\", \"PL\"]. Omit to list every covered country.",
      "items": {
        "type": "string"
      },
      "type": "array"
    }
  }
}

get_reward_details

Get detail for a single catalog item. Call this after search_rewards when someone asks about a specific item.

Parameters2

country	string	required	ISO-2 country code the item came from.
item_id	string	required	The item id returned by search_rewards.

Raw schema

{
  "type": "object",
  "properties": {
    "country": {
      "description": "ISO-2 country code the item came from.",
      "type": "string"
    },
    "item_id": {
      "description": "The item id returned by search_rewards.",
      "type": "string"
    }
  },
  "required": [
    "country",
    "item_id"
  ]
}

how_it_works

Answer questions about CatalogAPI itself: what it is, how rewards are delivered to recipients, how currencies and billing work, whether the catalog can be customized or extended with your own products, how the API integration works, and how to get started. Call this for any question about the service, the company, or the product model rather than about specific catalog items.

Parameters1

topic

enum

required

Which question to answer. overview: What CatalogAPI is and the two ways to use it. coverage: Which countries are covered and what a catalog contains. custom_catalogs: Sourcing items on request, and putting your own products in your catalog as a supplier. fulfillment: How each kind of reward reaches a recipient, and who supports it. pricing_and_billing: What catalog prices mean, what you charge your own users, how tax and shipping are handled (which depends on whether the program is points-based or a store where people spend their own money), and how billing and currency conversion work. integration: What integrating looks like, including the fulfillment-only path. getting_started: How to get sandbox access and what production involves.

Raw schema

{
  "type": "object",
  "properties": {
    "topic": {
      "description": "Which question to answer. overview: What CatalogAPI is and the two ways to use it. coverage: Which countries are covered and what a catalog contains. custom_catalogs: Sourcing items on request, and putting your own products in your catalog as a supplier. fulfillment: How each kind of reward reaches a recipient, and who supports it. pricing_and_billing: What catalog prices mean, what you charge your own users, how tax and shipping are handled (which depends on whether the program is points-based or a store where people spend their own money), and how billing and currency conversion work. integration: What integrating looks like, including the fulfillment-only path. getting_started: How to get sandbox access and what production involves.",
      "enum": [
        "overview",
        "coverage",
        "custom_catalogs",
        "fulfillment",
        "pricing_and_billing",
        "integration",
        "getting_started"
      ]
    }
  },
  "required": [
    "topic"
  ]
}

search_rewards

Show example rewards available in one country. Call this when someone asks what kind of thing is on offer, or wants to see the catalog for a country. Returns items from a demonstration catalog: these are examples rather than the full inventory, and no pricing is returned. Use check_coverage for the definitive answer about what a country supports.

Parameters2

country	string	required	ISO-2 country code, for example "PL".
query	string	optional	Optional search term, for example "headphones".

Raw schema

{
  "type": "object",
  "properties": {
    "country": {
      "description": "ISO-2 country code, for example \"PL\".",
      "type": "string"
    },
    "query": {
      "description": "Optional search term, for example \"headphones\".",
      "type": "string"
    }
  },
  "required": [
    "country"
  ]
}

README.md3 KBView on GitHub

CatalogAPI MCP server

A public, read-only MCP server for CatalogAPI, the global rewards and gift card API.

Connect it and your assistant can answer questions about reward coverage, catalog contents, and how the integration works using our real data instead of guessing.

No API key. No signup. Nothing to install.

code

https://api.catalogapi.com/mcp

Add it

Claude Code:

bash

claude mcp add --transport http catalogapi https://api.catalogapi.com/mcp

For other clients, see docs/clients.md.

What you can ask

Once connected, questions like these get answered from live data:

"Can we send rewards to recipients in Poland, Brazil, and Japan?"
"What kind of rewards are available in Germany?"
"How do rewards actually reach a recipient?"
"What does a catalog price mean? Is that what my users pay?"
"What would integrating this look like if we already have a storefront?"

Tools

Tool	What it does
`check_coverage`	Which countries are covered, and which categories are available in each
`search_rewards`	Example items from a demonstration catalog for one country
`get_reward_details`	Detail for a single catalog item
`how_it_works`	Answers about the service itself: coverage, fulfillment, pricing, integration

Full reference: docs/tools.md.

All four are read-only. The server exposes nothing that is not already public on api.catalogapi.com/browse.

Two things worth knowing

search_rewards returns examples, not inventory. It reads a demonstration catalog, and it does not return pricing. For a definitive answer about what a country supports, use check_coverage.

check_coverage is the authoritative one. If the two ever seem to disagree, believe check_coverage.

Postman collection

postman/ has a collection covering the REST API itself: 35 requests across the cart, catalog, and order lifecycle, plus a sandbox environment.

The environment ships with an empty apiKey. Create a sandbox key from your dashboard after signing up, and fill it in.

Support

Questions about the MCP server: open an issue here.

Anything else, including API and account questions: support@catalogapi.com.

About this repository

CatalogAPI is a commercial service and its implementation is not open source. This repository is the public home of the MCP server: documentation, client configuration, the Postman collection, and an issue tracker. The server runs at the endpoint above.

The MIT licence covers the contents of this repository, meaning the documentation and the Postman collection. It does not cover the CatalogAPI service, the API, or the catalog data, which are governed by your agreement with us.

CatalogAPI is a service of WHAPPS LLC.

Install

Tools (4)

check_coverageget_reward_detailshow_it_workssearch_rewards

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://api.catalogapi.com/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "catalogapi": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.catalogapi.com/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

com.catalogapi/catalogapi

CatalogAPI MCP Server (com.catalogapi/catalogapi)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

📚 Topics

Topics

check_coverage

get_reward_details

how_it_works

search_rewards

CatalogAPI MCP server

Add it

What you can ask

Tools

Two things worth knowing

Postman collection

Links

Support

About this repository

Install

Remote endpoint

Related servers