English Français العربية

ShipSaving

Official registry E-commerce

MCP server for ShipSaving — shipping rates, labels, orders, tracking

Source code Documentation

What can you do with ShipSaving?

  • 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

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package shipsaving-mcp
Claude Code 
claude mcp add shipsaving -e 'SHIPSAVING_APP_KEY=<your shipsaving_app_key>' -e 'SHIPSAVING_API_BASE_URL=https://app-gateway.shipsaving.com' -- npx -y shipsaving-mcp@1.0.4
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "shipsaving": {
            "command": "npx",
            "args": [
                "-y",
                "shipsaving-mcp@1.0.4"
            ],
            "env": {
                "SHIPSAVING_APP_KEY": "<your shipsaving_app_key>",
                "SHIPSAVING_API_BASE_URL": "https://app-gateway.shipsaving.com"
            }
        }
    }
}

Environment variables

  • SHIPSAVING_APP_KEY required secret ShipSaving API key (starts with sk_)
  • SHIPSAVING_API_BASE_URL API base URL

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. ShipSaving MCP Server
  2. Features
  3. Quick Start
  4. Available Tools
  5. Usage Examples
  6. Environment Variables
  7. Development
  8. Troubleshooting
  9. License

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)
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
ToolDescription
get_shipping_ratesCompare rates across multiple carriers, marks cheapest & fastest
create_draft_shipmentCreate a draft shipment (no payment yet)
pay_shipmentPay for shipment and generate label
void_labelVoid/refund an unused label
search_shipmentsSearch shipments by various criteria
get_shipment_detailGet detailed shipment information
track_shipmentTrack package by tracking number
get_insurance_ratesQuery shipping insurance rates
Order Management
ToolDescription
search_ordersSearch orders by status, store, date, keywords
get_order_detailGet order details
create_orderManually create an order
buy_label_from_orderPurchase a label for an existing order
mark_order_shippedMark order as shipped
cancel_orderCancel an order
sync_store_ordersTrigger store order sync
get_order_tagsList all order tags
Address Book
ToolDescription
list_addressesQuery address book entries
create_addressAdd a new address
update_addressUpdate an existing address
validate_addressValidate address deliverability
Package Templates
ToolDescription
list_packagesList saved package templates
list_predefined_packagesList carrier-provided package types
create_packageCreate a reusable package template
Carriers & Stores
ToolDescription
list_carriersList connected carrier accounts
get_service_levelsQuery available service levels per carrier
list_storesList connected e-commerce stores
Analytics & Billing
ToolDescription
get_total_savingsView total savings with ShipSaving
get_shipping_analysisAnalyze shipping data over time
get_wallet_infoQuery wallet balance
get_transaction_historyQuery transaction records

Usage Examples

Compare shipping rates:

Compare rates from ZIP 90001 to 10001 for a 10x8x6 inch, 2 lb package

Ship a package:

Ship from John Smith, 123 Main St, Los Angeles, CA 90001
to Jane Doe, 456 Park Ave, New York, NY 10001
Package: 10x8x6 inches, 2 lbs, choose cheapest option

Bulk label printing:

Sync my Shopify orders, then print labels for all pending orders
using 6x6x6 inch boxes, 1 lb each, cheapest carrier, no insurance

Track a package:

Track package 1Z999AA10123456784

Environment Variables

VariableRequiredDefaultDescription
SHIPSAVING_APP_KEYYes—ShipSaving App Key (sk_ prefix)
SHIPSAVING_API_BASE_URLNohttps://app-gateway.shipsaving.comAPI base URL
SHIPSAVING_TIMEOUT_MSNo60000Request timeout in milliseconds
SHIPSAVING_LOG_FILENo—Path to log file (logs go to stderr by default)

Development

# Install dependencies
npm install

# Build
npm run build

# Watch mode
npm run dev

# Debug with MCP Inspector
SHIPSAVING_API_BASE_URL=https://app-gateway.shipsaving.com \
SHIPSAVING_APP_KEY=sk_your_app_key \
npx @modelcontextprotocol/inspector node dist/index.js

Troubleshooting

"command not found" — Install Node.js 18+: nodejs.org

"Failed to connect" — Try running the server manually to see error output:

SHIPSAVING_APP_KEY=sk_your_app_key npx -y shipsaving-mcp

If it hangs (waiting for input), the server started successfully. If it errors immediately, you'll see the issue.

To clear the npx cache:

rm -rf ~/.npm/_npx

License

MIT

Frequently asked questions

What is ShipSaving?

MCP server for ShipSaving — shipping rates, labels, orders, tracking

How do I install ShipSaving?

It runs on your machine. In Claude Code: claude mcp add shipsaving -e 'SHIPSAVING_APP_KEY=<your shipsaving_app_key>' -e 'SHIPSAVING_API_BASE_URL=https://app-gateway.shipsaving.com' -- npx -y shipsaving-mcp@1.0.4. For other clients, paste the JSON configuration from this page into their MCP settings.

Does ShipSaving need an API key?

Yes. It expects SHIPSAVING_APP_KEY, which you set in its configuration.

Is ShipSaving open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains ShipSaving?

It is published by waka4674. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.