English Français العربية

ShipSaving

السجل الرسمي التجارة الإلكترونية

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

الشيفرة المصدرية التوثيق

ماذا يمكنك أن تفعل مع 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

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

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 (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"
            }
        }
    }
}

متغيرات البيئة

  • SHIPSAVING_APP_KEY إلزامي سري ShipSaving API key (starts with sk_)
  • SHIPSAVING_API_BASE_URL API base URL

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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

الأسئلة الشائعة

ما هو ShipSaving؟

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

كيف أثبّت ShipSaving؟

يعمل على جهازك. في 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 من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج ShipSaving إلى مفتاح API؟

نعم. يتطلب SHIPSAVING_APP_KEY، وتضبطها في إعداداته.

هل ShipSaving مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون ShipSaving؟

ينشره waka4674. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.