可用优惠券
工具名称
list_coupons
MCP Endpoint
tools/call · list_coupons
分类
会员与权益
做什么
查询用户可用券,合并 UPP 券与好礼券,仅返回 MCP 所需的:
- 券号(
coupon_id); - 券名称;
- 有效期结束时间。
调用前置
请求头需携带会员登录态。无业务入参。
入参
无。
用户语义触发
"我有哪些券"、"查下优惠券"、"有什么可用优惠"。
与算价的衔接
获取到 coupon_id 后,可:
- 直接放入
calculate_pickup_price/calculate_delivery_price的coupon_list试算; - 用户确认应付金额后,再带入对应的创建订单工具。