@shippo/shippo-mcp 0.8.43 → 0.8.48

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (44) hide show
  1. package/bin/mcp-server.js +62 -13
  2. package/bin/mcp-server.js.map +13 -13
  3. package/esm/funcs/batchesGet.d.ts +4 -0
  4. package/esm/funcs/batchesGet.d.ts.map +1 -1
  5. package/esm/funcs/batchesGet.js +4 -0
  6. package/esm/funcs/batchesGet.js.map +1 -1
  7. package/esm/lib/config.d.ts +2 -2
  8. package/esm/lib/config.js +2 -2
  9. package/esm/mcp-server/mcp-server.js +1 -1
  10. package/esm/mcp-server/server.js +1 -1
  11. package/esm/mcp-server/tools/batchesGet.d.ts.map +1 -1
  12. package/esm/mcp-server/tools/batchesGet.js +4 -0
  13. package/esm/mcp-server/tools/batchesGet.js.map +1 -1
  14. package/esm/mcp-server/tools/manifestsGet.d.ts.map +1 -1
  15. package/esm/mcp-server/tools/manifestsGet.js +10 -3
  16. package/esm/mcp-server/tools/manifestsGet.js.map +1 -1
  17. package/esm/mcp-server/tools/manifestsList.d.ts.map +1 -1
  18. package/esm/mcp-server/tools/manifestsList.js +10 -3
  19. package/esm/mcp-server/tools/manifestsList.js.map +1 -1
  20. package/esm/mcp-server/tools/trackingStatusGet.d.ts.map +1 -1
  21. package/esm/mcp-server/tools/trackingStatusGet.js +5 -0
  22. package/esm/mcp-server/tools/trackingStatusGet.js.map +1 -1
  23. package/esm/mcp-server/tools/transactionsCreate.d.ts.map +1 -1
  24. package/esm/mcp-server/tools/transactionsCreate.js +12 -0
  25. package/esm/mcp-server/tools/transactionsCreate.js.map +1 -1
  26. package/esm/mcp-server/tools/transactionsGet.d.ts.map +1 -1
  27. package/esm/mcp-server/tools/transactionsGet.js +7 -0
  28. package/esm/mcp-server/tools/transactionsGet.js.map +1 -1
  29. package/esm/mcp-server/tools/transactionsList.d.ts.map +1 -1
  30. package/esm/mcp-server/tools/transactionsList.js +7 -0
  31. package/esm/mcp-server/tools/transactionsList.js.map +1 -1
  32. package/manifest.json +8 -8
  33. package/package.json +1 -1
  34. package/src/funcs/batchesGet.ts +4 -0
  35. package/src/lib/config.ts +2 -2
  36. package/src/mcp-server/mcp-server.ts +1 -1
  37. package/src/mcp-server/server.ts +1 -1
  38. package/src/mcp-server/tools/batchesGet.ts +4 -0
  39. package/src/mcp-server/tools/manifestsGet.ts +10 -3
  40. package/src/mcp-server/tools/manifestsList.ts +10 -3
  41. package/src/mcp-server/tools/trackingStatusGet.ts +5 -0
  42. package/src/mcp-server/tools/transactionsCreate.ts +12 -0
  43. package/src/mcp-server/tools/transactionsGet.ts +7 -0
  44. package/src/mcp-server/tools/transactionsList.ts +7 -0
package/bin/mcp-server.js CHANGED
@@ -46623,9 +46623,9 @@ var init_config = __esm(() => {
46623
46623
  SDK_METADATA = {
46624
46624
  language: "typescript",
46625
46625
  openapiDocVersion: "2018-02-08",
46626
- sdkVersion: "0.8.43",
46626
+ sdkVersion: "0.8.48",
46627
46627
  genVersion: "2.770.0",
46628
- userAgent: "speakeasy-sdk/mcp-typescript 0.8.43 2.770.0 2018-02-08 @shippo/shippo-mcp"
46628
+ userAgent: "speakeasy-sdk/mcp-typescript 0.8.48 2.770.0 2018-02-08 @shippo/shippo-mcp"
46629
46629
  };
46630
46630
  });
