@shippo/shippo-mcp 0.8.39 → 0.8.48

package/bin/mcp-server.js

@@ -46623,9 +46623,9 @@ var init_config = __esm(() => {
   SDK_METADATA = {
     language: "typescript",
     openapiDocVersion: "2018-02-08",
-    sdkVersion: "0.8.39",
+    sdkVersion: "0.8.48",
     genVersion: "2.770.0",
-    userAgent: "speakeasy-sdk/mcp-typescript 0.8.39 2.770.0 2018-02-08 @shippo/shippo-mcp"
+    userAgent: "speakeasy-sdk/mcp-typescript 0.8.48 2.770.0 2018-02-08 @shippo/shippo-mcp"
   };
 });
 
@@ -49968,7 +49968,17 @@ var init_batchesCreate2 = __esm(() => {
     name: "batches-create",
     description: `Create a batch
 
-Creates a new batch object for purchasing shipping labels for many shipments at once. Batches are created asynchronously. This means that the API response won't include your batch shipments yet. You need to retrieve the batch later to verify that all batch shipments are valid.`,
+Creates a new batch object for purchasing shipping labels for many shipments at once. Batches are created asynchronously. This means that the API response won't include your batch shipments yet. You need to retrieve the batch later to verify that all batch shipments are valid.
+
+**IMPORTANT: There is NO batches-list endpoint in the Shippo API.**
+You must store the batch \`object_id\` returned from this endpoint to retrieve batches later using \`batches-get\`.
+
+**Workflow:**
+1. Create batch → Save the returned \`object_id\`
+2. Retrieve batch status using \`batches-get\` with the saved ID
+3. Add/remove shipments as needed
+4. Purchase the batch when ready
+`,
     annotations: {
       title: "",
       destructiveHint: false,
@@ -50113,10 +50123,16 @@ var init_batchesGet2 = __esm(() => {
     name: "batches-get",
     description: `Retrieve a batch
 
-Returns a batch using an object ID. <br> Batch shipments are displayed 100 at a time.  You can iterate 
-through each \`page\` using the \`?page= query\` parameter.  You can also filter based on batch shipment 
-status, for example, by passing a query param like \`?object_results=creation_failed\`. <br> 
-For more details on filtering results, see our guide on <a href="https://docs.goshippo.com/docs/api_concepts/filtering/" target="blank"> filtering</a>.`,
+Returns a batch using an object ID. Batch shipments are displayed 100 at a time. You can iterate through each \`page\` using the \`?page=\` query parameter. You can also filter based on batch shipment status, for example, by passing a query param like \`?object_results=creation_failed\`.
+
+**IMPORTANT: There is NO batches-list endpoint in the Shippo API.**
+You must know the batch \`object_id\` (returned when you created the batch) to retrieve it.
+Store batch IDs when creating batches if you need to access them later.
+
+**URL HANDLING:** This response contains \`label_url\` (array of download URLs).
+When displaying URLs, ALWAYS show the complete URL without truncation.
+Never replace parts with "..." - S3 signed URLs will break if truncated.
+`,
     annotations: {
       title: "",
       destructiveHint: false,
@@ -53614,15 +53630,22 @@ var init_manifestsGet2 = __esm(() => {
   };
   tool$manifestsGet = {
     name: "manifests-get",
-    description: `Retrieve a manifest
-
-Returns an existing manifest using an object ID.`,
+    description: `Returns an existing manifest using an object ID.
+
+**⚠️ URL HANDLING - CRITICAL:**
+The manifest contains a \`documents\` field with URLs to scan form PDFs.
+When displaying these URLs:
+- ALWAYS show the COMPLETE URL - NEVER truncate or replace parts with "..."
+- These are S3 signed URLs that break if modified
+- Display URLs in a code block AND as a clickable hyperlink
+`,
+    scopes: ["read"],
     annotations: {
       title: "",
       destructiveHint: false,
       idempotentHint: false,
       openWorldHint: false,
-      readOnlyHint: true
+      readOnlyHint: false
     },
     args: args26,
     tool: async (client, args27, ctx) => {
@@ -53766,15 +53789,22 @@ var init_manifestsList2 = __esm(() => {
   };
   tool$manifestsList = {
     name: "manifests-list",
-    description: `List all manifests
-
-Returns a list of all manifest objects.`,
+    description: `Returns a list of all manifest objects.
+
+**⚠️ URL HANDLING - CRITICAL:**
+Each manifest contains a \`documents\` field with URLs to scan form PDFs.
+When displaying these URLs:
+- ALWAYS show the COMPLETE URL - NEVER truncate or replace parts with "..."
+- These are S3 signed URLs that break if modified
+- Display URLs in a code block AND as a clickable hyperlink
+`,
+    scopes: ["read"],
     annotations: {
       title: "",
       destructiveHint: false,
       idempotentHint: false,
       openWorldHint: false,
-      readOnlyHint: true
+      readOnlyHint: false
     },
     args: args27,
     tool: async (client, args28, ctx) => {
@@ -53853,35 +53883,59 @@ var init_orderstatusenum = __esm(() => {
 });
 
 // src/models/order.ts
-var OrderTransaction$zodSchema, Order$zodSchema;
+var OrderAddressFrom$zodSchema, OrderTransaction$zodSchema, Order$zodSchema;
 var init_order = __esm(() => {
   init_zod();
   init_address();
+  init_addressvalidationresults();
   init_lineitem();
   init_ordershopappenum();
   init_orderstatusenum();
   init_weightunitenum();
+  OrderAddressFrom$zodSchema = objectType({
+    city: stringType().optional(),
+    company: stringType().optional(),
+    country: stringType(),
+    email: stringType().optional(),
+    is_complete: booleanType().optional(),
+    is_residential: booleanType().nullable().optional(),
+    metadata: stringType().optional(),
+    name: stringType().optional(),
+    object_created: stringType().datetime({ offset: true }).optional(),
+    object_id: stringType().optional(),
+    object_owner: stringType().optional(),
+    object_updated: stringType().datetime({ offset: true }).optional(),
+    phone: stringType().optional(),
+    state: stringType().optional(),
+    street1: stringType().optional(),
+    street2: stringType().optional(),
+    street3: stringType().optional(),
+    street_no: stringType().optional(),
+    test: booleanType().nullable().optional(),
+    validation_results: AddressValidationResults$zodSchema.optional(),
+    zip: stringType().optional()
+  }).describe('<a href="#tag/Addresses">Address</a> object of the sender / seller. Will be returned expanded by default.');
   OrderTransaction$zodSchema = objectType({});
   Order$zodSchema = objectType({
-    currency: stringType().optional(),
-    from_address: Address$zodSchema.optional(),
+    currency: stringType().nullable().optional(),
+    from_address: lazyType(() => OrderAddressFrom$zodSchema).nullable().optional(),
     line_items: arrayType(LineItem$zodSchema).optional(),
-    notes: stringType().optional(),
+    notes: stringType().nullable().optional(),
     object_id: stringType().optional(),
     object_owner: stringType().optional(),
-    order_number: stringType().optional(),
+    order_number: stringType().nullable().optional(),
     order_status: OrderStatusEnum$zodSchema.optional(),
     placed_at: stringType(),
-    shipping_cost: stringType().optional(),
-    shipping_cost_currency: stringType().optional(),
-    shipping_method: stringType().optional(),
+    shipping_cost: stringType().nullable().optional(),
+    shipping_cost_currency: stringType().nullable().optional(),
+    shipping_method: stringType().nullable().optional(),
     shop_app: OrderShopAppEnum$zodSchema.optional(),
-    subtotal_price: stringType().optional(),
+    subtotal_price: stringType().nullable().optional(),
     to_address: Address$zodSchema,
-    total_price: stringType().optional(),
-    total_tax: stringType().optional(),
+    total_price: stringType().nullable().optional(),
+    total_tax: stringType().nullable().optional(),
     transactions: arrayType(lazyType(() => OrderTransaction$zodSchema)).optional(),
-    weight: stringType().optional(),
+    weight: stringType().nullable().optional(),
     weight_unit: WeightUnitEnum$zodSchema.optional()
   });
 });
@@ -53933,21 +53987,21 @@ var init_ordercreaterequest = __esm(() => {
   init_orderstatusenum();
   init_weightunitenum();
   OrderCreateRequest$zodSchema = objectType({
-    currency: stringType().optional(),
+    currency: stringType().nullable().optional(),
     from_address: AddressCreateRequest$zodSchema.optional(),
     line_items: arrayType(LineItemBase$zodSchema).optional(),
-    notes: stringType().optional(),
-    order_number: stringType().optional(),
+    notes: stringType().nullable().optional(),
+    order_number: stringType().nullable().optional(),
     order_status: OrderStatusEnum$zodSchema.optional(),
     placed_at: stringType(),
-    shipping_cost: stringType().optional(),
-    shipping_cost_currency: stringType().optional(),
-    shipping_method: stringType().optional(),
-    subtotal_price: stringType().optional(),
+    shipping_cost: stringType().nullable().optional(),
+    shipping_cost_currency: stringType().nullable().optional(),
+    shipping_method: stringType().nullable().optional(),
+    subtotal_price: stringType().nullable().optional(),
     to_address: AddressCreateRequest$zodSchema,
-    total_price: stringType().optional(),
-    total_tax: stringType().optional(),
-    weight: stringType().optional(),
+    total_price: stringType().nullable().optional(),
+    total_tax: stringType().nullable().optional(),
+    weight: stringType().nullable().optional(),
     weight_unit: WeightUnitEnum$zodSchema.optional()
   });
 });
@@ -58842,6 +58896,11 @@ not the actual carrier names like 'USPS', 'UPS', 'FedEx', etc.
 \`\`\`
 
 The API will return an error if you use real carrier names with test tokens.
+
+**⚠️ URL HANDLING - CRITICAL:**
+The response may include tracking URLs. When displaying any URLs:
+- ALWAYS show the COMPLETE URL - NEVER truncate or replace parts with "..."
+- Display URLs in a code block AND as a clickable hyperlink
 `,
     scopes: ["read", "tracking"],
     annotations: {
@@ -59147,6 +59206,18 @@ First create a shipment to get rates, then use this tool with the rate ID.
 - \`QUEUED\` → Processing (keep polling)
 - \`SUCCESS\` → ✅ Label ready! Check label_url and tracking_number
 - \`ERROR\` → ❌ Check messages for details
+
+**⚠️ URL HANDLING - CRITICAL:**
+When transaction succeeds, the response includes:
+- \`label_url\`: S3 signed URL for shipping label download
+- \`qr_code_url\`: QR code image URL (if requested)
+- \`tracking_url_provider\`: Carrier's tracking page URL
+
+**When displaying these URLs:**
+- ALWAYS show the COMPLETE URL - NEVER truncate or replace parts with "..."
+- S3 signed URLs contain required query parameters (Signature, Expires, AWSAccessKeyId)
+- Truncating these URLs will make them non-functional
+- Display URLs in a code block AND as a clickable hyperlink
 `,
     scopes: ["write"],
     annotations: {
@@ -59314,6 +59385,13 @@ var init_transactionsGet2 = __esm(() => {
 
 **Required Parameter:**
 - \`TransactionId\`: The transaction object ID from transaction creation
+
+**⚠️ URL HANDLING - CRITICAL:**
+When displaying URLs from this response (label_url, qr_code_url, tracking_url_provider):
+- ALWAYS show the COMPLETE URL - NEVER truncate or replace parts with "..."
+- These are S3 signed URLs with required query parameters (Signature, Expires, AWSAccessKeyId)
+- Truncating these URLs will make them non-functional
+- Display URLs in a code block AND as a clickable hyperlink
 `,
     scopes: ["read"],
     annotations: {
@@ -59505,6 +59583,13 @@ This tool lists transaction objects, which represent purchased shipping labels.
 
 **Note on Test Mode:**
 Test transactions will always show \`tracking_status: "UNKNOWN"\` because they don't receive real carrier tracking updates.
+
+**⚠️ URL HANDLING - CRITICAL:**
+Each transaction may include URLs (label_url, qr_code_url, tracking_url_provider).
+When displaying these URLs:
+- ALWAYS show the COMPLETE URL - NEVER truncate or replace parts with "..."
+- These are S3 signed URLs that break if modified
+- Display URLs in a code block AND as a clickable hyperlink
 `,
     scopes: ["read"],
     annotations: {
@@ -61062,7 +61147,7 @@ Updates an existing webhook using the webhook object ID.`,
 function createMCPServer(deps) {
   const server = new McpServer({
     name: "ShippoSDK",
-    version: "0.8.39"
+    version: "0.8.48"
   });
   const getClient = deps.getSDK || (() => new ShippoSDKCore({
     security: deps.security,
@@ -62454,7 +62539,7 @@ var routes = ln({
 var app = _e(routes, {
   name: "mcp",
   versionInfo: {
-    currentVersion: "0.8.39"
+    currentVersion: "0.8.48"
   }
 });
 Yt(app, process3.argv.slice(2), buildContext(process3));
@@ -62462,5 +62547,5 @@ export {
   app
 };
 
-//# debugId=2953EB7A367B100264756E2164756E21
+//# debugId=664682E46076BBF464756E2164756E21
 //# sourceMappingURL=mcp-server.js.map