posterly-mcp-server 0.19.6 → 0.19.8

package/README.md

@@ -4,48 +4,43 @@ Use Posterly from any MCP-compatible AI client.
 
 This package gives Claude Desktop, Cursor, Windsurf, Cline, and other local MCP clients a `stdio` server that can:
 
-- start paid Posterly signup before an API key exists
-- poll signup progress while the user completes checkout and password setup
 - list connected social accounts
 - resolve brands/clients into the right accounts
 - schedule and manage posts
 - upload media
+- generate captions
 - generate images
 - read account and post analytics
 
+Tool results are returned as Markdown-first chat summaries with headings, compact tables, short next-step notes, and occasional status icons. MCP clients may still rephrase the final answer, but the raw tool content is designed to look good directly in chat.
+
 Posterly also exposes the same toolset over HTTP at [poster.ly/mcp](https://www.poster.ly/mcp), but this npm package is the local `stdio` transport.
 
 ## Requirements
 
 - Node.js `20+`
-- No API key is required for the public signup tools: `get_agent_signup_info`, `start_signup`, and `get_signup_session`
-- A Posterly account, API add-on, and API key are required for authenticated tools like `whoami`, `list_accounts`, `create_connect_session`, and `create_post`
+- A Posterly account: [poster.ly/signup](https://www.poster.ly/signup)
+- The Posterly API add-on enabled: [poster.ly/dashboard/api](https://www.poster.ly/dashboard/api)
+- A Posterly API key
 
-## Install
+No API key is required for the public signup tools: `get_agent_signup_info`, `start_signup`, and `get_signup_session`.
 
-Recommended: use it via `npx` in your MCP config so your client runs the current server without a global install.
+## Install
 
-To let an AI agent start signup before a Posterly API key exists, install the server without `POSTERLY_API_KEY`:
+You can install globally:
 
-```json
-{
-  "mcpServers": {
-    "posterly": {
-      "command": "npx",
-      "args": ["-y", "posterly-mcp-server@latest"]
-    }
-  }
-}
+```bash
+npm install -g posterly-mcp-server
 ```
 
-After paid signup is complete and Posterly shows an API key, add `POSTERLY_API_KEY` to unlock the authenticated tools:
+Or just use it via `npx` in your MCP config:
 
 ```json
 {
   "mcpServers": {
     "posterly": {
       "command": "npx",
-      "args": ["-y", "posterly-mcp-server@latest"],
+      "args": ["-y", "posterly-mcp-server"],
       "env": {
         "POSTERLY_API_KEY": "pst_live_your_key_here"
       }
@@ -56,12 +51,12 @@ After paid signup is complete and Posterly shows an API key, add `POSTERLY_API_K
 
 ## Quick setup
 
-1. Add the Posterly MCP server to your AI client.
-2. If you do not have Posterly yet, ask the AI to call `start_signup`.
-3. Pay in Stripe Checkout and set your Posterly password in the browser.
-4. When Posterly shows your API key, add it as `POSTERLY_API_KEY`.
-5. Restart your AI client.
-6. Ask the AI to call `whoami`, then continue by connecting your first social account.
+1. Sign up at [poster.ly](https://www.poster.ly/signup)
+2. Go to [Dashboard → API & MCP](https://www.poster.ly/dashboard/api)
+3. Enable the API add-on
+4. Generate an API key
+5. Paste it into your MCP client config as `POSTERLY_API_KEY`
+6. Restart your AI client
 
 ## Example configs
 
@@ -74,7 +69,7 @@ Add this to your Claude Desktop MCP config:
   "mcpServers": {
     "posterly": {
       "command": "npx",
-      "args": ["-y", "posterly-mcp-server@latest"],
+      "args": ["-y", "posterly-mcp-server"],
       "env": {
         "POSTERLY_API_KEY": "pst_live_your_key_here"
       }
@@ -92,7 +87,7 @@ Add the same server definition to your Cursor MCP settings:
   "mcpServers": {
     "posterly": {
       "command": "npx",
-      "args": ["-y", "posterly-mcp-server@latest"],
+      "args": ["-y", "posterly-mcp-server"],
       "env": {
         "POSTERLY_API_KEY": "pst_live_your_key_here"
       }
@@ -103,15 +98,15 @@ Add the same server definition to your Cursor MCP settings:
 
 ## Available tools
 
-`posterly-mcp-server@0.19.6` exposes 54 tools.
+`posterly-mcp-server@0.19.8` exposes 55 tools: 3 public signup helpers plus the 52 authenticated API/MCP tools.
 
-Public signup tools work before `POSTERLY_API_KEY` exists:
+Public signup helpers:
 
 - `get_agent_signup_info`
 - `start_signup` (start paid signup and return a Posterly checkout handoff URL)
 - `get_signup_session` (poll checkout, payment, password, and agent-access status)
 
-Authenticated tools require `POSTERLY_API_KEY`:
+Authenticated tools:
 
 - `whoami`
 - `list_accounts`
@@ -144,6 +139,7 @@ Authenticated tools require `POSTERLY_API_KEY`:
 - `upload_media_from_url`
 - `create_signed_upload`
 - `find_available_slot`
+- `generate_captions`
 - `generate_image`
 - `get_video_options`
 - `run_video_function` (read-only Veo helpers for cost estimation and request validation)
@@ -234,5 +230,5 @@ npm start
 
 The package reads:
 
-- optional `POSTERLY_API_KEY` for authenticated Posterly tools
+- `POSTERLY_API_KEY`
 - optional `POSTERLY_URL` if you need to point at a non-production environment

package/dist/generated/platform-manifest.d.ts

@@ -93,7 +93,7 @@ export declare const PLATFORM_MANIFEST: {
         readonly label: "TikTok";
         readonly status: "supported";
         readonly aliases: readonly [];
-        readonly postTypes: readonly ["video", "image"];
+        readonly postTypes: readonly ["video", "image", "carousel"];
         readonly analyticsSupported: false;
         readonly helpers: readonly ["tiktok.creator_info"];
     }, {

package/dist/generated/platform-manifest.js

@@ -279,7 +279,8 @@ export const PLATFORM_MANIFEST = {
             "aliases": [],
             "postTypes": [
                 "video",
-                "image"
+                "image",
+                "carousel"
             ],
             "analyticsSupported": false,
             "helpers": [