@publishq/mcp 0.0.6 → 0.0.8

package/README.md

@@ -51,10 +51,7 @@ Add this to your `claude_desktop_config.json`:
   "mcpServers": {
     "publishq": {
       "command": "npx",
-      "args": ["-y", "@publishq/mcp@latest"],
-      "env": {
-        "PUBLISHQ_API_KEY": "pq_live_your_key_here"
-      }
+      "args": ["-y", "@publishq/mcp@latest"]
     }
   }
 }
@@ -91,9 +88,15 @@ Any MCP client that launches a stdio server works the same way: run the command
 | `publishq_list_media`               | List uploaded/generated media                           |
 | `publishq_get_media`                | Get one media file by ID                                |
 | `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

@@ -16,8 +16,10 @@ import {
   McpError
 } from "@modelcontextprotocol/sdk/types.js";
 import {
+  zCreateMediaUploadBody,
   zCreatePostBody,
   zCreateWorkspaceBody,
+  zDeleteMediaFolderBody,
   zDeleteMediaPath,
   zDeletePostPath,
   zGetMediaPath,
@@ -27,7 +29,10 @@ import {
   zListAccountsQuery,
   zListMediaQuery,
   zListPostsQuery,
+  zMoveMediaBody,
+  zPreviewMediaFolderDeletionQuery,
   zRemovePostAccountPath,
+  zRenameMediaFolderBody,
   zUpdatePostBody,
   zUpdatePostPath
 } from "@publishq/sdk";
@@ -66,8 +71,38 @@ async function run(call) {
     return errorResult(error);
   }
 }
+var isPlainObject = (value) => !!value && typeof value === "object" && !Array.isArray(value);
+var isAnnotationOnly = (node) => isPlainObject(node) && Object.keys(node).every((key) => key === "description" || key === "title");
+var isEmpty = (value) => isPlainObject(value) && Object.keys(value).length === 0;
+function booleanSchema(value) {
+  if (isEmpty(value)) return true;
+  if (isPlainObject(value) && Object.keys(value).length === 1 && isEmpty(value.not)) {
+    return false;
+  }
+  return void 0;
+}
+function portableSchema(node) {
+  if (Array.isArray(node)) return node.map(portableSchema);
+  if (!isPlainObject(node)) return node;
+  const result = {};
+  for (const [key, value] of Object.entries(node)) {
+    result[key] = key === "additionalProperties" ? booleanSchema(value) ?? portableSchema(value) : portableSchema(value);
+  }
+  const allOf = result.allOf;
+  if (Array.isArray(allOf)) {
+    const annotations = allOf.filter(isAnnotationOnly);
+    const schemas = allOf.filter((member) => !isAnnotationOnly(member));
+    if (annotations.length > 0 && schemas.length === 1 && isPlainObject(schemas[0])) {
+      delete result.allOf;
+      return { ...Object.assign({}, ...annotations), ...schemas[0], ...result };
+    }
+  }
+  return result;
+}
 function advertisedSchema(schema) {
-  const jsonSchema = toJSONSchema(schema, { io: "input", target: "draft-7" });
+  const jsonSchema = portableSchema(
+    toJSONSchema(schema, { io: "input", target: "draft-7" })
+  );
   if (jsonSchema.type !== "object") {
     throw new Error("MCP tool input schema must describe an object.");
   }
@@ -233,6 +268,16 @@ function publishqTools(publishq2) {
     },
     (args) => run(publishq2.media.get(args.id))
   );
+  register(
+    {
+      name: "publishq_create_media_upload",
+      title: "Start a media upload",
+      description: 'Get a signed upload URL for a file of up to 4 GB on the machine you run commands on, and the media ID it becomes. Send the file with a PUT to uploadUrl, with the same Content-Type and no Authorization header, for example `curl -X PUT -H "Content-Type: image/jpeg" --upload-file ./photo.jpg "<uploadUrl>"`. Then attach the media ID to a post through mediaIds. The URL expires after an hour.',
+      inputSchema: advertisedSchema(zCreateMediaUploadBody),
+      annotations: { readOnlyHint: false, openWorldHint: true }
+    },
+    (args) => run(publishq2.media.createUpload(args))
+  );
   register(
     {
       name: "publishq_delete_media",
@@ -243,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) {
@@ -301,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"],
@@ -311,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: [
@@ -326,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,6 @@
 {
   "name": "@publishq/mcp",
-  "version": "0.0.6",
+  "version": "0.0.8",
   "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 +31,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "1.29.0",
     "zod": "4.4.3",
-    "@publishq/sdk": "^0.0.6"
+    "@publishq/sdk": "^0.0.8"
   },
   "devDependencies": {
     "@types/node": "^20",