ShipSaving MCP Server

中文文档

An MCP (Model Context Protocol) server that wraps the ShipSaving logistics REST API, enabling AI assistants like Claude to perform shipping operations through natural language.

Features

• Shipment Management — Multi-carrier rate comparison, create shipments, pay & generate labels, void labels, track packages
• Order Management — Sync store orders, search, bulk label printing, mark as shipped, cancel
• Address Book — Query, create, and validate addresses
• Package Templates — Save and reuse package dimensions
• Carriers — List connected carrier accounts and available service levels
• Store Integration — List connected e-commerce stores (Shopify, etc.)
• Analytics — Total savings, shipping cost analysis
• Billing — Wallet balance, transaction history

Quick Start

Prerequisites

• Node.js 18+
• A ShipSaving App Key (get one at ShipSaving → Settings → API)

Install with Claude Code CLI (Recommended)

claude mcp add shipsaving \
  -e SHIPSAVING_APP_KEY=sk_your_app_key \
  -- npx -y shipsaving-mcp

Install with Claude Desktop

Edit your config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "shipsaving": {
      "command": "npx",
      "args": ["-y", "shipsaving-mcp"],
      "env": {
        "SHIPSAVING_APP_KEY": "sk_your_app_key"
      }
    }
  }
}

Restart Claude Desktop after saving.

Verify Installation

claude mcp list
# shipsaving should show status: Connected

Available Tools

Shipment Management

Tool	Description
get_shipping_rates	Compare rates across multiple carriers, marks cheapest & fastest
create_draft_shipment	Create a draft shipment (no payment yet)
pay_shipment	Pay for shipment and generate label
void_label	Void/refund an unused label
search_shipments	Search shipments by various criteria
get_shipment_detail	Get detailed shipment information
track_shipment	Track package by tracking number
get_insurance_rates	Query shipping insurance rates

Order Management

Tool	Description
search_orders	Search orders by status, store, date, keywords
get_order_detail	Get order details
create_order	Manually create an order
buy_label_from_order	Purchase a label for an existing order
mark_order_shipped	Mark order as shipped
cancel_order	Cancel an order
sync_store_orders	Trigger store order sync
get_order_tags	List all order tags

Address Book

Tool	Description
list_addresses	Query address book entries
create_address	Add a new address
validate_address	Validate address deliverability

Package Templates

Tool	Description
list_packages	List saved package templates
create_package	Create a reusable package template

Carriers & Stores

Tool	Description
list_carriers	List connected carrier accounts
get_service_levels	Query available service levels per carrier
list_stores	List connected e-commerce stores

Analytics & Billing

Tool	Description
get_total_savings	View total savings with ShipSaving
get_shipping_analysis	Analyze shipping data over time
get_wallet_info	Query wallet balance
get_transaction_history	Query transaction records

Usage Examples

Compare shipping rates:

Compa

... [View full README on GitHub](https://github.com/waka4674/shipsaving-mcp#readme)