# Shipi

Manage shipping workflows by creating labels, tracking packages, and scheduling carrier pickups. Compare live rates from major carriers like FedEx and UPS to optimize costs for every shipment. Organi…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y smithery mcp add shipi/shipi

# Browse available tools
npx -y smithery tool list shipi/shipi

# Get full schema for a tool
npx -y smithery tool get shipi/shipi list_shipments

# Call a tool
npx -y smithery tool call shipi/shipi list_shipments '{}'
```

## Direct MCP Connection

Endpoint: `https://shipi--shipi.run.tools`

**Optional config:**
- `integration_key` (query) — Your Shipi integration key. Find it at app.myshipi.com → Settings → Integration Key

## Tools (18)

- `list_shipments` — List shipments with pagination and filters. Filter by status (new/created/delivered), carrier, or date range.
- `get_shipment` — Get detailed information about a specific shipment by ID or order ID. Includes shipper, recipient, products, tracking, …
- `search_shipments` — Search shipments by order ID or tracking number. Returns matching shipments.
- `create_shipment` — Create a shipping label. Requires carrier account, shipper/recipient addresses, and product details. Returns tracking n…
- `cancel_shipment` — Cancel a shipment and void its label. Requires the shipment ID (del_ref).
- `get_shipping_rates` — Get live shipping rates from all configured carriers. Provide recipient address and package details to compare prices a…
- `schedule_pickup` — Schedule a carrier pickup for a shipment. The carrier will come to the shipper address to collect the package.
- `track_shipment` — Get a tracking URL for a shipment. Supports auto-detection of carrier from tracking number format.
- `fetch_labels` — Fetch shipping labels for printing. Filter by printed/unprinted status. Returns label URLs.
- `list_addresses` — List all saved addresses from the address book. Filter by type (shipper/receiver).
- `get_address` — Get a specific address by ID from the address book.
- `add_address` — Add a new address to the address book. Used for saving shipper or receiver addresses for reuse.
- `edit_address` — Update an existing address in the address book. Only changed fields need to be provided.
- `delete_address` — Delete an address from the address book by ID.
- `list_carriers` — List all configured shipping carrier accounts. Shows carrier type, primary status, and shipper address. Credentials are…
- `get_carrier` — Get details of a specific carrier account by ID. Returns carrier type and shipper address info.
- `get_account_info` — Get Shipi account information including user details, store info, billing/balance, plan, and feature flags.
- `get_shipping_stats` — Get shipping statistics and analytics. View shipment counts, cost breakdowns, carrier usage, tracking status, and daily…

```bash
# Get full input/output schema for a tool
npx -y smithery tool get shipi/shipi <tool-name>
```
