yungle-mcp 0.3.0 → 0.3.1

package/README.md

@@ -61,7 +61,7 @@ Or by hand:
 | `get_account`, `list_transfers`, `get_transfer`, `get_transfer_downloads`, `list_collections`, `get_collection`, `list_collection_files`, `list_folders`, `list_guests`, `list_contacts`, `list_upload_requests`, `get_upload_request` | read | Answer questions about your transfers, collections, contacts and upload requests |
 | `get_download_links` | read | Signed, resumable download URLs for a link someone shared (`/t/…`, `/c/…`) or your own transfer or collection |
 | `get_import_status` | write | How far the files Yungle is fetching from URLs have got |
-| `create_transfer` | read | Prepare a draft and get one keyless `npx yungle-cli put …` command per file, for an assistant with a shell |
+| `create_transfer` | write | Prepare a draft and get one keyless `npx yungle-cli put …` command per file, for an assistant with a shell |
 | `finalize_transfer` | write | Make a prepared draft a link. Emails nobody |
 | `share_from_urls` | write | Share files that are already online (a presigned S3 link, a CDN URL) — Yungle fetches them, so any size works, hosted too. Emails nobody |
 | `create_share_link` | write | Turn content the assistant has (up to 25 MB) into a link. Emails nobody |

package/dist/index.mjs

@@ -121,7 +121,7 @@ async function fetchTo(url, dest, size, doFetch) {
 }
 
 // src/server.ts
