yungle-mcp 0.2.0 → 0.2.2

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.0" : "dev";
+var MCP_VERSION = true ? "0.2.2" : "dev";
 function createServer(client, opts = { canWrite: false, canEmail: false, local: false }) {
   const server = new McpServer(
     { name: "yungle", version: MCP_VERSION },
@@ -95,7 +95,7 @@ function createServer(client, opts = { canWrite: false, canEmail: false, local:
       title: "Account and storage",
       description: "Answers: how much storage am I using? how much is left? what plan am I on? what can this connection do? Returns the workspace, its plan and quota, and the key's permissions.",
       inputSchema: {},
-      annotations: { readOnlyHint: true }
+      annotations: { title: "Account and storage", readOnlyHint: true }
     },
     async () => ok(await client.me())
   );
@@ -105,7 +105,7 @@ function createServer(client, opts = { canWrite: false, canEmail: false, local:
       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.",
       inputSchema: {},
-      annotations: { readOnlyHint: true }
+      annotations: { title: "List transfers", readOnlyHint: true }
     },
     async () => {
       const { transfers } = await client.listTransfers();
@@ -118,7 +118,7 @@ function createServer(client, opts = { canWrite: false, canEmail: false, local:
       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.") },
-      annotations: { readOnlyHint: true }
+      annotations: { title: "Transfer detail", readOnlyHint: true }
     },
     async ({ id }) => ok(wrapUntrusted(await client.getTransfer(id)))
   );
@@ -128,7 +128,7 @@ function createServer(client, opts = { canWrite: false, canEmail: false, local:
       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.",
       inputSchema: { id: z.string() },
-      annotations: { readOnlyHint: true }
+      annotations: { title: "Download receipts", readOnlyHint: true }
     },
     async ({ id }) => ok(wrapUntrusted(await client.transferDownloads(id)))
   );
@@ -138,7 +138,7 @@ function createServer(client, opts = { canWrite: false, canEmail: false, local:
       title: "List collections",
       description: "Answers: what collections do I have? which are empty? how big is each one? Returns collections with file counts, sizes and when each was last touched. A collection is a durable space clients are invited into, as opposed to a one-off transfer. Never includes the vault, which is unreadable to this server by design.",
       inputSchema: {},
-      annotations: { readOnlyHint: true }
+      annotations: { title: "List collections", readOnlyHint: true }
     },
     async () => ok(wrapUntrusted(await client.listCollections()))
   );
@@ -148,7 +148,7 @@ function createServer(client, opts = { canWrite: false, canEmail: false, local:
       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.",
       inputSchema: { id: z.string() },
-      annotations: { readOnlyHint: true }
+      annotations: { title: "Collection detail", readOnlyHint: true }
     },
     async ({ id }) => ok(wrapUntrusted(await client.getCollection(id)))
   );
@@ -158,7 +158,7 @@ function createServer(client, opts = { canWrite: false, canEmail: false, local:
       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.',
       inputSchema: { id: z.string(), folderId: z.string().optional() },
-      annotations: { readOnlyHint: true }
+      annotations: { title: "Files in a collection", readOnlyHint: true }
     },
     async ({ id, folderId }) => ok(wrapUntrusted(await client.listCollectionFiles(id, folderId)))
   );
@@ -168,7 +168,7 @@ function createServer(client, opts = { canWrite: false, canEmail: false, local:
       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.",
       inputSchema: { id: z.string() },
-      annotations: { readOnlyHint: true }
+      annotations: { title: "Folders in a collection", readOnlyHint: true }
     },
     async ({ id }) => ok(wrapUntrusted(await client.listFolders(id)))
   );
@@ -178,7 +178,7 @@ function createServer(client, opts = { canWrite: false, canEmail: false, local:
       title: "Guests on a collection",
       description: "Answers: who has access to this collection? who did I invite? has someone accepted? Returns the invited guests and their status. Guests are not workspace members \u2014 they can view and download this one collection and nothing else.",
       inputSchema: { id: z.string() },
-      annotations: { readOnlyHint: true }
+      annotations: { title: "Guests on a collection", readOnlyHint: true }
     },
     async ({ id }) => ok(wrapUntrusted(await client.listGuests(id)))
   );
@@ -188,7 +188,7 @@ function createServer(client, opts = { canWrite: false, canEmail: false, local:
       title: "Address book",
       description: "Answers: what is this client's email address? who do I have saved? Returns the workspace address book. A contact grants no access on its own \u2014 it is a convenience, not a permission.",
       inputSchema: {},
-      annotations: { readOnlyHint: true }
+      annotations: { title: "Address book", readOnlyHint: true }
     },
     async () => ok(wrapUntrusted(await client.listContacts()))
   );
@@ -214,7 +214,7 @@ function createServer(client, opts = { canWrite: false, canEmail: false, local:
         title: z.string().optional().describe("Label for the dashboard; never shown to recipients."),
         expiresInDays: z.number().int().positive().optional()
       },
-      annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false }
+      annotations: { title: "Prepare a transfer", readOnlyHint: false, destructiveHint: false, idempotentHint: false }
     },
     async ({ files, title, expiresInDays }) => {
       const created = await client.createTransfer({ files, title, expiresInDays });
@@ -250,7 +250,7 @@ function createServer(client, opts = { canWrite: false, canEmail: false, local:
           title: z.string().optional().describe("Label for the dashboard; never shown to recipients."),
           expiresInDays: z.number().int().positive().optional()
         },
-        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }
+        annotations: { title: "Share content as a link", readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }
       },
       async ({ files, title, expiresInDays }) => {
         const contents = files.map(
@@ -284,7 +284,7 @@ function createServer(client, opts = { canWrite: false, canEmail: false, local:
           title: z.string().optional(),
           expiresInDays: z.number().int().positive().optional()
         },
-        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }
+        annotations: { title: "Share files from this computer as a link", readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }
       },
       async ({ paths: asked, title, expiresInDays }, extra) => {
         const isHidden = (p) => p.split(/[\\/]/).some((seg) => seg.startsWith(".") && seg !== "." && seg !== "..");
@@ -332,7 +332,7 @@ function createServer(client, opts = { canWrite: false, canEmail: false, local:
           recipients: z.array(z.string().email()).min(1).max(10),
           message: z.string().max(2e3).optional().describe("A note shown in the email.")
         },
-        annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: true }
+        annotations: { title: "Email a transfer to recipients", readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: true }
       },
       async ({ transferId, recipients, message }, extra) => {
         const { transfer } = await client.getTransfer(transferId);
@@ -369,9 +369,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 +399,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 +414,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.0" : "dev";
+var MCP_VERSION = true ? "0.2.2" : "dev";
 function createServer(client, opts = { canWrite: false, canEmail: false, local: false }) {
   const server = new McpServer(
     { name: "yungle", version: MCP_VERSION },
@@ -366,7 +366,7 @@ function createServer(client, opts = { canWrite: false, canEmail: false, local:
       title: "Account and storage",
       description: "Answers: how much storage am I using? how much is left? what plan am I on? what can this connection do? Returns the workspace, its plan and quota, and the key's permissions.",
       inputSchema: {},
-      annotations: { readOnlyHint: true }
+      annotations: { title: "Account and storage", readOnlyHint: true }
     },
     async () => ok(await client.me())
   );
@@ -376,7 +376,7 @@ function createServer(client, opts = { canWrite: false, canEmail: false, local:
       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.",
       inputSchema: {},
-      annotations: { readOnlyHint: true }
+      annotations: { title: "List transfers", readOnlyHint: true }
     },
     async () => {
       const { transfers } = await client.listTransfers();
@@ -389,7 +389,7 @@ function createServer(client, opts = { canWrite: false, canEmail: false, local:
       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.") },
-      annotations: { readOnlyHint: true }
+      annotations: { title: "Transfer detail", readOnlyHint: true }
     },
     async ({ id }) => ok(wrapUntrusted(await client.getTransfer(id)))
   );
@@ -399,7 +399,7 @@ function createServer(client, opts = { canWrite: false, canEmail: false, local:
       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.",
       inputSchema: { id: z.string() },
-      annotations: { readOnlyHint: true }
+      annotations: { title: "Download receipts", readOnlyHint: true }
     },
     async ({ id }) => ok(wrapUntrusted(await client.transferDownloads(id)))
   );
@@ -409,7 +409,7 @@ function createServer(client, opts = { canWrite: false, canEmail: false, local:
       title: "List collections",
       description: "Answers: what collections do I have? which are empty? how big is each one? Returns collections with file counts, sizes and when each was last touched. A collection is a durable space clients are invited into, as opposed to a one-off transfer. Never includes the vault, which is unreadable to this server by design.",
       inputSchema: {},
-      annotations: { readOnlyHint: true }
+      annotations: { title: "List collections", readOnlyHint: true }
     },
     async () => ok(wrapUntrusted(await client.listCollections()))
   );
@@ -419,7 +419,7 @@ function createServer(client, opts = { canWrite: false, canEmail: false, local:
       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.",
       inputSchema: { id: z.string() },
-      annotations: { readOnlyHint: true }
+      annotations: { title: "Collection detail", readOnlyHint: true }
     },
     async ({ id }) => ok(wrapUntrusted(await client.getCollection(id)))
   );
@@ -429,7 +429,7 @@ function createServer(client, opts = { canWrite: false, canEmail: false, local:
       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.',
       inputSchema: { id: z.string(), folderId: z.string().optional() },
-      annotations: { readOnlyHint: true }
+      annotations: { title: "Files in a collection", readOnlyHint: true }
     },
     async ({ id, folderId }) => ok(wrapUntrusted(await client.listCollectionFiles(id, folderId)))
   );
@@ -439,7 +439,7 @@ function createServer(client, opts = { canWrite: false, canEmail: false, local:
       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.",
       inputSchema: { id: z.string() },
-      annotations: { readOnlyHint: true }
+      annotations: { title: "Folders in a collection", readOnlyHint: true }
     },
     async ({ id }) => ok(wrapUntrusted(await client.listFolders(id)))
   );
@@ -449,7 +449,7 @@ function createServer(client, opts = { canWrite: false, canEmail: false, local:
       title: "Guests on a collection",
       description: "Answers: who has access to this collection? who did I invite? has someone accepted? Returns the invited guests and their status. Guests are not workspace members \u2014 they can view and download this one collection and nothing else.",
       inputSchema: { id: z.string() },
-      annotations: { readOnlyHint: true }
+      annotations: { title: "Guests on a collection", readOnlyHint: true }
     },
     async ({ id }) => ok(wrapUntrusted(await client.listGuests(id)))
   );
@@ -459,7 +459,7 @@ function createServer(client, opts = { canWrite: false, canEmail: false, local:
       title: "Address book",
       description: "Answers: what is this client's email address? who do I have saved? Returns the workspace address book. A contact grants no access on its own \u2014 it is a convenience, not a permission.",
       inputSchema: {},
-      annotations: { readOnlyHint: true }
+      annotations: { title: "Address book", readOnlyHint: true }
     },
     async () => ok(wrapUntrusted(await client.listContacts()))
   );
@@ -485,7 +485,7 @@ function createServer(client, opts = { canWrite: false, canEmail: false, local:
         title: z.string().optional().describe("Label for the dashboard; never shown to recipients."),
         expiresInDays: z.number().int().positive().optional()
       },
-      annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false }
+      annotations: { title: "Prepare a transfer", readOnlyHint: false, destructiveHint: false, idempotentHint: false }
     },
     async ({ files, title, expiresInDays }) => {
       const created = await client.createTransfer({ files, title, expiresInDays });
@@ -521,7 +521,7 @@ function createServer(client, opts = { canWrite: false, canEmail: false, local:
           title: z.string().optional().describe("Label for the dashboard; never shown to recipients."),
           expiresInDays: z.number().int().positive().optional()
         },
-        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }
+        annotations: { title: "Share content as a link", readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }
       },
       async ({ files, title, expiresInDays }) => {
         const contents = files.map(
@@ -555,7 +555,7 @@ function createServer(client, opts = { canWrite: false, canEmail: false, local:
           title: z.string().optional(),
           expiresInDays: z.number().int().positive().optional()
         },
-        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }
+        annotations: { title: "Share files from this computer as a link", readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }
       },
       async ({ paths: asked, title, expiresInDays }, extra) => {
         const isHidden = (p) => p.split(/[\\/]/).some((seg) => seg.startsWith(".") && seg !== "." && seg !== "..");
@@ -603,7 +603,7 @@ function createServer(client, opts = { canWrite: false, canEmail: false, local:
           recipients: z.array(z.string().email()).min(1).max(10),
           message: z.string().max(2e3).optional().describe("A note shown in the email.")
         },
-        annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: true }
+        annotations: { title: "Email a transfer to recipients", readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: true }
       },
       async ({ transferId, recipients, message }, extra) => {
         const { transfer } = await client.getTransfer(transferId);
@@ -640,9 +640,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 +670,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 +685,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.0",
+  "version": "0.2.2",
   "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": {