Skip to content

Starshipit MCP by usefulapi

by usefulapi.io · remote · no sign-in to list tools · v1.3.3 · published by io.usefulapi

Read Starshipit orders, tracking, rates and manifests; create and update unshipped orders.

Deletes · 3Changes · 2

19 tools: 3 can delete or cancel things, 2 change things and 14 only read.

Scanned Oct 21, 2026

No check matched anything in the tool definitions. No finding is not a safety guarantee. How the checks work.

claude mcp add --transport http starshipit https://starshipit.usefulapi.io/mcp

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

19 tools

Deletes or cancels 3Claude Code: deny
  • starshipit_add_order_tagsWRITE: add up to 10 tags to ONE UNSHIPPED order (read first; refused if printed or shipped) (a tag that does not exist yet is created).No findings

    Why it is in this group

    • The name "starshipit_add_order_tags" says "add": a word for a change.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    WRITE: add up to 10 tags to ONE UNSHIPPED order (read first; refused if printed or shipped) (a tag that does not exist yet is created). Tags are used for filtering and can drive the account's automation rules. Adding a tag the order already has changes nothing. Tags are not removed. POST /api/tags/order.

    Annotations the server declares

    • title: Add tags to an order
    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
  • starshipit_create_orderWRITE: create ONE new UNSHIPPED order in Starshipit (order number, destination, optional items, parcels, sender).No findings

    Why it is in this group

    • The name "starshipit_create_order" says "create": a word for a change.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    WRITE: create ONE new UNSHIPPED order in Starshipit (order number, destination, optional items, parcels, sender). No label is printed, no shipment is booked and no postage is bought; staff still print the label in Starshipit. Not idempotent: creating the same order_number twice may create a duplicate, so check with starshipit_search_orders first. Starshipit rules configured in the account (carrier selection, validation) may run on the new order. POST /api/orders.

    Annotations the server declares

    • title: Create an unshipped order
    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
  • starshipit_update_orderWRITE: change details of ONE UNSHIPPED order by order_id (the order is read first and refused if it is already printed or shipped): addresses, shipping method/carrier/service, item…No findings

    Why it is in this group

    • The name "starshipit_update_order" says "update": a word for a change.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    WRITE: change details of ONE UNSHIPPED order by order_id (the order is read first and refused if it is already printed or shipped): addresses, shipping method/carrier/service, items, packages, reference or an internal note. This tool never sends status or manifest flags. It does not print a label or buy postage. Items/packages: include item_id / package_id (from starshipit_get_order with include=Items,Packages) to modify an existing line; a line without an id may be added. Nothing is deleted. Send only the fields you want to change. PUT /api/orders.

    Annotations the server declares

    • title: Update an order's details
    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
