yungle-mcp 0.2.1 → 0.2.3

package/dist/index.mjs

@@ -74,7 +74,7 @@ async function uploadPath(endpoint, target, path, size, doFetch = fetch) {
 }
 
 // src/server.ts
-var MCP_VERSION = true ? "0.2.1" : "dev";
+var MCP_VERSION = true ? "0.2.3" : "dev";
 function createServer(client, opts = { canWrite: false, canEmail: false, local: false }) {
   const server = new McpServer(
     { name: "yungle", version: MCP_VERSION },
@@ -103,7 +103,7 @@ function createServer(client, opts = { canWrite: false, canEmail: false, local:
     "list_transfers",
     {
       title: "List transfers",
-      description: "Answers: what have I sent recently? what is expiring soon? which deliveries has nobody picked up? who did I send that to? Returns recent transfers with size, recipients, download count, expiry date and share link. Start here for any question about sent files.",
+      description: "Answers: what have I sent recently? what is expiring soon? which deliveries has nobody picked up? who did I send that to? Returns recent transfers with size, recipients, download count, expiry date and share link.",
       inputSchema: {},
       annotations: { title: "List transfers", readOnlyHint: true }
     },
@@ -116,8 +116,8 @@ function createServer(client, opts = { canWrite: false, canEmail: false, local:
     "get_transfer",
     {
       title: "Transfer detail",
-      description: "Answers: what is in this transfer? was it delivered? has a specific recipient opened it? is it safe to share? Returns the files with their malware-scan verdicts, plus per-recipient delivery and download status. Needs an id from list_transfers.",
-      inputSchema: { id: z.string().describe("Transfer id from list_transfers.") },
+      description: "Answers: what is in this transfer? was it delivered? has a specific recipient opened it? is it safe to share? Returns the files with their malware-scan verdicts, plus per-recipient delivery and download status for one transfer id.",
+      inputSchema: { id: z.string().describe("Transfer id.") },
       annotations: { title: "Transfer detail", readOnlyHint: true }
     },
     async ({ id }) => ok(wrapUntrusted(await client.getTransfer(id)))
@@ -126,7 +126,7 @@ function createServer(client, opts = { canWrite: false, canEmail: false, local:
     "get_transfer_downloads",
     {
       title: "Download receipts",
-      description: "Answers: did the client download it? when? how many times? Returns download events with timestamps and per-recipient status. IMPORTANT when counting: one page visit is one download, not one per file \u2014 events sharing a sessionId are a single visit, so count distinct sessions or a single visitor looks like eight.",
+      description: "Answers: did the client download it? when? how many times? Returns download events with timestamps and per-recipient status. One visit can fetch several files: events that share a sessionId belong to the same visit.",
       inputSchema: { id: z.string() },
       annotations: { title: "Download receipts", readOnlyHint: true }
     },
@@ -146,7 +146,7 @@ function createServer(client, opts = { canWrite: false, canEmail: false, local:
     "get_collection",
     {
       title: "Collection detail",
-      description: "Answers: what is the link for this collection? how much is in it? when does it expire? Returns one collection with its secret share link, file count, total size and expiry. Needs an id from list_collections.",
+      description: "Answers: what is the link for this collection? how much is in it? when does it expire? Returns one collection with its secret share link, file count, total size and expiry.",
       inputSchema: { id: z.string() },
       annotations: { title: "Collection detail", readOnlyHint: true }
     },
@@ -156,7 +156,7 @@ function createServer(client, opts = { canWrite: false, canEmail: false, local:
     "list_collection_files",
     {
       title: "Files in a collection",
-      description: 'Answers: what files are in this collection? what is in this folder? are the raws uploaded yet? Returns filenames, sizes and types. Omit folderId for every file; pass "root" for the top level only, or a folder id from list_folders. Filenames only \u2014 never file contents.',
+      description: 'Answers: what files are in this collection? what is in this folder? are the raws uploaded yet? Returns filenames, sizes and types. Omit folderId for every file; pass "root" for the top level only, or a folder id. Filenames only \u2014 never file contents.',
       inputSchema: { id: z.string(), folderId: z.string().optional() },
       annotations: { title: "Files in a collection", readOnlyHint: true }
     },
@@ -166,7 +166,7 @@ function createServer(client, opts = { canWrite: false, canEmail: false, local:
     "list_folders",
     {
       title: "Folders in a collection",
-      description: "Answers: how is this collection organised? what folders exist? Returns the folder tree. Ordered by depth then path, which is NOT a pre-order traversal \u2014 build the tree from parentId rather than trusting the order. Each folder also carries its full materialised path.",
+      description: "Answers: how is this collection organised? what folders exist? Returns the folder tree. Ordered by depth, then path (not a pre-order traversal). Each folder carries its parentId and its full path.",
       inputSchema: { id: z.string() },
       annotations: { title: "Folders in a collection", readOnlyHint: true }
     },
@@ -199,9 +199,8 @@ function createServer(client, opts = { canWrite: false, canEmail: false, local:
       description: [
         "Prepare a draft transfer for files the user will upload themselves, and return its id.",
         "",
-        "This does NOT upload any files and does NOT email anybody. Use it when the user wants",
-        "to start a send and finish it in the browser or with `yungle send`. To share content",
-        "you have in hand, use create_share_link instead."
+        "It uploads no files and emails nobody: the user uploads the files and sends the transfer",
+        "themselves, in the browser or with the Yungle CLI."
       ].join("\n"),
       inputSchema: {
         files: z.array(
@@ -323,7 +322,7 @@ function createServer(client, opts = { canWrite: false, canEmail: false, local:
       {
         title: "Email a transfer to recipients",
         description: [
-          "Email an existing transfer (from create_share_link or share_local_files) to up to 10",
+          "Email an existing transfer, one already shared as a link, to up to 10",
           "recipients. The user is asked to confirm every send, with the addresses and message",
           "shown to them; if this client cannot ask, nothing is sent and you get the link to pass on."
         ].join("\n"),
@@ -369,9 +368,11 @@ async function startStdioServer() {
   const apiKey = process.env.YUNGLE_API_KEY?.trim();
   if (!apiKey) {
     process.stderr.write(
-      "YUNGLE_API_KEY is not set. Create a key at https://yungle.co/dashboard/settings/api\n"
+      "YUNGLE_API_KEY is not set: listing tools only. Create a key at https://yungle.co/dashboard/settings/api\n"
     );
-    process.exit(2);
+    const server2 = createServer(keylessClient(), { canWrite: false, canEmail: false, local: true });
+    await server2.connect(new StdioServerTransport());
+    return;
   }
   const client = new YungleClient({
     apiKey,
@@ -397,6 +398,12 @@ async function startStdioServer() {
   });
   await server.connect(new StdioServerTransport());
 }
+function keylessClient() {
+  const message = "YUNGLE_API_KEY is not set, so this server cannot reach Yungle. Create a key at https://yungle.co/dashboard/settings/api and add it to this MCP server's environment, or connect to the hosted server at https://yungle.co/mcp instead.";
+  return new Proxy({}, {
+    get: () => () => Promise.reject(new Error(message))
+  });
+}
 function ok(payload) {
   return { content: [{ type: "text", text: JSON.stringify(payload, null, 2) }] };
 }
@@ -406,5 +413,6 @@ function fail(message) {
 export {
   MCP_VERSION,
   createServer,
+  keylessClient,
   startStdioServer
 };

package/dist/server.d.ts

@@ -23,3 +23,5 @@ export declare function createServer(client: YungleClient, opts?: ServerOptions)
  * emails nobody and needs only transfers:write.
  */
 export declare function startStdioServer(): Promise<void>;
+/** A client whose every call explains that there is no key. */
+export declare function keylessClient(): YungleClient;

package/dist/server.mjs

@@ -345,7 +345,7 @@ async function uploadPath(endpoint, target, path, size, doFetch = fetch) {
 }
 
 // src/server.ts
-var MCP_VERSION = true ? "0.2.1" : "dev";
+var MCP_VERSION = true ? "0.2.3" : "dev";
 function createServer(client, opts = { canWrite: false, canEmail: false, local: false }) {
   const server = new McpServer(
     { name: "yungle", version: MCP_VERSION },
@@ -374,7 +374,7 @@ function createServer(client, opts = { canWrite: false, canEmail: false, local:
     "list_transfers",
     {
       title: "List transfers",
-      description: "Answers: what have I sent recently? what is expiring soon? which deliveries has nobody picked up? who did I send that to? Returns recent transfers with size, recipients, download count, expiry date and share link. Start here for any question about sent files.",
+      description: "Answers: what have I sent recently? what is expiring soon? which deliveries has nobody picked up? who did I send that to? Returns recent transfers with size, recipients, download count, expiry date and share link.",
       inputSchema: {},
       annotations: { title: "List transfers", readOnlyHint: true }
     },
@@ -387,8 +387,8 @@ function createServer(client, opts = { canWrite: false, canEmail: false, local:
     "get_transfer",
     {
       title: "Transfer detail",
-      description: "Answers: what is in this transfer? was it delivered? has a specific recipient opened it? is it safe to share? Returns the files with their malware-scan verdicts, plus per-recipient delivery and download status. Needs an id from list_transfers.",
-      inputSchema: { id: z.string().describe("Transfer id from list_transfers.") },
+      description: "Answers: what is in this transfer? was it delivered? has a specific recipient opened it? is it safe to share? Returns the files with their malware-scan verdicts, plus per-recipient delivery and download status for one transfer id.",
+      inputSchema: { id: z.string().describe("Transfer id.") },
       annotations: { title: "Transfer detail", readOnlyHint: true }
     },
     async ({ id }) => ok(wrapUntrusted(await client.getTransfer(id)))
@@ -397,7 +397,7 @@ function createServer(client, opts = { canWrite: false, canEmail: false, local:
     "get_transfer_downloads",
     {
       title: "Download receipts",
-      description: "Answers: did the client download it? when? how many times? Returns download events with timestamps and per-recipient status. IMPORTANT when counting: one page visit is one download, not one per file \u2014 events sharing a sessionId are a single visit, so count distinct sessions or a single visitor looks like eight.",
+      description: "Answers: did the client download it? when? how many times? Returns download events with timestamps and per-recipient status. One visit can fetch several files: events that share a sessionId belong to the same visit.",
       inputSchema: { id: z.string() },
       annotations: { title: "Download receipts", readOnlyHint: true }
     },
@@ -417,7 +417,7 @@ function createServer(client, opts = { canWrite: false, canEmail: false, local:
     "get_collection",
     {
       title: "Collection detail",
-      description: "Answers: what is the link for this collection? how much is in it? when does it expire? Returns one collection with its secret share link, file count, total size and expiry. Needs an id from list_collections.",
+      description: "Answers: what is the link for this collection? how much is in it? when does it expire? Returns one collection with its secret share link, file count, total size and expiry.",
       inputSchema: { id: z.string() },
       annotations: { title: "Collection detail", readOnlyHint: true }
     },
@@ -427,7 +427,7 @@ function createServer(client, opts = { canWrite: false, canEmail: false, local:
     "list_collection_files",
     {
       title: "Files in a collection",
-      description: 'Answers: what files are in this collection? what is in this folder? are the raws uploaded yet? Returns filenames, sizes and types. Omit folderId for every file; pass "root" for the top level only, or a folder id from list_folders. Filenames only \u2014 never file contents.',
+      description: 'Answers: what files are in this collection? what is in this folder? are the raws uploaded yet? Returns filenames, sizes and types. Omit folderId for every file; pass "root" for the top level only, or a folder id. Filenames only \u2014 never file contents.',
       inputSchema: { id: z.string(), folderId: z.string().optional() },
       annotations: { title: "Files in a collection", readOnlyHint: true }
     },
@@ -437,7 +437,7 @@ function createServer(client, opts = { canWrite: false, canEmail: false, local:
     "list_folders",
     {
       title: "Folders in a collection",
-      description: "Answers: how is this collection organised? what folders exist? Returns the folder tree. Ordered by depth then path, which is NOT a pre-order traversal \u2014 build the tree from parentId rather than trusting the order. Each folder also carries its full materialised path.",
+      description: "Answers: how is this collection organised? what folders exist? Returns the folder tree. Ordered by depth, then path (not a pre-order traversal). Each folder carries its parentId and its full path.",
       inputSchema: { id: z.string() },
       annotations: { title: "Folders in a collection", readOnlyHint: true }
     },
@@ -470,9 +470,8 @@ function createServer(client, opts = { canWrite: false, canEmail: false, local:
       description: [
         "Prepare a draft transfer for files the user will upload themselves, and return its id.",
         "",
-        "This does NOT upload any files and does NOT email anybody. Use it when the user wants",
-        "to start a send and finish it in the browser or with `yungle send`. To share content",
-        "you have in hand, use create_share_link instead."
+        "It uploads no files and emails nobody: the user uploads the files and sends the transfer",
+        "themselves, in the browser or with the Yungle CLI."
       ].join("\n"),
       inputSchema: {
         files: z.array(
@@ -594,7 +593,7 @@ function createServer(client, opts = { canWrite: false, canEmail: false, local:
       {
         title: "Email a transfer to recipients",
         description: [
-          "Email an existing transfer (from create_share_link or share_local_files) to up to 10",
+          "Email an existing transfer, one already shared as a link, to up to 10",
           "recipients. The user is asked to confirm every send, with the addresses and message",
           "shown to them; if this client cannot ask, nothing is sent and you get the link to pass on."
         ].join("\n"),
@@ -640,9 +639,11 @@ async function startStdioServer() {
   const apiKey = process.env.YUNGLE_API_KEY?.trim();
   if (!apiKey) {
     process.stderr.write(
-      "YUNGLE_API_KEY is not set. Create a key at https://yungle.co/dashboard/settings/api\n"
+      "YUNGLE_API_KEY is not set: listing tools only. Create a key at https://yungle.co/dashboard/settings/api\n"
     );
-    process.exit(2);
+    const server2 = createServer(keylessClient(), { canWrite: false, canEmail: false, local: true });
+    await server2.connect(new StdioServerTransport());
+    return;
   }
   const client = new YungleClient({
     apiKey,
@@ -668,6 +669,12 @@ async function startStdioServer() {
   });
   await server.connect(new StdioServerTransport());
 }
+function keylessClient() {
+  const message = "YUNGLE_API_KEY is not set, so this server cannot reach Yungle. Create a key at https://yungle.co/dashboard/settings/api and add it to this MCP server's environment, or connect to the hosted server at https://yungle.co/mcp instead.";
+  return new Proxy({}, {
+    get: () => () => Promise.reject(new Error(message))
+  });
+}
 function ok(payload) {
   return { content: [{ type: "text", text: JSON.stringify(payload, null, 2) }] };
 }
@@ -677,6 +684,7 @@ function fail(message) {
 export {
   MCP_VERSION,
   createServer,
+  keylessClient,
   startStdioServer
 };
 await startStdioServer();

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "yungle-mcp",
   "mcpName": "co.yungle/yungle",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "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": {