@publishq/mcp 1.0.0 → 1.0.1

package/dist/index.js

@@ -37,6 +37,67 @@ import {
   zUpdatePostPath
 } from "@publishq/sdk";
 import { toJSONSchema } from "zod/v4-mini";
+
+// package.json
+var package_default = {
+  name: "@publishq/mcp",
+  version: "1.0.1",
+  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",
+  author: "PublishQ",
+  repository: {
+    type: "git",
+    url: "git+https://github.com/alexand-ro/2-publishq.git",
+    directory: "packages/mcp"
+  },
+  homepage: "https://publishq.com",
+  keywords: [
+    "publishq",
+    "mcp",
+    "model-context-protocol",
+    "ai-agent",
+    "claude",
+    "social-media"
+  ],
+  type: "module",
+  bin: {
+    "publishq-mcp": "./dist/index.js"
+  },
+  files: [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  scripts: {
+    build: "tsup",
+    dev: "tsup --watch",
+    typecheck: "tsc --noEmit",
+    lint: "eslint src tests --max-warnings 0",
+    test: "pnpm build && vitest run",
+    prepublishOnly: "npm run build"
+  },
+  dependencies: {
+    "@modelcontextprotocol/sdk": "1.29.0",
+    "@publishq/sdk": "workspace:^",
+    zod: "4.4.3"
+  },
+  devDependencies: {
+    "@types/node": "^20",
+    tsup: "^8.5.1",
+    typescript: "^5",
+    vitest: "3.2.4"
+  },
+  engines: {
+    node: ">=20"
+  },
+  publishConfig: {
+    access: "public"
+  }
+};
+
+// src/tools.ts
 function describeError(error) {
   const cause = error.cause;
   if (cause instanceof Error) {
@@ -134,7 +195,7 @@ function publishqTools(publishq2) {
       title: "List posts",
       description: "List the posts on the authenticated PublishQ account. Paginated. Each post includes its connected accounts and status (DRAFT, SCHEDULED, PUBLISHING, PUBLISHED, FAILED).",
       inputSchema: advertisedSchema(zListPostsQuery),
-      annotations: { readOnlyHint: true, openWorldHint: true }
+      annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: true }
     },
     (args) => run(publishq2.posts.list(args))
   );
@@ -144,7 +205,7 @@ function publishqTools(publishq2) {
       title: "Get a post",
       description: "Get one post by its PublishQ post ID.",
       inputSchema: advertisedSchema(zGetPostPath),
-      annotations: { readOnlyHint: true, openWorldHint: true }
+      annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: true }
     },
     (args) => run(publishq2.posts.get(args.id))
   );
@@ -154,7 +215,7 @@ function publishqTools(publishq2) {
       title: "Create a post",
       description: "Create a post for one or more connected accounts. Get account IDs from publishq_list_accounts. Each account accepts postOverrides and platformSpecificSettings. Before posting to TikTok, call publishq_get_tiktok_creator_info and include all required TikTok settings. Omit both scheduledAt and publishNow to save as a draft; set publishNow to publish immediately, or scheduledAt (ISO 8601) to schedule for later.",
       inputSchema: advertisedSchema(zCreatePostBody),
-      annotations: { readOnlyHint: false, openWorldHint: true }
+      annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: true }
     },
     (args) => run(publishq2.posts.create(args))
   );
@@ -164,7 +225,12 @@ function publishqTools(publishq2) {
       title: "Update a post",
       description: "Update a draft or scheduled post. Supports content, scheduledAt, complete media replacement/removal through mediaIds, thumbnailTimestamp, and accounts (each with postOverrides and platformSpecificSettings, for example a YouTube thumbnailMediaId). Only the fields you send change; send a field as null to remove it. Published and publishing posts cannot be updated.",
       inputSchema: mergedAdvertisedSchema(zUpdatePostPath, zUpdatePostBody),
-      annotations: { readOnlyHint: false, idempotentHint: true, openWorldHint: true }
+      annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true
+      }
     },
     (args) => {
       const { id, ...body } = args;
@@ -204,7 +270,7 @@ function publishqTools(publishq2) {
       title: "List connected accounts",
       description: "List the social accounts connected to the authenticated PublishQ account. Optionally filter by workspace and platform. Use the returned account IDs when creating posts.",
       inputSchema: advertisedSchema(zListAccountsQuery),
-      annotations: { readOnlyHint: true, openWorldHint: true }
+      annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: true }
     },
     (args) => run(publishq2.accounts.list(args))
   );