Changes things 2Claude Code: ask
  • starshipit_orders_summaryA compact list of orders in one status (new, printed, shipped, archived) with contact, country, carrier, weight, manifest and dates, plus account-wide counts (unprinted, printed, s…No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    A compact list of orders in one status (new, printed, shipped, archived) with contact, country, carrier, weight, manifest and dates, plus account-wide counts (unprinted, printed, shipped, archived, invalid addresses, returns). Supports filters and sorting. GET /api/orders/summary.

    Annotations the server declares

    • title: Orders summary
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
  • starshipit_track_shipmentTracking details for a shipped order, by tracking number or by order number: status, carrier, tracking URL, shipment date and the carrier's tracking events.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    Tracking details for a shipped order, by tracking number or by order number: status, carrier, tracking URL, shipment date and the carrier's tracking events. GET /api/track.

    Annotations the server declares

    • title: Track a shipment
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
Only reads 14Claude Code: allow
  • starshipit_get_orderOne order by Starshipit order_id or by the order_number from the source platform.No findings

    Why it is in this group

    • The name "starshipit_get_order" says "get": a word for reading.
    Description, as the server wrote it
    One order by Starshipit order_id or by the order_number from the source platform. Use include to add sections (Items, Packages, Events, Metadatas, Shipping_Price, ...). Status defaults to Unshipped in Starshipit, so pass status=Shipped or Printed for orders already printed. Label files are not returned. GET /api/orders?order_id= or ?order_number=.

    Annotations the server declares

    • title: Get order
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
  • starshipit_get_ratesQUOTE ONLY: shipping rates (service name, code, price) for a destination and parcels from the couriers enabled in the account.No findings

    Why it is in this group

    • The name "starshipit_get_rates" says "get": a word for reading.
    Description, as the server wrote it
    QUOTE ONLY: shipping rates (service name, code, price) for a destination and parcels from the couriers enabled in the account. Nothing is purchased, created or printed. The sender defaults to the account's pickup address. Needs at least one enabled courier. POST /api/rates.

    Annotations the server declares

    • title: Quote shipping rates
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
  • starshipit_list_address_bookList contacts in the account's address book (name, company, address, phone, email), sorted by a column.No findings

    Why it is in this group

    • The name "starshipit_list_address_book" says "list": a word for reading.
    Description, as the server wrote it
    List contacts in the account's address book (name, company, address, phone, email), sorted by a column. GET /api/addressbook/filtered.

    Annotations the server declares

    • title: List address book
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
  • starshipit_list_delivered_ordersList delivered orders that carry a given order reference (the customer reference), with full order details.No findings

    Why it is in this group

    • The name "starshipit_list_delivered_orders" says "list": a word for reading.
    Description, as the server wrote it
    List delivered orders that carry a given order reference (the customer reference), with full order details. GET /api/orders/delivered.

    Annotations the server declares

    • title: List delivered orders
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
  • starshipit_list_delivery_servicesQUOTE ONLY: the carrier delivery services available for a shipment (carrier, service name and code) and, with include_pricing, their prices and service options.No findings

    Why it is in this group

    • The name "starshipit_list_delivery_services" says "list": a word for reading.
    Description, as the server wrote it
    QUOTE ONLY: the carrier delivery services available for a shipment (carrier, service name and code) and, with include_pricing, their prices and service options. Nothing is purchased, created or printed. POST /api/deliveryservices.

    Annotations the server declares

    • title: List delivery services
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
  • starshipit_list_manifestsList manifests already submitted to carriers (newest first): number, date, carrier, package and consignment counts.No findings

    Why it is in this group

    • The name "starshipit_list_manifests" says "list": a word for reading.
    Description, as the server wrote it
    List manifests already submitted to carriers (newest first): number, date, carrier, package and consignment counts. Read only; manifesting is not available here. GET /api/manifests.

    Annotations the server declares

    • title: List manifests
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
  • starshipit_list_ordersList full order details for one status (Unshipped by default, or Shipped / Printed), narrowed by a filter such as `Order:::1419,Country:::Australia` and sorted.No findings

    Why it is in this group

    • The name "starshipit_list_orders" says "list": a word for reading.
    Description, as the server wrote it
    List full order details for one status (Unshipped by default, or Shipped / Printed), narrowed by a filter such as `Order:::1419,Country:::Australia` and sorted. Heavier than the summary: use starshipit_orders_summary for overviews. Label files are not returned. GET /api/orders (no id).

    Annotations the server declares

    • title: List orders
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
  • starshipit_list_pickupsList courier pickups already booked for the account.No findings

    Why it is in this group

    • The name "starshipit_list_pickups" says "list": a word for reading.
    Description, as the server wrote it
    List courier pickups already booked for the account. Read only; booking a pickup is not available here. GET /api/pickup.

    Annotations the server declares

    • title: List booked pickups
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
  • starshipit_list_printed_ordersList orders whose label was recently printed, or printed but not yet manifested, with tracking numbers.No findings

    Why it is in this group

    • The name "starshipit_list_printed_orders" says "list": a word for reading.
    Description, as the server wrote it
    List orders whose label was recently printed, or printed but not yet manifested, with tracking numbers. GET /api/orders/shipments.

    Annotations the server declares

    • title: List printed orders
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
  • starshipit_list_productsList Product Catalogue records (SKU, title, weight, dimensions, HS code, bin location, price), optionally searching by SKU or title.No findings

    Why it is in this group

    • The name "starshipit_list_products" says "list": a word for reading.
    Description, as the server wrote it
    List Product Catalogue records (SKU, title, weight, dimensions, HS code, bin location, price), optionally searching by SKU or title. GET /api/products.

    Annotations the server declares

    • title: List products
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
  • starshipit_list_shipped_ordersList shipped orders (label printed) with tracking number, tracking status, carrier, manifest and shipped date.No findings

    Why it is in this group

    • The name "starshipit_list_shipped_orders" says "list": a word for reading.
    Description, as the server wrote it
    List shipped orders (label printed) with tracking number, tracking status, carrier, manifest and shipped date. By default only orders updated in the last 24 hours; use since_last_updated to look further back. Label files are not returned. GET /api/orders/shipped.

    Annotations the server declares

    • title: List shipped orders
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
  • starshipit_list_tagsList the account's user-defined order tags, optionally filtered by tag name.No findings

    Why it is in this group

    • The name "starshipit_list_tags" says "list": a word for reading.
    Description, as the server wrote it
    List the account's user-defined order tags, optionally filtered by tag name. GET /api/tags.

    Annotations the server declares

    • title: List order tags
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
  • starshipit_list_unshipped_ordersList unshipped (new, not yet printed) orders with full details: addresses, items, packages, carrier.No findings

    Why it is in this group

    • The name "starshipit_list_unshipped_orders" says "list": a word for reading.
    Description, as the server wrote it
    List unshipped (new, not yet printed) orders with full details: addresses, items, packages, carrier. By default only orders updated in the last 24 hours; use since_order_date / since_last_updated to look further back. ids_only=true returns just the order ids. GET /api/orders/unshipped.

    Annotations the server declares

    • title: List unshipped orders
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
  • starshipit_search_ordersSearch orders by order number, tracking number, customer reference or recipient name (phrase), optionally limited to unshipped or shipped orders.No findings

    Why it is in this group

    • The name "starshipit_search_orders" says "search": a word for reading.
    Description, as the server wrote it
    Search orders by order number, tracking number, customer reference or recipient name (phrase), optionally limited to unshipped or shipped orders. Returns id, number, date, name, carrier, tracking number and country. GET /api/orders/search.

    Annotations the server declares

    • title: Search orders
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 1.3.3. Values in angle brackets are yours to fill in.

claude mcp add --transport http starshipit https://starshipit.usefulapi.io/mcp

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__starshipit__starshipit_list_unshipped_orders",
      "mcp__starshipit__starshipit_list_shipped_orders",
      "mcp__starshipit__starshipit_list_printed_orders",
      "mcp__starshipit__starshipit_list_delivered_orders",
      "mcp__starshipit__starshipit_search_orders",
      "mcp__starshipit__starshipit_get_order",
      "mcp__starshipit__starshipit_list_orders",
      "mcp__starshipit__starshipit_get_rates",
      "mcp__starshipit__starshipit_list_delivery_services",
      "mcp__starshipit__starshipit_list_address_book",
      "mcp__starshipit__starshipit_list_manifests",
      "mcp__starshipit__starshipit_list_products",
      "mcp__starshipit__starshipit_list_tags",
      "mcp__starshipit__starshipit_list_pickups"
    ],
    "ask": [
      "mcp__starshipit__starshipit_orders_summary",
      "mcp__starshipit__starshipit_track_shipment"
    ],
    "deny": [
      "mcp__starshipit__starshipit_create_order",
      "mcp__starshipit__starshipit_update_order",
      "mcp__starshipit__starshipit_add_order_tags"
    ]
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as starshipit. Review it before you use it.