46631
46631
 
@@ -50128,6 +50128,10 @@ Returns a batch using an object ID. Batch shipments are displayed 100 at a time.
50128
50128
  **IMPORTANT: There is NO batches-list endpoint in the Shippo API.**
50129
50129
  You must know the batch \`object_id\` (returned when you created the batch) to retrieve it.
50130
50130
  Store batch IDs when creating batches if you need to access them later.
50131
+
50132
+ **URL HANDLING:** This response contains \`label_url\` (array of download URLs).
50133
+ When displaying URLs, ALWAYS show the complete URL without truncation.
50134
+ Never replace parts with "..." - S3 signed URLs will break if truncated.
50131
50135
  `,
50132
50136
  annotations: {
50133
50137
  title: "",
@@ -53626,15 +53630,22 @@ var init_manifestsGet2 = __esm(() => {
53626
53630
  };
53627
53631
  tool$manifestsGet = {
53628
53632
  name: "manifests-get",
53629
- description: `Retrieve a manifest
53630
-
53631
- Returns an existing manifest using an object ID.`,
53633
+ description: `Returns an existing manifest using an object ID.
53634
+
53635
+ **⚠️ URL HANDLING - CRITICAL:**
53636
+ The manifest contains a \`documents\` field with URLs to scan form PDFs.
53637
+ When displaying these URLs:
53638
+ - ALWAYS show the COMPLETE URL - NEVER truncate or replace parts with "..."
53639
+ - These are S3 signed URLs that break if modified
53640
+ - Display URLs in a code block AND as a clickable hyperlink
53641
+ `,
53642
+ scopes: ["read"],
53632
53643
  annotations: {
53633
53644
  title: "",
53634
53645
  destructiveHint: false,
53635
53646
  idempotentHint: false,
53636
53647
  openWorldHint: false,
53637
- readOnlyHint: true
53648
+ readOnlyHint: false
53638
53649
  },
53639
53650
  args: args26,
53640
53651
  tool: async (client, args27, ctx) => {
@@ -53778,15 +53789,22 @@ var init_manifestsList2 = __esm(() => {
53778
53789
  };
53779
53790
  tool$manifestsList = {
53780
53791
  name: "manifests-list",
53781
- description: `List all manifests
53782
-
53783
- Returns a list of all manifest objects.`,
53792
+ description: `Returns a list of all manifest objects.
53793
+
53794
+ **⚠️ URL HANDLING - CRITICAL:**
53795
+ Each manifest contains a \`documents\` field with URLs to scan form PDFs.
53796
+ When displaying these URLs:
53797
+ - ALWAYS show the COMPLETE URL - NEVER truncate or replace parts with "..."
53798
+ - These are S3 signed URLs that break if modified
53799
+ - Display URLs in a code block AND as a clickable hyperlink
53800
+ `,
53801
+ scopes: ["read"],
53784
53802
  annotations: {
53785
53803
  title: "",
53786
53804
  destructiveHint: false,
53787
53805
  idempotentHint: false,
53788
53806
  openWorldHint: false,
53789
- readOnlyHint: true
53807
+ readOnlyHint: false
53790
53808
  },
53791
53809
  args: args27,
53792
53810
  tool: async (client, args28, ctx) => {
@@ -58878,6 +58896,11 @@ not the actual carrier names like 'USPS', 'UPS', 'FedEx', etc.
58878
58896
  \`\`\`
58879
58897
 
58880
58898
  The API will return an error if you use real carrier names with test tokens.
58899
+
58900
+ **⚠️ URL HANDLING - CRITICAL:**
58901
+ The response may include tracking URLs. When displaying any URLs:
58902
+ - ALWAYS show the COMPLETE URL - NEVER truncate or replace parts with "..."
58903
+ - Display URLs in a code block AND as a clickable hyperlink
58881
58904
  `,
58882
58905
  scopes: ["read", "tracking"],
58883
58906
  annotations: {
@@ -59183,6 +59206,18 @@ First create a shipment to get rates, then use this tool with the rate ID.
59183
59206
  - \`QUEUED\` → Processing (keep polling)
59184
59207
  - \`SUCCESS\` → ✅ Label ready! Check label_url and tracking_number
59185
59208
  - \`ERROR\` → ❌ Check messages for details
59209
+
59210
+ **⚠️ URL HANDLING - CRITICAL:**
59211
+ When transaction succeeds, the response includes:
59212
+ - \`label_url\`: S3 signed URL for shipping label download
59213
+ - \`qr_code_url\`: QR code image URL (if requested)
59214
+ - \`tracking_url_provider\`: Carrier's tracking page URL
59215
+
59216
+ **When displaying these URLs:**
59217
+ - ALWAYS show the COMPLETE URL - NEVER truncate or replace parts with "..."
59218
+ - S3 signed URLs contain required query parameters (Signature, Expires, AWSAccessKeyId)
59219
+ - Truncating these URLs will make them non-functional
59220
+ - Display URLs in a code block AND as a clickable hyperlink
59186
59221
  `,
59187
59222
  scopes: ["write"],
59188
59223
  annotations: {
@@ -59350,6 +59385,13 @@ var init_transactionsGet2 = __esm(() => {
59350
59385
 
59351
59386
  **Required Parameter:**
59352
59387
  - \`TransactionId\`: The transaction object ID from transaction creation
59388
+
59389
+ **⚠️ URL HANDLING - CRITICAL:**
59390
+ When displaying URLs from this response (label_url, qr_code_url, tracking_url_provider):
59391
+ - ALWAYS show the COMPLETE URL - NEVER truncate or replace parts with "..."
59392
+ - These are S3 signed URLs with required query parameters (Signature, Expires, AWSAccessKeyId)
59393
+ - Truncating these URLs will make them non-functional
59394
+ - Display URLs in a code block AND as a clickable hyperlink
59353
59395
  `,
59354
59396
  scopes: ["read"],
59355
59397
  annotations: {
@@ -59541,6 +59583,13 @@ This tool lists transaction objects, which represent purchased shipping labels.
59541
59583
 
59542
59584
  **Note on Test Mode:**
59543
59585
  Test transactions will always show \`tracking_status: "UNKNOWN"\` because they don't receive real carrier tracking updates.
59586
+
59587
+ **⚠️ URL HANDLING - CRITICAL:**
59588
+ Each transaction may include URLs (label_url, qr_code_url, tracking_url_provider).
59589
+ When displaying these URLs:
59590
+ - ALWAYS show the COMPLETE URL - NEVER truncate or replace parts with "..."
59591
+ - These are S3 signed URLs that break if modified
59592
+ - Display URLs in a code block AND as a clickable hyperlink
59544
59593
  `,
59545
59594
  scopes: ["read"],
59546
59595
  annotations: {
@@ -61098,7 +61147,7 @@ Updates an existing webhook using the webhook object ID.`,
61098
61147
  function createMCPServer(deps) {
61099
61148
  const server = new McpServer({
61100
61149
  name: "ShippoSDK",
61101
- version: "0.8.43"
61150
+ version: "0.8.48"
61102
61151
  });
61103
61152
  const getClient = deps.getSDK || (() => new ShippoSDKCore({
61104
61153
  security: deps.security,
@@ -62490,7 +62539,7 @@ var routes = ln({
62490
62539
  var app = _e(routes, {
62491
62540
  name: "mcp",
62492
62541
  versionInfo: {
62493
- currentVersion: "0.8.43"
62542
+ currentVersion: "0.8.48"
62494
62543
  }
62495
62544
  });
62496
62545
  Yt(app, process3.argv.slice(2), buildContext(process3));
@@ -62498,5 +62547,5 @@ export {
62498
62547
  app
62499
62548
  };
62500
62549
 
62501
- //# debugId=1F132A9300610C2A64756E2164756E21
62550
+ //# debugId=664682E46076BBF464756E2164756E21
62502
62551
  //# sourceMappingURL=mcp-server.js.map