Starbucks星巴克 MCP 开放平台

专星送算价

工具名称
calculate_delivery_price
MCP Endpoint
tools/call · calculate_delivery_price
分类
算价与下单

做什么

MCP 专星送算价 —— 用户询问外卖价格时使用。 必须在 create_delivery_order 前调用,用于返回外卖场景的算价结果。

调用前置

  • 用户身份从请求头 x-customer-idx-user-id 获取。
  • 配送场景下,必须先调用 list_delivery_addresses, 并从用户选择的地址记录中获取 store_id / latitude / longitude 等字段,禁止自行拼接
  • delivery_provider 优先从地址 delivery_type 取,取不到默认传 1(蜂鸟)。

入参

参数类型必填说明
store_idstring门店 ID,从用户选中地址的 store_items[].store_id 取。
latitudestring纬度,从用户选中地址取。
longitudestring经度,从用户选中地址取。
delivery_providerinteger配送商:1-蜂鸟、2-美团、3-顺丰、4-达达。
item_listItemInput[]商品列表,字段映射规则与啡快算价一致;客制化必须包含默认配料与用户显式选择项。
combo_group_infoComboGroup[]套餐场景使用;activity_id = get_combo.item_id,group_id 由 agent 生成 UUID。
coupon_liststring[]优惠券 ID 列表;可基于上一次算价的 can_use_coupon 重新试算。

套餐组装规则

  • combo_group_info[*].activity_id = get_combo.item_id
  • item_list[*].activity_id 与所属组保持一致;
  • combo_group_info[*].group_id 由 agent 显式生成 UUID,并同步写入 item_list[*].group_id
  • group_type 映射:fixcombo → 3combo_v2 → 0combo_v3 → 5
  • item_typegroup_type 一一对应,不可根据名称猜测。
券二次试算

若响应中 can_use_coupon 不为空,应提示用户有可用优惠券; 用户选择后,将 can_use_coupon.coupon_id 放入下一次算价的 coupon_list 中重新试算。