@shippo/shippo-mcp 0.8.43 → 1.0.0

package/bin/mcp-server.js

@@ -46623,9 +46623,9 @@ var init_config = __esm(() => {
   SDK_METADATA = {
     language: "typescript",
     openapiDocVersion: "2018-02-08",
-    sdkVersion: "0.8.43",
-    genVersion: "2.770.0",
-    userAgent: "speakeasy-sdk/mcp-typescript 0.8.43 2.770.0 2018-02-08 @shippo/shippo-mcp"
+    sdkVersion: "1.0.0",
+    genVersion: "2.776.3",
+    userAgent: "speakeasy-sdk/mcp-typescript 1.0.0 2.776.3 2018-02-08 @shippo/shippo-mcp"
   };
 });
 
@@ -47555,7 +47555,8 @@ async function consumeSSE(value) {
   return content;
 }
 function createRegisterTool(logger, server, getSDK, allowedScopes, allowedTools) {
-  return (tool) => {
+  const tools = [];
+  const registerTool = (tool) => {
     if (allowedTools && !allowedTools.has(tool.name)) {
       return;
     }
@@ -47576,7 +47577,9 @@ function createRegisterTool(logger, server, getSDK, allowedScopes, allowedTools)
       });
     }
     logger.debug("Registered tool", { name: tool.name });
+    tools.push({ name: tool.name, description: tool.description });
   };
+  return [registerTool, tools];
 }
 var init_tools = __esm(() => {
   init_shared();
@@ -50128,6 +50131,10 @@ Returns a batch using an object ID. Batch shipments are displayed 100 at a time.
 **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: "",
@@ -53626,15 +53633,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) => {
@@ -53778,15 +53792,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) => {
@@ -58878,6 +58899,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: {
@@ -59183,6 +59209,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: {
@@ -59350,6 +59388,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: {
@@ -59541,6 +59586,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: {
@@ -61098,7 +61150,7 @@ Updates an existing webhook using the webhook object ID.`,
 function createMCPServer(deps) {
   const server = new McpServer({
     name: "ShippoSDK",
-    version: "0.8.43"
+    version: "1.0.0"
   });
   const getClient = deps.getSDK || (() => new ShippoSDKCore({
     security: deps.security,
@@ -61113,7 +61165,7 @@ function createMCPServer(deps) {
   }));
   const scopes = new Set(deps.scopes);
   const allowedTools = deps.allowedTools && new Set(deps.allowedTools);
-  const tool = createRegisterTool(deps.logger, server, getClient, scopes, allowedTools);
+  const [tool, tools] = createRegisterTool(deps.logger, server, getClient, scopes, allowedTools);
   const resource = createRegisterResource(deps.logger, server, getClient, scopes);
   const resourceTemplate = createRegisterResourceTemplate(deps.logger, server, getClient, scopes);
   const prompt = createRegisterPrompt(deps.logger, server, getClient, scopes);
@@ -61188,7 +61240,7 @@ function createMCPServer(deps) {
   tool(tool$webhooksGet);
   tool(tool$webhooksUpdate);
   tool(tool$webhooksDelete);
-  return server;
+  return { server, tools };
 }
 var init_server2 = __esm(() => {
   init_mcp();
@@ -61290,7 +61342,7 @@ async function main(flags) {
 async function startStdio(flags) {
   const logger = createConsoleLogger(flags["log-level"]);
   const transport = new StdioServerTransport;
-  const server = createMCPServer({
+  const { server } = createMCPServer({
     logger,
     allowedTools: flags.tool,
     scopes: flags.scope,
@@ -61310,7 +61362,7 @@ async function startStdio(flags) {
 async function startSSE(flags) {
   const logger = createConsoleLogger(flags["log-level"]);
   const app = import_express.default();
-  const mcpServer = createMCPServer({
+  const { server: mcpServer } = createMCPServer({
     logger,
     allowedTools: flags.tool,
     scopes: flags.scope,
@@ -62490,7 +62542,7 @@ var routes = ln({
 var app = _e(routes, {
   name: "mcp",
   versionInfo: {
-    currentVersion: "0.8.43"
+    currentVersion: "1.0.0"
   }
 });
 Yt(app, process3.argv.slice(2), buildContext(process3));
@@ -62498,5 +62550,5 @@ export {
   app
 };
 
-//# debugId=1F132A9300610C2A64756E2164756E21
+//# debugId=DCFEFD7CB5E16DF164756E2164756E21
 //# sourceMappingURL=mcp-server.js.map