@publishq/mcp 0.0.1 → 0.0.3

package/README.md

@@ -12,13 +12,13 @@
   <strong>A Model Context Protocol server that lets AI agents schedule and publish across your social platforms through PublishQ.</strong>
 </p>
 
-This is the official [MCP](https://modelcontextprotocol.io) server for [PublishQ](https://publishq.com). Point Claude Desktop, Cursor, or any MCP-compatible agent at it and they can list your connected accounts, create and schedule posts, manage workspaces, and upload media — all through the [PublishQ API](https://publishq.com/docs).
+This is the official [MCP](https://modelcontextprotocol.io) server for [PublishQ](https://publishq.com). Point Claude Desktop, Cursor, or any MCP-compatible agent at it and they can list your connected accounts, create and schedule posts, manage workspaces, and upload media, all through the [PublishQ API](https://publishq.com/docs).
 
 It runs locally over stdio and talks to the PublishQ API using your API key.
 
 ## Setup
 
-You need a PublishQ API key. Create one under **Settings → API Keys** in the PublishQ dashboard (it starts with `pq_live_`).
+You need a PublishQ API key. Create one under **API Keys** in the PublishQ dashboard (it starts with `pq_live_`).
 
 ### Claude Desktop
 
@@ -29,7 +29,7 @@ Add this to your `claude_desktop_config.json`:
   "mcpServers": {
     "publishq": {
       "command": "npx",
-      "args": ["-y", "@publishq/mcp"],
+      "args": ["-y", "@publishq/mcp@latest"],
       "env": {
         "PUBLISHQ_API_KEY": "pq_live_your_key_here"
       }
@@ -42,7 +42,7 @@ Restart Claude Desktop and you'll see the PublishQ tools available. Now you can
 
 ### Other clients (Cursor, Windsurf, etc.)
 
-Any MCP client that launches a stdio server works the same way — run the command `npx -y @publishq/mcp` with `PUBLISHQ_API_KEY` set in the environment.
+Any MCP client that launches a stdio server works the same way: run the command `npx -y @publishq/mcp@latest` with `PUBLISHQ_API_KEY` set in the environment.
 
 ## Configuration
 
@@ -68,7 +68,7 @@ Any MCP client that launches a stdio server works the same way — run the comma
 | `publishq_create_workspace`         | Create a workspace                                      |
 | `publishq_list_media`               | List uploaded/generated media                           |
 | `publishq_get_media`                | Get one media file by ID                                |
-| `publishq_upload_media`             | Upload a local file and get a media ID                  |
+| `publishq_upload_media`             | Upload a local file (up to 4 GB) and get a media ID     |
 
 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.
 
@@ -78,8 +78,8 @@ Tools require the same API-key scopes as the underlying endpoints: `posts:read`/
 
 ## Related
 
-- [`@publishq/sdk`](https://www.npmjs.com/package/@publishq/sdk) — the TypeScript SDK this server is built on.
-- [`@publishq/cli`](https://www.npmjs.com/package/@publishq/cli) — command-line interface for the same API.
+- [`@publishq/sdk`](https://www.npmjs.com/package/@publishq/sdk): the TypeScript SDK this server is built on.
+- [`@publishq/cli`](https://www.npmjs.com/package/@publishq/cli): command-line interface for the same API.
 
 ## License
 

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { readFileSync } from "fs";
+import { openAsBlob, statSync } from "fs";
 import { basename } from "path";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
@@ -27,10 +27,11 @@ import PublishQ, {
   zUpdatePostPath
 } from "@publishq/sdk";
 import { toJSONSchema } from "zod/v4-mini";
+var OPEN_AS_BLOB_MAX_BYTES = 2 ** 32;
 var API_KEY = process.env.PUBLISHQ_API_KEY;
 if (!API_KEY) {
   console.error(
-    "ERROR: PUBLISHQ_API_KEY environment variable is required. Create a key at https://publishq.com/app/settings."
+    "ERROR: PUBLISHQ_API_KEY environment variable is required. Create a key at https://publishq.com/app/api-keys."
   );
   process.exit(1);
 }
@@ -132,7 +133,7 @@ registerTool(
   {
     name: "publishq_update_post",
     title: "Update a post",
-    description: "Update a draft or scheduled post. Supports content, scheduledAt, complete media replacement/removal through mediaIds, and thumbnailTimestamp. Published and publishing posts cannot be updated.",
+    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 }
   },
@@ -182,7 +183,7 @@ registerTool(
   {
     name: "publishq_get_tiktok_creator_info",
     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 \u2014 the privacyLevel you set must be one of the returned privacyLevelOptions.",
+    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 }
   },
@@ -242,7 +243,7 @@ registerTool(
   {
     name: "publishq_upload_media",
     title: "Upload a media file",
-    description: "Upload a local media file to PublishQ and get back a media ID you can attach to posts via publishq_create_post (mediaIds). The file is read from the local filesystem where this MCP server runs.",
+    description: "Upload a local media file of up to 4 GB to PublishQ and get back a media ID you can attach to posts via publishq_create_post (mediaIds). The file is read from the local filesystem where this MCP server runs.",
     inputSchema: {
       type: "object",
       properties: {
@@ -260,11 +261,24 @@ registerTool(
     },
     annotations: { readOnlyHint: false, openWorldHint: true }
   },
-  (args) => {
+  async (args) => {
     const filePath = args.filePath;
     const filename = args.filename;
-    const buffer = readFileSync(filePath);
-    const file = new File([buffer], filename ?? basename(filePath));
+    if (statSync(filePath).size >= OPEN_AS_BLOB_MAX_BYTES) {
+      return {
+        content: [
+          {
+            type: "text",
+            text: `${filePath} is too big to upload: files must be smaller than 4 GB.`
+          }
+        ],
+        isError: true
+      };
+    }
+    const file = new File(
+      [await openAsBlob(filePath)],
+      filename ?? basename(filePath)
+    );
     return run(publishq.media.upload({ file }));
   }
 );

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@publishq/mcp",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "private": false,
-  "description": "Model Context Protocol (MCP) server for PublishQ — let AI agents schedule and publish across your social platforms.",
+  "description": "Model Context Protocol (MCP) server for PublishQ. Let AI agents schedule and publish across your social platforms.",
   "license": "Apache-2.0",
   "author": "PublishQ",
   "homepage": "https://publishq.com",
@@ -25,8 +25,8 @@
   ],
   "dependencies": {
     "@modelcontextprotocol/sdk": "1.29.0",
-    "zod": "4.4.3",
-    "@publishq/sdk": "^0.0.1"
+    "@publishq/sdk": "^0.0.3",
+    "zod": "4.4.3"
   },
   "devDependencies": {
     "@types/node": "^20",