-var MCP_VERSION = true ? "0.3.0" : "dev";
+var MCP_VERSION = true ? "0.3.1" : "dev";
 function createServer(client, opts = { canWrite: false, canEmail: false, local: false }) {
   const server = new McpServer(
     { name: "yungle", version: MCP_VERSION },
@@ -359,60 +359,62 @@ function createServer(client, opts = { canWrite: false, canEmail: false, local:
       }
     );
   }
-  server.registerTool(
-    "create_transfer",
-    {
-      title: "Prepare a transfer",
-      description: [
-        "Prepare a draft transfer for files that live on a machine with a shell, and return one",
-        "upload command per file. Each command (`npx -y yungle-cli put \u2026`) needs no Yungle key: it",
-        "carries a token that can write only that file, for two hours, and it resumes if interrupted.",
-        "Nothing is shared and nobody is emailed until the transfer is finalized."
-      ].join("\n"),
-      inputSchema: {
-        files: z.array(
-          z.object({
-            name: z.string(),
-            size: z.number().int().nonnegative().describe("Exact byte size."),
-            path: z.string().optional().describe("Folder within the upload."),
-            localPath: z.string().optional().describe("Where the file is on the machine that will run the command.")
-          })
-        ).min(1).max(500),
-        title: z.string().optional().describe("Label for the dashboard; never shown to recipients."),
-        expiresInDays: z.number().int().positive().optional()
+  if (opts.canWrite) {
+    server.registerTool(
+      "create_transfer",
+      {
+        title: "Prepare a transfer",
+        description: [
+          "Prepare a draft transfer for files that live on a machine with a shell, and return one",
+          "upload command per file. Each command (`npx -y yungle-cli put \u2026`) needs no Yungle key: it",
+          "carries a token that can write only that file, for two hours, and it resumes if interrupted.",
+          "Nothing is shared and nobody is emailed until the transfer is finalized."
+        ].join("\n"),
+        inputSchema: {
+          files: z.array(
+            z.object({
+              name: z.string(),
+              size: z.number().int().nonnegative().describe("Exact byte size."),
+              path: z.string().optional().describe("Folder within the upload."),
+              localPath: z.string().optional().describe("Where the file is on the machine that will run the command.")
+            })
+          ).min(1).max(500),
+          title: z.string().optional().describe("Label for the dashboard; never shown to recipients."),
+          expiresInDays: z.number().int().positive().optional()
+        },
+        annotations: { title: "Prepare a transfer", readOnlyHint: false, destructiveHint: false, idempotentHint: false }
       },
-      annotations: { title: "Prepare a transfer", readOnlyHint: false, destructiveHint: false, idempotentHint: false }
-    },
-    async ({ files, title, expiresInDays }) => {
-      try {
-        const created = await client.createTransfer({
-          files: files.map(({ localPath: _local, ...f }) => f),
-          title,
-          expiresInDays
-        });
-        return ok({
-          transferId: created.transfer.id,
-          // Said in the payload, not only the description: the payload is what a
-          // model summarises back to the user.
-          status: "draft \u2014 nothing uploaded yet, nobody emailed",
-          uploadCommands: created.files.map((t, i) => ({
-            name: t.name,
-            command: `npx -y yungle-cli@latest put ${shellQuote(files[i].localPath ?? `./${t.name}`)} --target ${packTarget({
-              e: created.tusEndpoint,
-              i: t.id,
-              t: t.uploadToken,
-              n: t.name,
-              s: t.size
-            })}`
-          })),
-          next: "Run each command where the file is. When they have finished, finalize the transfer to get its link \u2014 or upload in the Yungle dashboard instead.",
-          expiresAt: created.transfer.expiresAt
-        });
-      } catch (err) {
-        return fail(errorText(err));
+      async ({ files, title, expiresInDays }) => {
+        try {
+          const created = await client.createTransfer({
+            files: files.map(({ localPath: _local, ...f }) => f),
+            title,
+            expiresInDays
+          });
+          return ok({
+            transferId: created.transfer.id,
+            // Said in the payload, not only the description: the payload is what a
+            // model summarises back to the user.
+            status: "draft \u2014 nothing uploaded yet, nobody emailed",
+            uploadCommands: created.files.map((t, i) => ({
+              name: t.name,
+              command: `npx -y yungle-cli@latest put ${shellQuote(files[i].localPath ?? `./${t.name}`)} --target ${packTarget({
+                e: created.tusEndpoint,
+                i: t.id,
+                t: t.uploadToken,
+                n: t.name,
+                s: t.size
+              })}`
+            })),
+            next: "Run each command where the file is. When they have finished, finalize the transfer to get its link \u2014 or upload in the Yungle dashboard instead.",
+            expiresAt: created.transfer.expiresAt
+          });
+        } catch (err) {
+          return fail(errorText(err));
+        }
       }
-    }
-  );
+    );
+  }
   if (opts.canWrite) {
     server.registerTool(
       "finalize_transfer",

package/dist/server.mjs

@@ -222,7 +222,7 @@ function pageQuery(page, extra = {}) {
   const q = params.toString();
   return q ? `?${q}` : "";
 }
-var CLIENT_VERSION = true ? "0.3.0" : "dev";
+var CLIENT_VERSION = true ? "0.3.1" : "dev";
 var YungleClient = class {
   baseUrl;
   apiKey;
@@ -262,6 +262,10 @@ var YungleClient = class {
   me() {
     return this.request("GET", "/me");
   }
+  /** Your invite code and link, and the free months it has earned. */
+  getReferral() {
+    return this.request("GET", "/me/referral");
+  }
   // ── Transfers ─────────────────────────────────────────────────────────────
   /**
    * One page of transfers, newest first — 100 by default, up to 500. Pass the
@@ -686,7 +690,7 @@ async function fetchTo(url, dest, size, doFetch) {
 }
 
 // src/server.ts
-var MCP_VERSION = true ? "0.3.0" : "dev";
+var MCP_VERSION = true ? "0.3.1" : "dev";
 function createServer(client, opts = { canWrite: false, canEmail: false, local: false }) {
   const server = new McpServer(
     { name: "yungle", version: MCP_VERSION },
@@ -924,60 +928,62 @@ function createServer(client, opts = { canWrite: false, canEmail: false, local:
       }
     );
   }
-  server.registerTool(
-    "create_transfer",
-    {
-      title: "Prepare a transfer",
-      description: [
-        "Prepare a draft transfer for files that live on a machine with a shell, and return one",
-        "upload command per file. Each command (`npx -y yungle-cli put \u2026`) needs no Yungle key: it",
-        "carries a token that can write only that file, for two hours, and it resumes if interrupted.",
-        "Nothing is shared and nobody is emailed until the transfer is finalized."
-      ].join("\n"),
-      inputSchema: {
-        files: z.array(
-          z.object({
-            name: z.string(),
-            size: z.number().int().nonnegative().describe("Exact byte size."),
-            path: z.string().optional().describe("Folder within the upload."),
-            localPath: z.string().optional().describe("Where the file is on the machine that will run the command.")
-          })
-        ).min(1).max(500),
-        title: z.string().optional().describe("Label for the dashboard; never shown to recipients."),
-        expiresInDays: z.number().int().positive().optional()
+  if (opts.canWrite) {
+    server.registerTool(
+      "create_transfer",
+      {
+        title: "Prepare a transfer",
+        description: [
+          "Prepare a draft transfer for files that live on a machine with a shell, and return one",
+          "upload command per file. Each command (`npx -y yungle-cli put \u2026`) needs no Yungle key: it",
+          "carries a token that can write only that file, for two hours, and it resumes if interrupted.",
+          "Nothing is shared and nobody is emailed until the transfer is finalized."
+        ].join("\n"),
+        inputSchema: {
+          files: z.array(
+            z.object({
+              name: z.string(),
+              size: z.number().int().nonnegative().describe("Exact byte size."),
+              path: z.string().optional().describe("Folder within the upload."),
+              localPath: z.string().optional().describe("Where the file is on the machine that will run the command.")
+            })
+          ).min(1).max(500),
+          title: z.string().optional().describe("Label for the dashboard; never shown to recipients."),
+          expiresInDays: z.number().int().positive().optional()
+        },
+        annotations: { title: "Prepare a transfer", readOnlyHint: false, destructiveHint: false, idempotentHint: false }
       },
-      annotations: { title: "Prepare a transfer", readOnlyHint: false, destructiveHint: false, idempotentHint: false }
-    },
-    async ({ files, title, expiresInDays }) => {
-      try {
-        const created = await client.createTransfer({
-          files: files.map(({ localPath: _local, ...f }) => f),
-          title,
-          expiresInDays
-        });
-        return ok({
-          transferId: created.transfer.id,
-          // Said in the payload, not only the description: the payload is what a
-          // model summarises back to the user.
-          status: "draft \u2014 nothing uploaded yet, nobody emailed",
-          uploadCommands: created.files.map((t, i) => ({
-            name: t.name,
-            command: `npx -y yungle-cli@latest put ${shellQuote(files[i].localPath ?? `./${t.name}`)} --target ${packTarget({
-              e: created.tusEndpoint,
-              i: t.id,
-              t: t.uploadToken,
-              n: t.name,
-              s: t.size
-            })}`
-          })),
-          next: "Run each command where the file is. When they have finished, finalize the transfer to get its link \u2014 or upload in the Yungle dashboard instead.",
-          expiresAt: created.transfer.expiresAt
-        });
-      } catch (err) {
-        return fail(errorText(err));
+      async ({ files, title, expiresInDays }) => {
+        try {
+          const created = await client.createTransfer({
+            files: files.map(({ localPath: _local, ...f }) => f),
+            title,
+            expiresInDays
+          });
+          return ok({
+            transferId: created.transfer.id,
+            // Said in the payload, not only the description: the payload is what a
+            // model summarises back to the user.
+            status: "draft \u2014 nothing uploaded yet, nobody emailed",
+            uploadCommands: created.files.map((t, i) => ({
+              name: t.name,
+              command: `npx -y yungle-cli@latest put ${shellQuote(files[i].localPath ?? `./${t.name}`)} --target ${packTarget({
+                e: created.tusEndpoint,
+                i: t.id,
+                t: t.uploadToken,
+                n: t.name,
+                s: t.size
+              })}`
+            })),
+            next: "Run each command where the file is. When they have finished, finalize the transfer to get its link \u2014 or upload in the Yungle dashboard instead.",
+            expiresAt: created.transfer.expiresAt
+          });
+        } catch (err) {
+          return fail(errorText(err));
+        }
       }
-    }
-  );
+    );
+  }
   if (opts.canWrite) {
     server.registerTool(
       "finalize_transfer",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "yungle-mcp",
   "mcpName": "co.yungle/yungle",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "type": "module",
   "description": "MCP server for Yungle: let Claude, Cursor or any MCP client read your file transfers, share files and send them, with your approval.",
   "bin": {
@@ -15,7 +15,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
     "zod": "^3.24.1",
-    "yungle-client": "^0.3.0"
+    "yungle-client": "^0.3.1"
   },
   "devDependencies": {
     "@types/node": "^22.10.5",