关于 catalogapi
catalogapi 是面向评估奖励覆盖范围、目录商品或 CatalogAPI 集成方案团队的公开只读 MCP 服务。它使用服务实时数据回答问题，无需 API 密钥、注册或安装。
主要功能
- 01查询国家和奖励类别覆盖情况
- 02搜索演示目录中的商品示例
- 03获取单个目录商品详情
- 04咨询履约、定价和集成方式
适用场景
- 01核实目标国家是否支持发放奖励
- 02查看某个国家的奖励示例
- 03了解奖励如何送达接收者
- 04评估 CatalogAPI 集成方案
MCP 相关
提供覆盖范围、目录示例、商品详情和服务咨询这四种只读工具。公共端点无需 API 密钥或注册即可使用。
配置
远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。
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"}}}在 Cursor 中打开{"servers":{"com-catalogapi-catalogapi":{"type":"http","url":"https://api.catalogapi.com/mcp"}}}在 VS Code 中打开{"mcpServers":{"com-catalogapi-catalogapi":{"type":"http","url":"https://api.catalogapi.com/mcp"}}}{"mcpServers":{"com-catalogapi-catalogapi":{"serverUrl":"https://api.catalogapi.com/mcp"}}}命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
CatalogAPI MCP 服务
一个公开、只读的 MCP 服务，适用于全球奖励和礼品卡 API CatalogAPI。
连接后，你的助手就能使用真实数据，而不是靠猜测，回答有关奖励覆盖范围、目录内容以及集成方式的问题。
无需 API 密钥。无需注册。无需安装。
https://api.catalogapi.com/mcp
添加
Claude Code：
claude mcp add --transport http catalogapi https://api.catalogapi.com/mcp
其他客户端请参阅 docs/clients.md。
你可以询问的问题
连接后，以下问题都能根据实时数据得到解答：
- “我们可以向波兰、巴西和日本的收件人发送奖励吗？”
- “德国有哪些类型的奖励？”
- “奖励实际上是如何送达收件人的？”
- “目录价格是什么意思？这是我的用户要支付的价格吗？”
- “如果我们已经有一个在线商店，集成后会是什么样？”
工具
| 工具 | 功能 |
|---|---|
check_coverage | 覆盖哪些国家，以及每个国家有哪些类别 |
search_rewards | 某个国家的示例目录商品 |
get_reward_details | 单个目录商品的详情 |
how_it_works | 解答有关服务本身的问题：覆盖范围、履约、定价和集成 |
完整参考：docs/tools.md。
这四个工具都是只读的。该服务不会公开 api.catalogapi.com/browse 上尚未公开的任何内容。
有两点值得注意
search_rewards 返回的是示例，而不是库存。 它读取的是演示目录，也不会返回价格。要准确了解某个国家支持哪些内容，请使用 check_coverage。
check_coverage 是权威来源。 如果两者看起来有出入，请以 check_coverage 为准。
Postman 集合
postman/ 包含一个涵盖 REST API 本身的集合：包括购物车、目录和订单生命周期相关的 35 个请求，以及一个沙盒环境。
该环境中的 apiKey 为空。请在注册后从控制面板创建一个沙盒密钥，并填入该字段。
链接
支持
有关 MCP 服务的问题：请在此处提交 issue。
其他问题，包括 API 和账户问题： [email protected]。
关于此仓库
CatalogAPI 是一项商业服务，其实现并未开源。此仓库是 MCP 服务的公开主页，包含文档、客户端配置、Postman 集合和 issue 跟踪器。该服务运行于上文所述的端点。
MIT 许可证适用于此仓库的内容，即文档和 Postman 集合。它不适用于 CatalogAPI 服务、API 或目录数据；这些内容受你与我们签订的协议约束。
CatalogAPI 是 WHAPPS LLC 提供的服务。
评论
一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。