ShipSaving

io.github.waka4674Published by GitHub account waka4674v1.0.4Updated Oct 24, 2026

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

The publisher's own server: ship.page

Overview

AI-generated overview

ShipSaving MCP server that lets an AI assistant compare shipping rates, buy and void labels, manage orders, addresses and packages, and track parcels.

What you can do
Compare multi-carrier rates, create draft shipments, pay for labels, void labels, search shipments and track packages, plus query insurance rates and service levels and list carriers and stores. Search, create, mark shipped, cancel and sync store orders, and buy labels from orders. Query, create, update and validate address book entries. List and create package templates and list predefined carrier packages. View savings, shipping cost analysis, wallet balance and transaction history.
When to use it
Useful when you run shipping through ShipSaving and want to compare rates, buy or void labels, process store orders and track parcels from a chat assistant instead of the web dashboard.
Requirements
Runs locally via npx, so Node.js 18 or newer is needed. A ShipSaving App Key is required in the SHIPSAVING_APP_KEY environment variable. Optional settings include SHIPSAVING_API_BASE_URL, SHIPSAVING_TIMEOUT_MS and SHIPSAVING_LOG_FILE. Network access to the ShipSaving API is required.
Before you install
The app key (SHIPSAVING_APP_KEY) is a secret that grants access to your ShipSaving account and wallet. Paying for shipments spends real money from the wallet, and voiding labels, cancelling orders, marking orders shipped and syncing store orders change live data. Address and order details are sent to the ShipSaving API.

Installation

In SourceWeft

  1. Open ShipSaving in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

ShipSaving MCP Server

[npm version] [License: MIT]

中文文档

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)

bash
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
json
{  "mcpServers": {    "shipsaving": {      "command": "npx",      "args": ["-y", "shipsaving-mcp"],      "env": {        "SHIPSAVING_APP_KEY": "sk_your_app_key"      }    }  }}

Restart Claude Desktop after saving.

Verify Installation

bash
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 90001to Jane Doe, 456 Park Ave, New York, NY 10001Package: 10x8x6 inches, 2 lbs, choose cheapest option

Bulk label printing:

Sync my Shopify orders, then print labels for all pending ordersusing 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

bash
# Install dependenciesnpm install
# Buildnpm run build
# Watch modenpm run dev
# Debug with MCP InspectorSHIPSAVING_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:

bash
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:

bash
rm -rf ~/.npm/_npx

License

MIT

Source: README.md at commit 11b51cb

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.4LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Ship integrations