About catalogapi
catalogapi is a public, read-only MCP server for teams evaluating reward coverage, catalog items, or CatalogAPI integration. Its answers use live service data, with no API key, signup, or installation required.
Key features
- 01Check country and reward-category coverage
- 02Search demonstration catalog examples
- 03Retrieve details for a catalog item
- 04Ask about fulfillment, pricing, and integration
Use cases
- 01Check reward availability across target countries
- 02Review example rewards for a country
- 03Understand how rewards reach recipients
- 04Explore CatalogAPI integration options
MCP support
Exposes four read-only tools for coverage, catalog examples, item details, and service questions. The public endpoint requires no API key or signup.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://api.catalogapi.com/mcpclaude mcp add --transport http com-catalogapi-catalogapi https://api.catalogapi.com/mcp{"mcpServers":{"com-catalogapi-catalogapi":{"type":"http","url":"https://api.catalogapi.com/mcp"}}}Open in Cursor{"servers":{"com-catalogapi-catalogapi":{"type":"http","url":"https://api.catalogapi.com/mcp"}}}Open in VS Code{"mcpServers":{"com-catalogapi-catalogapi":{"type":"http","url":"https://api.catalogapi.com/mcp"}}}{"mcpServers":{"com-catalogapi-catalogapi":{"serverUrl":"https://api.catalogapi.com/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
Details
From the project READMECatalogAPI 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: [email protected].
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.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.