@shippo/shippo-mcp 0.8.1 → 0.8.4

package/README.md

@@ -22,6 +22,7 @@ Shippo MCP Server: Use this MCP Server to integrate with the Shippo service usin
 * [<img src="https://docs.goshippo.com/images/Logo.png" width="30" alt="Shippo logo"> Shippo MCP Server](#img-srchttpsdocsgoshippocomimageslogopng-width30-altshippo-logo-shippo-mcp-server)
   * [Quick Start](#quick-start)
   * [Configuration](#configuration)
+  * [Updating](#updating)
   * [Features](#features)
   * [Security](#security)
   * [Contributions](#contributions)
@@ -198,6 +199,30 @@ Replace `/ABSOLUTE/PATH/TO/REPO` with the full path to your cloned repository.
 
 <!-- End Configuration [configuration] -->
 
+<!-- Start Updating [updating] -->
+
+## Updating
+
+The MCP server is distributed via npm. To ensure you have the latest features and bug fixes, update periodically.
+
+### Check Current Version
+
+```bash
+npx @shippo/shippo-mcp --version
+```
+
+### Update to Latest Version
+
+```bash
+npx clear-npx-cache
+```
+
+Next time you start your MCP client (Cursor, Claude), it will fetch the latest version.
+
+> **Tip:** After updating, toggle your MCP server off and on in Cursor/Claude settings for changes to take effect.
+
+<!-- End Updating [updating] -->
+
 <!-- Start Features [features] -->
 
 ## Features

package/bin/mcp-server.js

@@ -46623,9 +46623,9 @@ var init_config = __esm(() => {
   SDK_METADATA = {
     language: "typescript",
     openapiDocVersion: "2018-02-08",
-    sdkVersion: "0.1.9",
-    genVersion: "2.755.9",
-    userAgent: "speakeasy-sdk/mcp-typescript 0.1.9 2.755.9 2018-02-08 @wyatt-test/shippo-mcp"
+    sdkVersion: "0.8.4",
+    genVersion: "2.769.1",
+    userAgent: "speakeasy-sdk/mcp-typescript 0.8.4 2.769.1 2018-02-08 @shippo/shippo-mcp"
   };
 });
 
@@ -47796,8 +47796,9 @@ function match(...matchers) {
       const result = safeParse(data, (v2) => matcher.schema.parse(v2), "Response validation failed");
       return [result.ok ? { ok: false, error: result.value } : result, raw];
     } else {
+      const valueToParse = data;
       return [
-        safeParse(data, (v2) => matcher.schema.parse(v2), "Response validation failed"),
+        safeParse(valueToParse, (v2) => matcher.schema.parse(v2), "Response validation failed"),
         raw
       ];
     }
@@ -48681,14 +48682,14 @@ var init_batchshipment = __esm(() => {
     "TRANSACTION_FAILED"
   ]).describe("`INVALID` batch shipments cannot be purchased and will have to be removed, fixed, and added to the batch again.<br>\n" + "`VALID` batch shipments can be purchased. <br>\n" + "Batch shipments with the status `TRANSACTION_FAILED` were not able to be purchased and the error will be displayed on the message field<br> \n" + "`INCOMPLETE` batch shipments have an issue with the Address and will need to be removed, fixed, and added to the batch again.");
   BatchShipment$zodSchema = objectType({
-    carrier_account: stringType().optional(),
+    carrier_account: stringType().nullable().optional(),
     messages: arrayType(anyType()).optional(),
     metadata: stringType().optional(),
     object_id: stringType(),
-    servicelevel_token: stringType().optional(),
+    servicelevel_token: stringType().nullable().optional(),
     shipment: stringType(),
     status: BatchShipmentStatus$zodSchema,
-    transaction: stringType().optional()
+    transaction: stringType().nullable().optional()
   });
 });
 
@@ -49675,9 +49676,9 @@ var init_batchshipmentcreaterequest = __esm(() => {
   init_zod();
   init_shipmentcreaterequest();
   BatchShipmentCreateRequest$zodSchema = objectType({
-    carrier_account: stringType().optional(),
+    carrier_account: stringType().nullable().optional(),
     metadata: stringType().optional(),
-    servicelevel_token: stringType().optional(),
+    servicelevel_token: stringType().nullable().optional(),
     shipment: ShipmentCreateRequest$zodSchema
   });
 });
@@ -55683,7 +55684,7 @@ var init_rate = __esm(() => {
     currency: stringType(),
     currency_local: stringType(),
     duration_terms: stringType().optional(),
-    estimated_days: numberType().int().optional(),
+    estimated_days: numberType().int().nullable().optional(),
     included_insurance_price: stringType().nullable().optional(),
     messages: arrayType(ResponseMessage$zodSchema).optional(),
     object_created: stringType().datetime({ offset: true }),
@@ -57556,32 +57557,43 @@ var init_shipmentsList2 = __esm(() => {
   };
   tool$shipmentsList = {
     name: "shipments-list",
-    description: `List all shipments
-
-Returns a list of all shipment objects.<br><br>
-In order to filter results, you must use the below path parameters. 
-A maximum date range of 90 days is permitted. 
-Provided dates should be ISO 8601 UTC dates (timezone offsets are currently not supported).<br><br>
-
-Optional path parameters:<br>
-  \`object_created_gt\`- object(s) created greater than a provided date time<br>
-  \`object_created_gte\` - object(s) created greater than or equal to a provided date time<br>
-  \`object_created_lt\` - object(s) created less than a provided date time<br>
-  \`object_created_lte\` - object(s) created less than or equal to a provided date time<br>
-
-  Date format examples:<br>
-    \`2017-01-01\`<br>
-    \`2017-01-01T03:30:30\` or \`2017-01-01T03:30:30.5\`<br>
-    \`2017-01-01T03:30:30Z\`<br><br>
-
-  Example URL:<br>
-    \`https://api.goshippo.com/shipments/?object_created_gte=2017-01-01T00:00:30&object_created_lt=2017-04-01T00:00:30\``,
+    description: `**LIST SHIPMENTS (Rate Quotes)** - NOT for finding delivered packages!
+
+This tool lists shipment objects, which represent rate shopping sessions. Each shipment contains:
+- Sender/recipient addresses
+- Parcel dimensions
+- Available shipping rates from carriers
+
+**IMPORTANT DISTINCTIONS:**
+- Shipments = Rate quotes/shopping sessions
+- Shipments do NOT have tracking or delivery status
+- Use \`transactions-list\` to find purchased labels with tracking status
+
+**When to use this tool:**
+- List recent rate shopping sessions
+- Find a shipment to view its rates
+- Review shipment details before purchasing a label
+
+**When NOT to use this tool:**
+- ❌ Finding "delivered" shipments (use transactions-list instead)
+- ❌ Getting tracking information (use tracking-status-get)
+- ❌ Finding purchased labels (use transactions-list)
+
+**Available Filters:**
+- \`object_created_gt/gte/lt/lte\`: Filter by creation date
+- \`page/results\`: Pagination
+
+**Example Use Case:**
+"Show me shipments I created this week" → Use this tool
+"Show me delivered packages" → Use transactions-list with tracking_status filter
+`,
+    scopes: ["read"],
     annotations: {
       title: "",
       destructiveHint: false,
       idempotentHint: false,
       openWorldHint: false,
-      readOnlyHint: true
+      readOnlyHint: false
     },
     args: args50,
     tool: async (client, args51, ctx) => {
@@ -59357,15 +59369,46 @@ var init_transactionsList2 = __esm(() => {
   };
   tool$transactionsList = {
     name: "transactions-list",
-    description: `List all shipping labels
-
-Returns a list of all transaction objects.`,
+    description: `**LIST TRANSACTIONS (Purchased Labels)** - Use this for finding shipped/delivered packages!
+
+This tool lists transaction objects, which represent purchased shipping labels. Each transaction contains:
+- Tracking number and tracking URL
+- Label URL for printing
+- Tracking status (UNKNOWN, PRE_TRANSIT, TRANSIT, DELIVERED, RETURNED, FAILURE)
+- Purchase date and carrier info
+
+**IMPORTANT DISTINCTIONS:**
+- Transactions = Purchased shipping labels
+- Transactions HAVE tracking status and tracking numbers
+- Use \`shipments-list\` for rate quotes (unpurchased shipments)
+
+**When to use this tool:**
+- Find delivered packages → filter by \`tracking_status: "DELIVERED"\`
+- Find packages in transit → filter by \`tracking_status: "TRANSIT"\`
+- List all purchased labels
+- Find a specific label by rate ID
+
+**Available Filters:**
+- \`tracking_status\`: UNKNOWN, PRE_TRANSIT, TRANSIT, DELIVERED, RETURNED, FAILURE
+- \`object_status\`: WAITING, QUEUED, SUCCESS, ERROR, REFUNDED, REFUNDPENDING, REFUNDREJECTED
+- \`rate\`: Filter by rate ID
+- \`page/results\`: Pagination
+
+**Example Use Cases:**
+- "Show delivered shipments" → \`{tracking_status: "DELIVERED"}\`
+- "Show packages in transit" → \`{tracking_status: "TRANSIT"}\`
+- "Show all labels" → \`{results: 25}\`
+
+**Note on Test Mode:**
+Test transactions will always show \`tracking_status: "UNKNOWN"\` because they don't receive real carrier tracking updates.
+`,
+    scopes: ["read"],
     annotations: {
       title: "",
       destructiveHint: false,
       idempotentHint: false,
       openWorldHint: false,
-      readOnlyHint: true
+      readOnlyHint: false
     },
     args: args60,
     tool: async (client, args61, ctx) => {
@@ -60819,7 +60862,7 @@ Updates an existing webhook using the webhook object ID.`,
 function createMCPServer(deps) {
   const server = new McpServer({
     name: "ShippoSDK",
-    version: "0.1.9"
+    version: "0.8.4"
   });
   const getClient = deps.getSDK || (() => new ShippoSDKCore({
     security: deps.security,
@@ -62211,7 +62254,7 @@ var routes = ln({
 var app = _e(routes, {
   name: "mcp",
   versionInfo: {
-    currentVersion: "0.1.9"
+    currentVersion: "0.8.4"
   }
 });
 Yt(app, process3.argv.slice(2), buildContext(process3));
@@ -62219,5 +62262,5 @@ export {
   app
 };
 
-//# debugId=9C8096A93585DB7864756E2164756E21
+//# debugId=7AFC15D19A9C5A6364756E2164756E21
 //# sourceMappingURL=mcp-server.js.map