{
  "markdown": "# CatalogAPI MCP server\n\nA public, read-only [MCP](https://modelcontextprotocol.io) server for\n[CatalogAPI](https://api.catalogapi.com), the global rewards and gift card API.\n\nConnect it and your assistant can answer questions about reward coverage,\ncatalog contents, and how the integration works using our real data instead of\nguessing.\n\n**No API key. No signup. Nothing to install.**\n\n```\nhttps://api.catalogapi.com/mcp\n```\n\n## Add it\n\nClaude Code:\n\n```bash\nclaude mcp add --transport http catalogapi https://api.catalogapi.com/mcp\n```\n\nFor other clients, see [docs/clients.md](docs/clients.md).\n\n## What you can ask\n\nOnce connected, questions like these get answered from live data:\n\n- \"Can we send rewards to recipients in Poland, Brazil, and Japan?\"\n- \"What kind of rewards are available in Germany?\"\n- \"How do rewards actually reach a recipient?\"\n- \"What does a catalog price mean? Is that what my users pay?\"\n- \"What would integrating this look like if we already have a storefront?\"\n\n## Tools\n\n| Tool | What it does |\n|---|---|\n| `check_coverage` | Which countries are covered, and which categories are available in each |\n| `search_rewards` | Example items from a demonstration catalog for one country |\n| `get_reward_details` | Detail for a single catalog item |\n| `how_it_works` | Answers about the service itself: coverage, fulfillment, pricing, integration |\n\nFull reference: [docs/tools.md](docs/tools.md).\n\nAll four are read-only. The server exposes nothing that is not already public on\n[api.catalogapi.com/browse](https://api.catalogapi.com/browse).\n\n## Two things worth knowing\n\n**`search_rewards` returns examples, not inventory.** It reads a demonstration\ncatalog, and it does not return pricing. For a definitive answer about what a\ncountry supports, use `check_coverage`.\n\n**`check_coverage` is the authoritative one.** If the two ever seem to disagree,\nbelieve `check_coverage`.\n\n## Postman collection\n\n[`postman/`](postman/) has a collection covering the REST API itself: 35\nrequests across the cart, catalog, and order lifecycle, plus a sandbox\nenvironment.\n\nThe environment ships with an empty `apiKey`. Create a sandbox key from your\ndashboard after [signing up](https://api.catalogapi.com/users/register), and\nfill it in.\n\n## Links\n\n- [API documentation](https://api.catalogapi.com/api/docs)\n- [Integration guide](https://api.catalogapi.com/api-integrations)\n- [FAQ](https://api.catalogapi.com/faq)\n- [Sandbox signup](https://api.catalogapi.com/users/register)\n\n## Support\n\nQuestions about the MCP server: open an issue here.\n\nAnything else, including API and account questions:\n[support@catalogapi.com](mailto:support@catalogapi.com).\n\n## About this repository\n\nCatalogAPI is a commercial service and its implementation is not open source.\nThis repository is the public home of the MCP server: documentation, client\nconfiguration, the Postman collection, and an issue tracker. The server runs at\nthe endpoint above.\n\nThe [MIT licence](LICENSE) covers the contents of this repository, meaning the\ndocumentation and the Postman collection. It does not cover the CatalogAPI\nservice, the API, or the catalog data, which are governed by your agreement with\nus.\n\nCatalogAPI is a service of WHAPPS LLC.\n",
  "bytes": 3226,
  "sha": "83be2fbbc7f4901593a0c02f92e7492bdac2f9a245d4b070c953bbb94d693982",
  "repo_slug": "catalogapi/mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_catalogapi_catalogapi_3eddb201/readme"
}