Skip to main content
Glama
waka4674

shipsaving-mcp

by waka4674

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
SHIPSAVING_APP_KEYYesShipSaving App Key (sk_ prefix)
SHIPSAVING_LOG_FILENoPath to log file (logs go to stderr by default)
SHIPSAVING_TIMEOUT_MSNoRequest timeout in milliseconds60000
SHIPSAVING_API_BASE_URLNoAPI base URLhttps://app-gateway.shipsaving.com

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": true
}
prompts
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
get_shipping_ratesA

获取多承运商运费报价比价。需提供寄件地址、收件地址、包裹信息和 ship_date。返回所有可用运费方案,标记最便宜和最快选项。

search_shipmentsB

搜索运单列表,支持多种条件筛选

get_shipment_detailC

查看运单详细信息

track_shipmentC

通过追踪号查询物流状态

get_insurance_ratesA

查询保险价格。根据保额和服务等级返回保险费率信息。

create_draft_shipmentA

标准下单流程第二步:创建运单草稿(不立即付款)。在 get_shipping_rates 之后、pay_shipment 之前调用。保存地址和包裹信息,等用户确认后再付款。

pay_shipmentB

对已选报价的运单进行支付,生成面单。可选附带保险信息。

void_labelB

退款/作废未使用的面单

search_ordersA

搜索订单列表,支持按状态、店铺、日期、关键词等筛选。当用户提供了类似 ID 的内容(如订单号、追踪号、订单ID等),必须通过 hybrid 参数传入进行搜索。

get_order_detailD

查看订单详细信息

create_orderA

手动创建订单。【重要】调用此接口前必须先准备好所有信息:1) 如果用户指定了地址簿ID,先调用 list_addresses 获取该地址的完整信息;2) 确认订单号、商品信息(名称、数量、单价)齐全;3) 缺少任何必填信息时必须先向用户询问,不得传空值调用接口。

buy_label_from_orderA

通过已有订单打单(购买面单)。当用户要对订单打单时,必须使用此工具,不得使用 create_draft_shipment + pay_shipment 流程。需要先通过 get_shipping_rates 获取 rate_id。

mark_order_shippedB

标记订单为已发货状态

cancel_orderC

取消订单

sync_store_ordersA

手动触发店铺订单同步。同步成功后,必须立即调用 search_orders(传入相同的 store_id,status 为 AWAITING)查询刚同步过来的订单并展示给用户。

get_order_tagsB

查询所有订单标签

list_addressesC

查询地址簿中的地址列表

create_addressB

在地址簿中新建地址

update_addressB

编辑/更新地址簿中已有的地址

validate_addressB

验证地址是否合法、可达

list_packagesC

查询已保存的包裹模板列表

list_predefined_packagesA

查询承运商预定义包裹列表。返回按承运商分组的预定义包裹,包含尺寸和重量信息。用户发货时可通过 carrier_package_id 直接引用预定义包裹,无需手动填写尺寸。

create_packageC

创建包裹模板,方便下次快速使用

list_carriersA

查询已连接的承运商账户列表

get_service_levelsC

查询客户生效中的承运商服务级别

list_storesA

查询已连接的电商店铺列表

get_total_savingsC

查看使用 ShipSaving 节省的总金额

get_shipping_analysisA

按时间维度分析运费数据。调用前必须先询问用户选择时间范围,可选值:the_last_7_days(近7天)、the_last_30_days(近30天)、this_month(本月)、last_month(上月)、current_year(今年)、last_year(去年)。

get_wallet_infoA

查询钱包余额信息

get_transaction_historyC

查询交易记录

Prompts

Interactive templates invoked by user choice

NameDescription
create-order-workflow引导完成下单工作流:查询运费 → 创建草稿运单 → 支付

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/waka4674/shipsaving-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server