@publishq/mcp 0.0.7 → 1.0.0

package/README.md

@@ -90,8 +90,13 @@ Any MCP client that launches a stdio server works the same way: run the command
 | `publishq_upload_media`             | Upload a file and get a media ID: a local path (local server) or a link or chat attachment (hosted server) |
 | `publishq_create_media_upload`      | Get a signed URL to upload a file from your own disk, up to 4 GB |
 | `publishq_delete_media`             | Delete a media file no draft or scheduled post uses     |
+| `publishq_list_media_folders`       | List media folders with their file counts               |
+| `publishq_move_media`               | Move media files to a folder or to the top level        |
+| `publishq_rename_media_folder`      | Rename a media folder                                   |
+| `publishq_preview_media_folder_deletion` | Count what deleting a folder would remove          |
+| `publishq_delete_media_folder`      | Delete a folder and its files, after the preview        |
 
-The tools are thin wrappers over [`@publishq/sdk`](https://www.npmjs.com/package/@publishq/sdk), so their behavior and scopes match the [PublishQ API](https://publishq.com/docs). `publishq_create_post` accepts an `accounts` array whose entries contain `accountId` plus optional `postOverrides` and `platformSpecificSettings`. `publishq_update_post` accepts content, scheduling, complete media replacement or removal, and thumbnail timestamp changes. `publishq_list_media` can filter by media IDs, types, and sources. For TikTok, the agent should call `publishq_get_tiktok_creator_info` first and then provide the required privacy and interaction settings in that account object. A tool call that hits an API error returns the API error so the agent can react.
+The tools are thin wrappers over [`@publishq/sdk`](https://www.npmjs.com/package/@publishq/sdk), so their behavior and scopes match the [PublishQ API](https://publishq.com/docs). `publishq_create_post` accepts an `accounts` array whose entries contain `accountId` plus optional `postOverrides` and `platformSpecificSettings`. `publishq_update_post` accepts content, scheduling, complete media replacement or removal, and thumbnail timestamp changes. `publishq_list_media` can filter by media IDs, types, sources and folder, and `publishq_upload_media` takes a `folderPath`. Folder paths look like `Channel A/Shorts`. Before `publishq_delete_media_folder`, the agent calls `publishq_preview_media_folder_deletion`, shows the counts to the user and passes the `fileCount` back as `expectedFileCount`. For TikTok, the agent should call `publishq_get_tiktok_creator_info` first and then provide the required privacy and interaction settings in that account object. A tool call that hits an API error returns the API error so the agent can react.
 
 ## Scopes
 

package/dist/index.js

@@ -19,6 +19,7 @@ import {
   zCreateMediaUploadBody,
   zCreatePostBody,
   zCreateWorkspaceBody,
+  zDeleteMediaFolderBody,
   zDeleteMediaPath,
   zDeletePostPath,
   zGetMediaPath,
@@ -28,7 +29,10 @@ import {
   zListAccountsQuery,
   zListMediaQuery,
   zListPostsQuery,
+  zMoveMediaBody,
+  zPreviewMediaFolderDeletionQuery,
   zRemovePostAccountPath,
+  zRenameMediaFolderBody,
   zUpdatePostBody,
   zUpdatePostPath
 } from "@publishq/sdk";
@@ -284,6 +288,56 @@ function publishqTools(publishq2) {
     },
     (args) => run(publishq2.media.delete(args.id))
   );
+  register(
+    {
+      name: "publishq_list_media_folders",
+      title: "List media folders",
+      description: 'List every folder in the media library, parents before subfolders, with the number of files in each folder and its subfolders. Folder paths look like "Channel A/Shorts". Use a path as folderPath in publishq_list_media, publishq_upload_media or publishq_move_media.',
+      inputSchema: { type: "object", properties: {}, additionalProperties: false },
+      annotations: { readOnlyHint: true, openWorldHint: true }
+    },
+    () => run(publishq2.media.listFolders())
+  );
+  register(
+    {
+      name: "publishq_move_media",
+      title: "Move media to a folder",
+      description: 'Move up to 100 media files to a folder by path, for example "Channel A/Shorts", or to the top level with folderPath null. A folder that does not exist yet is created by moving files into it. Posts keep working: they use media IDs, not folders.',
+      inputSchema: advertisedSchema(zMoveMediaBody),
+      annotations: { readOnlyHint: false, idempotentHint: true, openWorldHint: true }
+    },
+    (args) => run(publishq2.media.move(args))
+  );
+  register(
+    {
+      name: "publishq_rename_media_folder",
+      title: "Rename a media folder",
+      description: "Rename a media folder. Only the last part of the path changes, and its files and subfolders follow. Answers 404 when no folder has that path (check publishq_list_media_folders), and is refused when a folder with the new name already exists at the same level.",
+      inputSchema: advertisedSchema(zRenameMediaFolderBody),
+      annotations: { readOnlyHint: false, openWorldHint: true }
+    },
+    (args) => run(publishq2.media.renameFolder(args))
+  );
+  register(
+    {
+      name: "publishq_preview_media_folder_deletion",
+      title: "Preview deleting a media folder",
+      description: "Count what deleting a media folder would remove: files and subfolders at every level, and files kept because a draft or scheduled post uses them. Call this first, show the numbers to the user and get their confirmation before publishq_delete_media_folder.",
+      inputSchema: advertisedSchema(zPreviewMediaFolderDeletionQuery),
+      annotations: { readOnlyHint: true, openWorldHint: true }
+    },
+    (args) => run(publishq2.media.previewFolderDeletion(args.path))
+  );
+  register(
+    {
+      name: "publishq_delete_media_folder",
+      title: "Delete a media folder",
+      description: "Delete a media folder with every file in it and in its subfolders, from the media library and from storage. This cannot be undone. Files a draft or scheduled post uses are kept. Only call it after the user confirmed the numbers from publishq_preview_media_folder_deletion, and send that fileCount as expectedFileCount; if the folder changed since, nothing is deleted.",
+      inputSchema: advertisedSchema(zDeleteMediaFolderBody),
+      annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: true }
+    },
+    (args) => run(publishq2.media.deleteFolder(args))
+  );
   return tools;
 }
 function createPublishQServer(tools) {
@@ -342,6 +396,10 @@ var server = createPublishQServer([
           filename: {
             type: "string",
             description: "Override the uploaded file name"
+          },
+          folderPath: {
+            type: "string",
+            description: 'Folder to put the file in, for example "Channel A/Shorts". Leave it out for the top level. See publishq_list_media_folders.'
           }
         },
         required: ["filePath"],
@@ -352,6 +410,7 @@ var server = createPublishQServer([
     handler: async (args) => {
       const filePath = args.filePath;
       const filename = args.filename;
+      const folderPath = args.folderPath;
       if (statSync(filePath).size >= OPEN_AS_BLOB_MAX_BYTES) {
         return {
           content: [
@@ -367,7 +426,12 @@ var server = createPublishQServer([
         [await openAsBlob(filePath)],
         filename ?? basename(filePath)
       );
-      return run(publishq.media.upload({ file }));
+      return run(
+        publishq.media.upload(
+          { file },
+          folderPath !== void 0 ? { folderPath } : void 0
+        )
+      );
     }
   }
 ]);

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@publishq/mcp",
-  "version": "0.0.7",
+  "version": "1.0.0",
+  "mcpName": "com.publishq/publishq",
   "private": false,
   "description": "Model Context Protocol (MCP) server for PublishQ. Let AI agents schedule and publish across your social platforms.",
   "license": "Apache-2.0",
@@ -31,7 +32,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "1.29.0",
     "zod": "4.4.3",
-    "@publishq/sdk": "^0.0.7"
+    "@publishq/sdk": "^1.0.0"
   },
   "devDependencies": {
     "@types/node": "^20",