工具列表
Starbucks MCP 当前开放的全部 17 个工具,按"找店 → 选品 → 算价 → 下单 → 订单 → 会员"链路分组。
调用约定:所有工具均通过 MCP 标准的 tools/call 入口调用,请求体形如:
{
"jsonrpc": "2.0", "id": 1, "method": "tools/call",
"params": { "name": "<tool_name>", "arguments": { /* ... */ } }
}
门店发现
search_stores— 按城市 / 地址 / 坐标 / 标签搜索附近门店。search_stores_by_product— 按商品反查可售门店。
商品与套餐
list_products— 指定门店的可售商品列表。get_product— 单品详情(规格与客制化)。get_combo— 套餐详情与下单约束。list_promotions— 当前可用促销活动。
算价与下单
calculate_pickup_price— 啡快算价(返回temp_order_id)。create_pickup_order— 啡快下单(消费temp_order_id)。calculate_delivery_price— 专星送算价。create_delivery_order— 专星送下单。
订单管理
list_orders— 当前用户的订单列表。get_order— 订单详情(取餐码 / 支付链接 / 状态)。cancel_order— 关闭未完成订单。
会员与权益
get_user— 星星余额、会员等级与权益。list_coupons— 当前可用优惠券。
外送地址
list_delivery_addresses— 外送地址列表(外送下单前必调)。create_delivery_address— 新增外送地址。
重要约定
item_id不可跨biz_type复用(pickup ↔ delivery 切换必须重查)。- 套餐场景下,
combo_group_info.group_id与item_list.group_id必须由 Agent 显式生成同一个 UUID。 temp_order_id在算价 → 下单之间必须原样回传;重复请求幂等。- 外送场景下,地址相关字段必须来自
list_delivery_addresses。