关于 Smile.io MCP by usefulapi
Smile.io MCP by usefulapi 将 Smile.io 忠诚度数据和操作接入 MCP 客户端,面向管理客户积分、奖励、积分获取规则及 VIP 等级的企业。
主要功能
- 01查询客户及积分历史
- 02查看奖励和兑换选项
- 03查看积分获取规则及 VIP 等级
- 04调整客户积分余额
- 05记录活动并兑换奖励
适用场景
- 01查询客户积分余额和历史
- 02查看可兑换奖励及 VIP 状态
- 03在客户互动后调整积分
- 04为客户兑换积分奖励
MCP 相关
通过托管端点向 MCP 客户端提供 Smile.io 忠诚度查询及写入工具。读取工具仅供查询,写入工具可更改客户数据或兑换积分。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://smile-io.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-smile-io https://smile-io.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-smile-io":{"type":"http","url":"https://smile-io.usefulapi.io/mcp"}}}在 Cursor 中打开{"servers":{"io-usefulapi-smile-io":{"type":"http","url":"https://smile-io.usefulapi.io/mcp"}}}在 VS Code 中打开{"mcpServers":{"io-usefulapi-smile-io":{"type":"http","url":"https://smile-io.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-smile-io":{"serverUrl":"https://smile-io.usefulapi.io/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
14| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| string | 否 | 要查找的精确邮箱地址。 | |
| limit | integer | 否 | 结果数量上限,1-250(Smile 默认值为 50)。 |
| state | enum | 否 | candidate = 尚未加入,member = 已加入计划,disabled = 已排除。candidate | member | disabled |
| cursor | string | 否 | 来自上一响应的 metadata.next_cursor(或 previous_cursor)的游标。第一页请省略。 |
| updated_at_min | string | 否 | 仅返回在此 ISO 8601 日期时间或之后更新的记录,例如 2026-01-01T00:00:00Z。 |
| include_vip_status | boolean | 否 | 包含每位客户的 vip_status 对象(include=vip_status)。 |
详细介绍
usefulapi 提供的 Smile.io MCP
在 Claude、Cursor 或任何 MCP 客户端中使用 Smile.io——查询忠诚度计划客户、积分余额和历史记录、积分赚取与兑换方式、已发放的奖励和 VIP 等级,以及调整积分。 托管服务,无需本地安装:使用你自己的 Smile.io 凭据连接。
实时端点: https://smile-io.usefulapi.io/mcp · 主页: https://usefulapi.io/smile-io
连接
- Claude(claude.ai、桌面版):打开 自定义 → 连接器,点击 + 添加 → 添加自定义连接器,然后粘贴
https://smile-io.usefulapi.io/mcp。 - Claude Code:
claude mcp add --transport http smile-io https://smile-io.usefulapi.io/mcp,然后运行/mcp登录。 - VS Code: 添加到 VS Code。
- Cursor 和其他客户端: 将该 URL 添加为远程 MCP 服务:
{
"mcpServers": {
"smile-io": {
"url": "https://smile-io.usefulapi.io/mcp"
}
}
}
只添加 URL。不要在客户端配置中添加 Authorization 标头或 API 密钥:服务会通过 OAuth 为你登录,登录页面会要求你提供 Smile.io 凭据。
分步设置说明、凭据查找方式和常见问题:https://usefulapi.io/smile-io/
首次连接时,你需要提供 Smile.io 商家 API 密钥(Smile Admin → Settings → Developer tools → API keys)。 系统会验证密钥并按用户存储,且仅限你本人使用——配置文件中不会存放密钥。
工具
| 工具 | 类型 | 功能 |
|---|---|---|
smile_list_customers | 读取 | 列出客户 |
smile_get_customer | 读取 | 获取客户信息 |
smile_list_points_transactions | 读取 | 列出积分交易 |
smile_get_points_transaction | 读取 | 获取积分交易 |
smile_list_points_products | 读取 | 列出积分商品(兑换方式) |
smile_get_points_product | 读取 | 获取积分商品 |
smile_list_reward_fulfillments | 读取 | 列出奖励发放记录 |
smile_list_earning_rules | 读取 | 列出积分赚取规则(赚取方式) |
smile_list_vip_tiers | 读取 | 列出 VIP 等级 |
smile_get_points_settings | 读取 | 获取积分设置 |
smile_get_referral_settings | 读取 | 获取推荐设置 |
smile_create_points_transaction | 写入 | 调整客户的积分余额 |
smile_create_activity | 写入 | 记录客户活动 |
smile_purchase_points_product | 写入 | 兑换客户的积分奖励 |
smile_usage_status | 元数据 | 使用状态(免费套餐用量计数) |
smile_request_feature | 元数据 | 申请添加缺失功能 |
smile_upgrade | 元数据 | 升级到 Pro(不限量*) |
smile_cancel_subscription | 元数据 | 取消 Pro 订阅 |
read 工具为只读;write 工具会修改数据(客户端应先征求确认);meta 工具用于报告用量、管理订阅或发送功能申请。
定价
| 套餐 | 价格 | 限额 |
|---|---|---|
| 免费 | $0 | 每月 50 次工具调用 |
| Pro(每位用户) | $9/mo 或 $90/yr(免费 2 个月) | 不限量* |
*此服务的 Pro 套餐公平使用限额为每月 10,000 次工具调用。如需更多,请发送邮件至 [email protected]。
Pro 仅适用于此服务。使用 smile_upgrade 订阅(它会返回 Stripe Checkout 链接)。可随时使用 smile_cancel_subscription 取消:Pro 服务会持续到付费周期结束,当前周期不予退款;在此之前运行 smile_upgrade 可撤销取消操作。也可发送邮件至 [email protected]。
许可证
MIT © usefulapi。与 Smile.io 无关联,也未获其认可。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。