yungle-mcp 0.2.2 → 0.2.4

package/README.md

@@ -6,8 +6,9 @@ any MCP client with one sign-in: ask what arrived, share files, and approve ever
 
 ## Connect in one click (recommended)
 
-Yungle runs this server for you. Add it as a remote MCP server (in Claude: *Settings →
-Connectors → Add custom connector*; in Cursor: *MCP → Add server*) and sign in when asked:
+Yungle runs this server for you. **In Claude**, add it from the connector directory:
+[claude.ai/directory/yungle](https://claude.ai/directory/yungle). **Elsewhere** (Cursor: *MCP → Add
+server*, and any other MCP client), add it as a remote server and sign in when asked:
 
 ```
 https://yungle.co/mcp

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.2" : "dev";
+var MCP_VERSION = true ? "0.2.4" : "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 downloaded 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"),

package/dist/server.mjs

@@ -34,7 +34,7 @@ function pageQuery(page, extra = {}) {
   const q = params.toString();
   return q ? `?${q}` : "";
 }
-var CLIENT_VERSION = true ? "0.2.0" : "dev";
+var CLIENT_VERSION = true ? "0.2.1" : "dev";
 var YungleClient = class {
   baseUrl;
   apiKey;
@@ -345,7 +345,7 @@ async function uploadPath(endpoint, target, path, size, doFetch = fetch) {
 }
 
 // src/server.ts
-var MCP_VERSION = true ? "0.2.2" : "dev";
+var MCP_VERSION = true ? "0.2.4" : "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 downloaded 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"),

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "yungle-mcp",
   "mcpName": "co.yungle/yungle",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "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.2.0"
+    "yungle-client": "^0.2.1"
   },
   "devDependencies": {
     "@types/node": "^22.10.5",