@@ -214,7 +280,7 @@ function publishqTools(publishq2) {
       title: "Get TikTok creator info",
       description: "Get a TikTok account's current privacy options, interaction settings, and max video duration. Call this before creating a TikTok post. The privacyLevel you set must be one of the returned privacyLevelOptions.",
       inputSchema: advertisedSchema(zGetTikTokCreatorInfoPath),
-      annotations: { readOnlyHint: true, openWorldHint: true }
+      annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: true }
     },
     (args) => run(publishq2.accounts.getTikTokCreatorInfo(args.id))
   );
@@ -224,7 +290,7 @@ function publishqTools(publishq2) {
       title: "List workspaces",
       description: "List your workspaces, including their names, colors, and account counts.",
       inputSchema: { type: "object", properties: {} },
-      annotations: { readOnlyHint: true, openWorldHint: true }
+      annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: true }
     },
     () => run(publishq2.workspaces.list())
   );
@@ -234,7 +300,7 @@ function publishqTools(publishq2) {
       title: "Get a workspace",
       description: "Get one workspace by its ID.",
       inputSchema: advertisedSchema(zGetWorkspacePath),
-      annotations: { readOnlyHint: true, openWorldHint: true }
+      annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: true }
     },
     (args) => run(publishq2.workspaces.get(args.id))
   );
@@ -244,7 +310,7 @@ function publishqTools(publishq2) {
       title: "Create a workspace",
       description: "Create a workspace to organize your connected accounts.",
       inputSchema: advertisedSchema(zCreateWorkspaceBody),
-      annotations: { readOnlyHint: false, openWorldHint: true }
+      annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: true }
     },
     (args) => run(publishq2.workspaces.create(args))
   );
@@ -254,7 +320,7 @@ function publishqTools(publishq2) {
       title: "List media",
       description: "List your uploaded and generated media files. Optionally filter by media ID, type, and source.",
       inputSchema: advertisedSchema(zListMediaQuery),
-      annotations: { readOnlyHint: true, openWorldHint: true }
+      annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: true }
     },
     (args) => run(publishq2.media.list(args))
   );
@@ -264,7 +330,7 @@ function publishqTools(publishq2) {
       title: "Get a media file",
       description: "Get one media file by its ID, including its URL and usage.",
       inputSchema: advertisedSchema(zGetMediaPath),
-      annotations: { readOnlyHint: true, openWorldHint: true }
+      annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: true }
     },
     (args) => run(publishq2.media.get(args.id))
   );
@@ -274,7 +340,7 @@ function publishqTools(publishq2) {
       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 }
+      annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: true }
     },
     (args) => run(publishq2.media.createUpload(args))
   );
@@ -294,7 +360,7 @@ function publishqTools(publishq2) {
       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 }
+      annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: true }
     },
     () => run(publishq2.media.listFolders())
   );
@@ -304,7 +370,12 @@ function publishqTools(publishq2) {
       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 }
+      annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true
+      }
     },
     (args) => run(publishq2.media.move(args))
   );
@@ -314,7 +385,7 @@ function publishqTools(publishq2) {
       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 }
+      annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: true }
     },
     (args) => run(publishq2.media.renameFolder(args))
   );
@@ -324,7 +395,7 @@ function publishqTools(publishq2) {
       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 }
+      annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: true }
     },
     (args) => run(publishq2.media.previewFolderDeletion(args.path))
   );
@@ -340,10 +411,17 @@ function publishqTools(publishq2) {
   );
   return tools;
 }
+var PUBLISHQ_SERVER_DESCRIPTION = "Schedule and publish social media posts, organize media, and keep each brand in its own workspace.";
 function createPublishQServer(tools) {
   const byName = new Map(tools.map((tool) => [tool.definition.name, tool]));
   const server2 = new McpServer(
-    { name: "publishq", version: "0.1.0" },
+    {
+      name: "publishq",
+      title: "PublishQ",
+      version: package_default.version,
+      description: PUBLISHQ_SERVER_DESCRIPTION,
+      websiteUrl: "https://publishq.com"
+    },
     { capabilities: { tools: {} } }
   );
   server2.server.setRequestHandler(ListToolsRequestSchema, async () => ({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@publishq/mcp",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "mcpName": "com.publishq/publishq",
   "private": false,
   "description": "Model Context Protocol (MCP) server for PublishQ. Let AI agents schedule and publish across your social platforms.",