@publishq/mcp 0.0.1 → 0.0.2

package/README.md

@@ -18,7 +18,7 @@ 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
 
@@ -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.
 

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);
 }
@@ -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,6 +1,6 @@
 {
   "name": "@publishq/mcp",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "private": false,
   "description": "Model Context Protocol (MCP) server for PublishQ — let AI agents schedule and publish across your social platforms.",
   "license": "Apache-2.0",
@@ -25,8 +25,8 @@
   ],
   "dependencies": {
     "@modelcontextprotocol/sdk": "1.29.0",
-    "zod": "4.4.3",
-    "@publishq/sdk": "^0.0.1"
+    "@publishq/sdk": "^0.0.2",
+    "zod": "4.4.3"
   },
   "devDependencies": {
     "@types/node": "^20",