Starbucks星巴克 MCP 开放平台

门店可售商品列表

工具名称
list_products
MCP Endpoint
tools/call · list_products
分类
商品与套餐

做什么

获取指定门店当前可供点单的商品列表。后端已按当前接入方的渠道配置过滤不支持的商品, 并过滤掉不可售商品,返回结果均为当前可点单的有效商品。

建议缓存

建议 Agent 在会话开始时调用一次并缓存(建议 30 分钟),避免反复调用造成上下文膨胀。

履约方式说明

biz_type 参数决定返回的商品范围,pickup(到店自取)与 delivery(外卖配送) 的可售商品可能不同,Agent 应根据用户当前场景传入正确值。

硬约束:item_id 不可跨 biz_type 复用

本接口返回的 item_id 仅保证在本次调用所用的 biz_type 下可进入后续 get_product / 算价 / 下单链路。禁止将 biz_type=pickup 返回的 item_id 用于后续 biz_type=delivery 工具,反之亦然。

入参

参数类型必填说明
biz_type'pickup' | 'delivery'履约方式:pickup(到店自取)/ delivery(外卖配送)。
store_idstring门店 ID,来自 search_stores。
reservationbooleantrue=隔日预约商品;false/不传=当天可下单商品。

出参要点

返回的每个条目带 item_type,常见取值:

  • product — 单品,可直接调用 get_product 取规格与客制化。
  • combo / fixcombo — 套餐,需调用 get_combo 展开。