Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.

https://api.catalogapi.com/mcp

Add it

Claude Code:

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.

Links

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.

About

Public read-only MCP server for CatalogAPI: reward coverage, catalog examples, and how the integration works.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors