# Starshipit — how to use (mcp.ai)

Connect your Starshipit account and use 15 tools for ecommerce straight from your AI agent. Connect with your own API key. Starshipit provides shipping, fulfilment, order, tracking, and warehouse management APIs for ecommerce operations.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_starshipit?ms=1787291400000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `starshipit_create_manifest`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/starshipit`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/starshipit/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/starshipit/create/manifest` — Create and finalize a Starshipit manifest PDF for only the explicitly listed shipments. WARNING: manifesting is an irreversible fulfilment operation that can mark shipments as manifested; verify every
  - body: { identifier_type?: string, shipment_numbers: string[] }
- `POST https://api.mcp.ai/api/starshipit/create/order` — Create one unshipped Starshipit order with destination, line items, packages, sender, and customs details.
  - body: { order: object }
- `POST https://api.mcp.ai/api/starshipit/create/shipping/label` — Create shipping labels for one Starshipit order. This also creates the shipment and its tracking numbers and is irreversible. Labels come back in the account's configured format, usually PDF.
  - body: { carrier: string, order_id?: integer, packages: object[], order_number?: string, carrier_service_code: string }
- `POST https://api.mcp.ai/api/starshipit/create/shipping/labels` — Create shipping labels for multiple existing Starshipit orders in one irreversible batch. This creates shipments and tracking numbers and can move orders to Printed. Starshipit does not document atomi
  - body: { order_ids: integer[] }
- `POST https://api.mcp.ai/api/starshipit/get/order` — Retrieve one order by its Starshipit numeric ID or source-platform order number.
  - body: { order_id?: integer, order_number?: string }
- `POST https://api.mcp.ai/api/starshipit/get/shipping/rates` — Quote available Starshipit shipping services and prices for a destination and one or more packages.
  - body: { sender?: object, currency?: string, packages: object[], destination: object }
- `POST https://api.mcp.ai/api/starshipit/get/tracking` — Get current shipment status and carrier tracking events by tracking number or order number.
  - body: { order_number?: string, tracking_number?: string }
- `POST https://api.mcp.ai/api/starshipit/get/wms/performance` — Return Starshipit WMS order-cycle and SLA performance metrics for the previous 1 to 90 days.
  - body: { days_back?: integer }
- `POST https://api.mcp.ai/api/starshipit/list/manifests` — Return one page of manifests in reverse chronological order.
  - body: { page?: integer, limit?: integer }
- `POST https://api.mcp.ai/api/starshipit/list/products` — Search and page through the Starshipit product catalogue with optional sorting.
  - body: { page_size?: integer, next_cursor?: string, search_term?: string, sort_column?: string, skip_records?: integer, sort_direction?: string }
- `POST https://api.mcp.ai/api/starshipit/list/tags` — Return one page of user-defined order tags, optionally filtered by tag name.
  - body: { filter?: string, page_size?: integer, next_cursor?: string }
- `POST https://api.mcp.ai/api/starshipit/list/unshipped/orders` — Return one page of unshipped orders, optionally limited to orders created or updated after a UTC timestamp.
  - body: { page?: integer, limit?: integer, ids_only?: boolean, since_order_date?: string, since_last_updated?: string }
- `POST https://api.mcp.ai/api/starshipit/list/wms/inventory` — Return one page of Starshipit WMS inventory grouped by product or location, including stock, reservation, and availability quantities.
  - body: { filter?: string, search?: string, sort_by?: string, client_id?: string, page_size?: integer, view_mode?: string, next_cursor?: string, product_type?: string, in_stock_only?: boolean, sort_direction?: string }
- `POST https://api.mcp.ai/api/starshipit/search/orders` — Search orders by a phrase and optional field, status, or child-account inclusion filter. Returns one page at a time.
  - body: { page?: integer, limit?: integer, fields?: string, phrase: string, status?: string, include_child_accounts?: boolean }
- `POST https://api.mcp.ai/api/starshipit/update/order` — Update editable fields on one Starshipit order identified by order_id or order_number. This sends one PUT request and does not read the order first. Unshipped orders permit updates to non-read-only fi
  - body: { order: object }

## Example prompts
- "What can I do in Starshipit?"
- "Show me a summary of my Starshipit account"

## More
- Page: https://mcp.ai/starshipit
- Agent spec (llms.txt): https://mcp.ai/starshipit/llms.txt
- Postman collection: https://mcp.ai/starshipit/postman.json