posterly-mcp-server 0.24.1 → 0.26.0

package/README.md

@@ -108,7 +108,7 @@ Add the same server definition to your Cursor MCP settings:
 
 ## Available tools
 
-`posterly-mcp-server@0.23.0` exposes 63 tools.
+`posterly-mcp-server@0.26.0` exposes 73 tools.
 
 Public setup tools work before `POSTERLY_API_KEY` exists:
 
@@ -127,6 +127,11 @@ Authenticated tools require `POSTERLY_API_KEY`:
 - `get_connect_session` (poll connection progress while the user approves OAuth or enters credentials)
 - `create_api_key` (create a new API key after explicit confirmation; scopes cannot exceed the calling dashboard key)
 - `delete_api_key` (revoke a user-created API key after explicit confirmation)
+- `get_subscription` (read subscription status, tier, and cancel/pause state; requires `billing:read`)
+- `cancel_subscription` (cancel after explicit confirmation; the agent must ask for a `reason` first; requires `billing:write`)
+- `pause_subscription` (pause 30 days, one per 90-day cooldown, after confirmation; requires `billing:write`)
+- `resume_subscription` (resume a paused subscription; requires `billing:write`)
+- `downgrade_subscription` (downgrade one tier at next renewal after confirmation; requires `billing:write`)
 - `list_oauth_clients`
 - `create_oauth_client` (create a public PKCE client after explicit confirmation)
 - `update_oauth_client` (update redirect URIs/scopes after explicit confirmation)
@@ -179,6 +184,7 @@ Authenticated tools require `POSTERLY_API_KEY`:
 > Google Business tip: pass `account_id` (the integer `id` from `list_accounts`) to every GBP tool. If you use `location_id` instead, it is the numeric `location_id` from `list_accounts` (the GBP location id), not the `ChIJ...` Place ID that `get_google_business_review_link` returns. Passing the Place ID resolves to no account and returns "Google Business Profile account not found".
 
 - `list_activity`
+- `get_updates` (read the latest posterly product updates and news)
 - `list_webhooks`
 - `create_webhook` (create a webhook after explicit confirmation)
 - `update_webhook` (update a webhook after explicit confirmation)
@@ -235,7 +241,7 @@ This package uses the Posterly API/MCP add-on:
 
 - `$3/month` add-on
 - `100 create-post requests/hour` per API key, with separate media/read limits
-- user-created API keys per plan: Starter 1, Pro 2, Power User 3, Agency 4
+- user-created API keys per plan: Starter 1, Pro 2, Power 3, Agency 4
 - works across all 17 supported platforms
 
 Each API call counts as one request, so use `create_posts_batch` when you need to schedule multiple posts in one confirmed operation.

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

@@ -1,9 +1,9 @@
 export declare const PLATFORM_MANIFEST: {
     readonly source: "lib/api-platform-registry.ts";
-    readonly supportedPlatformIds: readonly ["instagram", "facebook", "tiktok", "twitter", "linkedin", "youtube", "pinterest", "threads", "google_business", "telegram", "bluesky", "discord", "mastodon", "devto", "hashnode", "wordpress", "lemmy"];
-    readonly plannedPlatformIds: readonly ["reddit", "medium", "slack", "skool", "whop"];
-    readonly allPlatformIds: readonly ["instagram", "facebook", "tiktok", "twitter", "linkedin", "youtube", "pinterest", "threads", "google_business", "telegram", "bluesky", "discord", "mastodon", "devto", "hashnode", "wordpress", "lemmy", "reddit", "medium", "slack", "skool", "whop"];
-    readonly supportedPlatformInputs: readonly ["bluesky", "devto", "discord", "facebook", "gmb", "google-business", "google_business", "google_business_profile", "hashnode", "instagram", "instagram-standalone", "lemmy", "linkedin", "mastodon", "pinterest", "telegram", "threads", "tiktok", "twitter", "wordpress", "x", "youtube"];
+    readonly supportedPlatformIds: readonly ["instagram", "facebook", "tiktok", "twitter", "linkedin", "youtube", "pinterest", "threads", "google_business", "telegram", "bluesky", "discord", "slack", "mastodon", "devto", "hashnode", "wordpress", "lemmy"];
+    readonly plannedPlatformIds: readonly ["reddit", "medium", "skool", "whop"];
+    readonly allPlatformIds: readonly ["instagram", "facebook", "tiktok", "twitter", "linkedin", "youtube", "pinterest", "threads", "google_business", "telegram", "bluesky", "discord", "slack", "mastodon", "devto", "hashnode", "wordpress", "lemmy", "reddit", "medium", "skool", "whop"];
+    readonly supportedPlatformInputs: readonly ["bluesky", "devto", "discord", "facebook", "gmb", "google-business", "google_business", "google_business_profile", "hashnode", "instagram", "instagram-standalone", "lemmy", "linkedin", "mastodon", "pinterest", "slack", "telegram", "threads", "tiktok", "twitter", "wordpress", "x", "youtube"];
     readonly allPlatformInputs: readonly ["bluesky", "devto", "discord", "facebook", "gmb", "google-business", "google_business", "google_business_profile", "hashnode", "instagram", "instagram-standalone", "lemmy", "linkedin", "mastodon", "medium", "pinterest", "reddit", "skool", "slack", "telegram", "threads", "tiktok", "twitter", "whop", "wordpress", "x", "youtube"];
     readonly platformAliases: {
         readonly bluesky: "bluesky";
@@ -35,7 +35,7 @@ export declare const PLATFORM_MANIFEST: {
     };
     readonly helperNames: readonly ["linkedin.recent_mentions", "pinterest.boards", "tiktok.creator_info", "x.quota"];
     readonly analyticsPlatformIds: readonly ["instagram", "facebook", "linkedin", "youtube", "pinterest", "threads", "google_business"];
-    readonly connectTargetIds: readonly ["instagram", "meta", "facebook", "youtube", "tiktok", "linkedin", "linkedin_page", "threads", "google_business", "pinterest", "twitter", "telegram", "bluesky", "discord", "mastodon", "devto", "hashnode", "wordpress", "lemmy", "reddit", "medium", "slack", "skool", "whop"];
+    readonly connectTargetIds: readonly ["instagram", "meta", "facebook", "youtube", "tiktok", "linkedin", "linkedin_page", "threads", "google_business", "pinterest", "twitter", "telegram", "bluesky", "discord", "slack", "mastodon", "devto", "hashnode", "wordpress", "lemmy", "reddit", "medium", "skool", "whop"];
     readonly connectInputs: readonly ["bluesky", "devto", "discord", "facebook", "facebook_instagram", "facebook_pages", "gmb", "google-business", "google_business", "google_business_profile", "hashnode", "instagram", "instagram-standalone", "instagram_direct", "lemmy", "linkedin", "linkedin-company", "linkedin-page", "linkedin_company", "linkedin_page", "linkedin_personal", "mastodon", "medium", "meta", "meta_business", "pinterest", "reddit", "skool", "slack", "telegram", "threads", "tiktok", "twitter", "whop", "wordpress", "x", "x_twitter", "youtube"];
     readonly connectAliases: {
         readonly bluesky: "bluesky";
@@ -170,6 +170,14 @@ export declare const PLATFORM_MANIFEST: {
         readonly postTypes: readonly ["text", "image", "video", "carousel"];
         readonly analyticsSupported: false;
         readonly helpers: readonly [];
+    }, {
+        readonly id: "slack";
+        readonly label: "Slack";
+        readonly status: "supported";
+        readonly aliases: readonly [];
+        readonly postTypes: readonly ["text", "image", "video", "carousel"];
+        readonly analyticsSupported: false;
+        readonly helpers: readonly [];
     }, {
         readonly id: "mastodon";
         readonly label: "Mastodon";
@@ -226,14 +234,6 @@ export declare const PLATFORM_MANIFEST: {
         readonly postTypes: readonly [];
         readonly analyticsSupported: false;
         readonly helpers: readonly [];
-    }, {
-        readonly id: "slack";
-        readonly label: "Slack";
-        readonly status: "planned";
-        readonly aliases: readonly [];
-        readonly postTypes: readonly [];
-        readonly analyticsSupported: false;
-        readonly helpers: readonly [];
     }, {
         readonly id: "skool";
         readonly label: "Skool";
@@ -335,6 +335,12 @@ export declare const PLATFORM_MANIFEST: {
         readonly status: "supported";
         readonly aliases: readonly [];
         readonly method: "manual_credentials";
+    }, {
+        readonly id: "slack";
+        readonly label: "Slack";
+        readonly status: "supported";
+        readonly aliases: readonly [];
+        readonly method: "dashboard_oauth";
     }, {
         readonly id: "mastodon";
         readonly label: "Mastodon";
@@ -377,12 +383,6 @@ export declare const PLATFORM_MANIFEST: {
         readonly status: "planned";
         readonly aliases: readonly [];
         readonly method: "planned";
-    }, {
-        readonly id: "slack";
-        readonly label: "Slack";
-        readonly status: "planned";
-        readonly aliases: readonly [];
-        readonly method: "planned";
     }, {
         readonly id: "skool";
         readonly label: "Skool";
@@ -397,12 +397,12 @@ export declare const PLATFORM_MANIFEST: {
         readonly method: "planned";
     }];
 };
-export declare const SUPPORTED_PLATFORM_IDS: readonly ["instagram", "facebook", "tiktok", "twitter", "linkedin", "youtube", "pinterest", "threads", "google_business", "telegram", "bluesky", "discord", "mastodon", "devto", "hashnode", "wordpress", "lemmy"];
-export declare const PLANNED_PLATFORM_IDS: readonly ["reddit", "medium", "slack", "skool", "whop"];
-export declare const ALL_PLATFORM_IDS: readonly ["instagram", "facebook", "tiktok", "twitter", "linkedin", "youtube", "pinterest", "threads", "google_business", "telegram", "bluesky", "discord", "mastodon", "devto", "hashnode", "wordpress", "lemmy", "reddit", "medium", "slack", "skool", "whop"];
-export declare const SUPPORTED_PLATFORM_INPUTS: readonly ["bluesky", "devto", "discord", "facebook", "gmb", "google-business", "google_business", "google_business_profile", "hashnode", "instagram", "instagram-standalone", "lemmy", "linkedin", "mastodon", "pinterest", "telegram", "threads", "tiktok", "twitter", "wordpress", "x", "youtube"];
+export declare const SUPPORTED_PLATFORM_IDS: readonly ["instagram", "facebook", "tiktok", "twitter", "linkedin", "youtube", "pinterest", "threads", "google_business", "telegram", "bluesky", "discord", "slack", "mastodon", "devto", "hashnode", "wordpress", "lemmy"];
+export declare const PLANNED_PLATFORM_IDS: readonly ["reddit", "medium", "skool", "whop"];
+export declare const ALL_PLATFORM_IDS: readonly ["instagram", "facebook", "tiktok", "twitter", "linkedin", "youtube", "pinterest", "threads", "google_business", "telegram", "bluesky", "discord", "slack", "mastodon", "devto", "hashnode", "wordpress", "lemmy", "reddit", "medium", "skool", "whop"];
+export declare const SUPPORTED_PLATFORM_INPUTS: readonly ["bluesky", "devto", "discord", "facebook", "gmb", "google-business", "google_business", "google_business_profile", "hashnode", "instagram", "instagram-standalone", "lemmy", "linkedin", "mastodon", "pinterest", "slack", "telegram", "threads", "tiktok", "twitter", "wordpress", "x", "youtube"];
 export declare const ALL_PLATFORM_INPUTS: readonly ["bluesky", "devto", "discord", "facebook", "gmb", "google-business", "google_business", "google_business_profile", "hashnode", "instagram", "instagram-standalone", "lemmy", "linkedin", "mastodon", "medium", "pinterest", "reddit", "skool", "slack", "telegram", "threads", "tiktok", "twitter", "whop", "wordpress", "x", "youtube"];
 export declare const PLATFORM_HELPER_NAMES: readonly ["linkedin.recent_mentions", "pinterest.boards", "tiktok.creator_info", "x.quota"];
-export declare const CONNECT_TARGET_IDS: readonly ["instagram", "meta", "facebook", "youtube", "tiktok", "linkedin", "linkedin_page", "threads", "google_business", "pinterest", "twitter", "telegram", "bluesky", "discord", "mastodon", "devto", "hashnode", "wordpress", "lemmy", "reddit", "medium", "slack", "skool", "whop"];
+export declare const CONNECT_TARGET_IDS: readonly ["instagram", "meta", "facebook", "youtube", "tiktok", "linkedin", "linkedin_page", "threads", "google_business", "pinterest", "twitter", "telegram", "bluesky", "discord", "slack", "mastodon", "devto", "hashnode", "wordpress", "lemmy", "reddit", "medium", "skool", "whop"];
 export declare const CONNECT_INPUTS: readonly ["bluesky", "devto", "discord", "facebook", "facebook_instagram", "facebook_pages", "gmb", "google-business", "google_business", "google_business_profile", "hashnode", "instagram", "instagram-standalone", "instagram_direct", "lemmy", "linkedin", "linkedin-company", "linkedin-page", "linkedin_company", "linkedin_page", "linkedin_personal", "mastodon", "medium", "meta", "meta_business", "pinterest", "reddit", "skool", "slack", "telegram", "threads", "tiktok", "twitter", "whop", "wordpress", "x", "x_twitter", "youtube"];
 export declare const ANALYTICS_PLATFORM_IDS: readonly ["instagram", "facebook", "linkedin", "youtube", "pinterest", "threads", "google_business"];

package/dist/generated/platform-manifest.js

@@ -14,6 +14,7 @@ export const PLATFORM_MANIFEST = {
         "telegram",
         "bluesky",
         "discord",
+        "slack",
         "mastodon",
         "devto",
         "hashnode",
@@ -23,7 +24,6 @@ export const PLATFORM_MANIFEST = {
     "plannedPlatformIds": [
         "reddit",
         "medium",
-        "slack",
         "skool",
         "whop"
     ],
@@ -40,6 +40,7 @@ export const PLATFORM_MANIFEST = {
         "telegram",
         "bluesky",
         "discord",
+        "slack",
         "mastodon",
         "devto",
         "hashnode",
@@ -47,7 +48,6 @@ export const PLATFORM_MANIFEST = {
         "lemmy",
         "reddit",
         "medium",
-        "slack",
         "skool",
         "whop"
     ],
@@ -67,6 +67,7 @@ export const PLATFORM_MANIFEST = {
         "linkedin",
         "mastodon",
         "pinterest",
+        "slack",
         "telegram",
         "threads",
         "tiktok",
@@ -162,6 +163,7 @@ export const PLATFORM_MANIFEST = {
         "telegram",
         "bluesky",
         "discord",
+        "slack",
         "mastodon",
         "devto",
         "hashnode",
@@ -169,7 +171,6 @@ export const PLATFORM_MANIFEST = {
         "lemmy",
         "reddit",
         "medium",
-        "slack",
         "skool",
         "whop"
     ],
@@ -435,6 +436,20 @@ export const PLATFORM_MANIFEST = {
             "analyticsSupported": false,
             "helpers": []
         },
+        {
+            "id": "slack",
+            "label": "Slack",
+            "status": "supported",
+            "aliases": [],
+            "postTypes": [
+                "text",
+                "image",
+                "video",
+                "carousel"
+            ],
+            "analyticsSupported": false,
+            "helpers": []
+        },
         {
             "id": "mastodon",
             "label": "Mastodon",
@@ -515,15 +530,6 @@ export const PLATFORM_MANIFEST = {
             "analyticsSupported": false,
             "helpers": []
         },
-        {
-            "id": "slack",
-            "label": "Slack",
-            "status": "planned",
-            "aliases": [],
-            "postTypes": [],
-            "analyticsSupported": false,
-            "helpers": []
-        },
         {
             "id": "skool",
             "label": "Skool",
@@ -663,6 +669,13 @@ export const PLATFORM_MANIFEST = {
             "aliases": [],
             "method": "manual_credentials"
         },
+        {
+            "id": "slack",
+            "label": "Slack",
+            "status": "supported",
+            "aliases": [],
+            "method": "dashboard_oauth"
+        },
         {
             "id": "mastodon",
             "label": "Mastodon",
@@ -712,13 +725,6 @@ export const PLATFORM_MANIFEST = {
             "aliases": [],
             "method": "planned"
         },
-        {
-            "id": "slack",
-            "label": "Slack",
-            "status": "planned",
-            "aliases": [],
-            "method": "planned"
-        },
         {
             "id": "skool",
             "label": "Skool",
@@ -735,12 +741,12 @@ export const PLATFORM_MANIFEST = {
         }
     ]
 };
-export const SUPPORTED_PLATFORM_IDS = ["instagram", "facebook", "tiktok", "twitter", "linkedin", "youtube", "pinterest", "threads", "google_business", "telegram", "bluesky", "discord", "mastodon", "devto", "hashnode", "wordpress", "lemmy"];
-export const PLANNED_PLATFORM_IDS = ["reddit", "medium", "slack", "skool", "whop"];
-export const ALL_PLATFORM_IDS = ["instagram", "facebook", "tiktok", "twitter", "linkedin", "youtube", "pinterest", "threads", "google_business", "telegram", "bluesky", "discord", "mastodon", "devto", "hashnode", "wordpress", "lemmy", "reddit", "medium", "slack", "skool", "whop"];
-export const SUPPORTED_PLATFORM_INPUTS = ["bluesky", "devto", "discord", "facebook", "gmb", "google-business", "google_business", "google_business_profile", "hashnode", "instagram", "instagram-standalone", "lemmy", "linkedin", "mastodon", "pinterest", "telegram", "threads", "tiktok", "twitter", "wordpress", "x", "youtube"];
+export const SUPPORTED_PLATFORM_IDS = ["instagram", "facebook", "tiktok", "twitter", "linkedin", "youtube", "pinterest", "threads", "google_business", "telegram", "bluesky", "discord", "slack", "mastodon", "devto", "hashnode", "wordpress", "lemmy"];
+export const PLANNED_PLATFORM_IDS = ["reddit", "medium", "skool", "whop"];
+export const ALL_PLATFORM_IDS = ["instagram", "facebook", "tiktok", "twitter", "linkedin", "youtube", "pinterest", "threads", "google_business", "telegram", "bluesky", "discord", "slack", "mastodon", "devto", "hashnode", "wordpress", "lemmy", "reddit", "medium", "skool", "whop"];
+export const SUPPORTED_PLATFORM_INPUTS = ["bluesky", "devto", "discord", "facebook", "gmb", "google-business", "google_business", "google_business_profile", "hashnode", "instagram", "instagram-standalone", "lemmy", "linkedin", "mastodon", "pinterest", "slack", "telegram", "threads", "tiktok", "twitter", "wordpress", "x", "youtube"];
 export const ALL_PLATFORM_INPUTS = ["bluesky", "devto", "discord", "facebook", "gmb", "google-business", "google_business", "google_business_profile", "hashnode", "instagram", "instagram-standalone", "lemmy", "linkedin", "mastodon", "medium", "pinterest", "reddit", "skool", "slack", "telegram", "threads", "tiktok", "twitter", "whop", "wordpress", "x", "youtube"];
 export const PLATFORM_HELPER_NAMES = ["linkedin.recent_mentions", "pinterest.boards", "tiktok.creator_info", "x.quota"];
-export const CONNECT_TARGET_IDS = ["instagram", "meta", "facebook", "youtube", "tiktok", "linkedin", "linkedin_page", "threads", "google_business", "pinterest", "twitter", "telegram", "bluesky", "discord", "mastodon", "devto", "hashnode", "wordpress", "lemmy", "reddit", "medium", "slack", "skool", "whop"];
+export const CONNECT_TARGET_IDS = ["instagram", "meta", "facebook", "youtube", "tiktok", "linkedin", "linkedin_page", "threads", "google_business", "pinterest", "twitter", "telegram", "bluesky", "discord", "slack", "mastodon", "devto", "hashnode", "wordpress", "lemmy", "reddit", "medium", "skool", "whop"];
 export const CONNECT_INPUTS = ["bluesky", "devto", "discord", "facebook", "facebook_instagram", "facebook_pages", "gmb", "google-business", "google_business", "google_business_profile", "hashnode", "instagram", "instagram-standalone", "instagram_direct", "lemmy", "linkedin", "linkedin-company", "linkedin-page", "linkedin_company", "linkedin_page", "linkedin_personal", "mastodon", "medium", "meta", "meta_business", "pinterest", "reddit", "skool", "slack", "telegram", "threads", "tiktok", "twitter", "whop", "wordpress", "x", "x_twitter", "youtube"];
 export const ANALYTICS_PLATFORM_IDS = ["instagram", "facebook", "linkedin", "youtube", "pinterest", "threads", "google_business"];

package/dist/index.js

@@ -50,6 +50,7 @@ import { listGoogleBusinessMediaTool } from './tools/list-google-business-media.
 import { addGoogleBusinessMediaTool } from './tools/add-google-business-media.js';
 import { deleteGoogleBusinessMediaTool } from './tools/delete-google-business-media.js';
 import { listActivityTool } from './tools/list-activity.js';
+import { getUpdatesTool } from './tools/get-updates.js';
 import { listWebhooksTool } from './tools/list-webhooks.js';
 import { createWebhookTool } from './tools/create-webhook.js';
 import { updateWebhookTool } from './tools/update-webhook.js';
@@ -66,6 +67,11 @@ import { createConnectSessionTool } from './tools/create-connect-session.js';
 import { getConnectSessionTool } from './tools/get-connect-session.js';
 import { createApiKeyTool } from './tools/create-api-key.js';
 import { deleteApiKeyTool } from './tools/delete-api-key.js';
+import { getSubscriptionTool } from './tools/get-subscription.js';
+import { cancelSubscriptionTool } from './tools/cancel-subscription.js';
+import { pauseSubscriptionTool } from './tools/pause-subscription.js';
+import { resumeSubscriptionTool } from './tools/resume-subscription.js';
+import { downgradeSubscriptionTool } from './tools/downgrade-subscription.js';
 import { listOAuthClientsTool } from './tools/list-oauth-clients.js';
 import { createOAuthClientTool } from './tools/create-oauth-client.js';
 import { updateOAuthClientTool } from './tools/update-oauth-client.js';
@@ -184,6 +190,51 @@ server.tool(deleteApiKeyTool.name, deleteApiKeyTool.description, deleteApiKeyToo
         return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
     }
 });
+server.tool(getSubscriptionTool.name, getSubscriptionTool.description, getSubscriptionTool.inputSchema.shape, async () => {
+    try {
+        const text = await getSubscriptionTool.execute(client);
+        return { content: [{ type: 'text', text }] };
+    }
+    catch (err) {
+        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+    }
+});
+server.tool(cancelSubscriptionTool.name, cancelSubscriptionTool.description, cancelSubscriptionTool.inputSchema.shape, async (input) => {
+    try {
+        const text = await cancelSubscriptionTool.execute(client, input);
+        return { content: [{ type: 'text', text }] };
+    }
+    catch (err) {
+        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+    }
+});
+server.tool(pauseSubscriptionTool.name, pauseSubscriptionTool.description, pauseSubscriptionTool.inputSchema.shape, async (input) => {
+    try {
+        const text = await pauseSubscriptionTool.execute(client, input);
+        return { content: [{ type: 'text', text }] };
+    }
+    catch (err) {
+        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+    }
+});
+server.tool(resumeSubscriptionTool.name, resumeSubscriptionTool.description, resumeSubscriptionTool.inputSchema.shape, async () => {
+    try {
+        const text = await resumeSubscriptionTool.execute(client);
+        return { content: [{ type: 'text', text }] };
+    }
+    catch (err) {
+        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+    }
+});
+server.tool(downgradeSubscriptionTool.name, downgradeSubscriptionTool.description, downgradeSubscriptionTool.inputSchema.shape, async (input) => {
+    try {
+        const text = await downgradeSubscriptionTool.execute(client, input);
+        return { content: [{ type: 'text', text }] };
+    }
+    catch (err) {
+        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+    }
+});
 server.tool(listOAuthClientsTool.name, listOAuthClientsTool.description, listOAuthClientsTool.inputSchema.shape, async () => {
     try {
         const text = await listOAuthClientsTool.execute(client);
@@ -625,6 +676,15 @@ server.tool(listActivityTool.name, listActivityTool.description, listActivityToo
         return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
     }
 });
+server.tool(getUpdatesTool.name, getUpdatesTool.description, getUpdatesTool.inputSchema.shape, async (input) => {
+    try {
+        const text = await getUpdatesTool.execute(client, input);
+        return { content: [{ type: 'text', text }] };
+    }
+    catch (err) {
+        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+    }
+});
 server.tool(listWebhooksTool.name, listWebhooksTool.description, listWebhooksTool.inputSchema.shape, async (input) => {
     try {
         const text = await listWebhooksTool.execute(client, input);

package/dist/lib/api-client.d.ts

@@ -237,7 +237,7 @@ export type AskSupportPayload = {
     request_human?: boolean;
     confirm_escalation?: boolean;
 };
-export type ApiKeyScope = 'accounts:read' | 'accounts:write' | 'posts:read' | 'posts:write' | 'media:write' | 'analytics:read';
+export type ApiKeyScope = 'accounts:read' | 'accounts:write' | 'posts:read' | 'posts:write' | 'media:write' | 'analytics:read' | 'billing:read' | 'billing:write';
 export type CreateApiKeyPayload = {
     name?: string;
     scopes?: ApiKeyScope[];
@@ -279,6 +279,43 @@ export type DeleteApiKeyResponse = {
         is_revoked?: boolean;
     };
 };
+export type SubscriptionTierName = 'starter' | 'pro' | 'power_user' | 'agency';
+export type SubscriptionSummary = {
+    id: string | null;
+    status: string | null;
+    tier: string | null;
+    cancel_at_period_end: boolean | null;
+    current_period_end: string | null;
+    trial_ends_at: string | null;
+    paused_at: string | null;
+    pause_resumes_at: string | null;
+    stripe_subscription_id: string | null;
+};
+export type SubscriptionSummaryResponse = {
+    subscription: SubscriptionSummary;
+};
+export type CancelSubscriptionPayload = {
+    reason: string;
+    feedback?: string;
+    immediate?: boolean;
+};
+export type CancelSubscriptionResponse = {
+    success: true;
+    immediate: boolean;
+    canceled_at: string | null;
+    cancel_at_period_end: boolean;
+};
+export type PauseSubscriptionResponse = {
+    success: true;
+    pause_resumes_at: string;
+};
+export type ResumeSubscriptionResponse = {
+    success: true;
+};
+export type DowngradeSubscriptionResponse = {
+    success: true;
+    tier: SubscriptionTierName;
+};
 export type AskSupportResponse = {
     success: boolean;
     workspace_id: string;
@@ -502,6 +539,22 @@ export interface ActivityResponse {
     total: number;
     limit: number;
 }
+export interface UpdateEntry {
+    slug: string;
+    title: string;
+    date: string;
+    version: string;
+    summary: string;
+    type: string | null;
+    areas: string[];
+    url: string;
+    image?: string;
+    video?: string;
+    content?: string;
+}
+export interface UpdatesResponse {
+    updates: UpdateEntry[];
+}
 export interface ApiWebhook {
     id: string;
     workspace_id: string | null;
@@ -698,6 +751,13 @@ export declare class PosterlyClient {
     deleteApiKey(keyId: string, data: {
         confirm: true;
     }): Promise<DeleteApiKeyResponse>;
+    getSubscription(): Promise<SubscriptionSummaryResponse>;
+    cancelSubscription(data: CancelSubscriptionPayload): Promise<CancelSubscriptionResponse>;
+    pauseSubscription(): Promise<PauseSubscriptionResponse>;
+    resumeSubscription(): Promise<ResumeSubscriptionResponse>;
+    downgradeSubscription(data: {
+        tier?: SubscriptionTierName;
+    }): Promise<DowngradeSubscriptionResponse>;
     listAccounts(params?: {
         workspace_id?: string;
     }): Promise<Account[]>;
@@ -962,6 +1022,11 @@ export declare class PosterlyClient {
         type?: 'all' | 'activity' | 'publish';
         limit?: number;
     }): Promise<ActivityResponse>;
+    getUpdates(params?: {
+        limit?: number;
+        since?: string;
+        include_content?: boolean;
+    }): Promise<UpdatesResponse>;
     listWebhooks(params?: {
         workspace_id?: string;
     }): Promise<{

package/dist/lib/api-client.js

@@ -122,6 +122,21 @@ export class PosterlyClient {
     async deleteApiKey(keyId, data) {
         return this.request('DELETE', `/api-keys/${encodeURIComponent(keyId)}`, data);
     }
+    async getSubscription() {
+        return this.request('GET', '/subscription');
+    }
+    async cancelSubscription(data) {
+        return this.request('POST', '/subscription/cancel', data);
+    }
+    async pauseSubscription() {
+        return this.request('POST', '/subscription/pause', {});
+    }
+    async resumeSubscription() {
+        return this.request('POST', '/subscription/resume', {});
+    }
+    async downgradeSubscription(data) {
+        return this.request('POST', '/subscription/downgrade', data);
+    }
     async listAccounts(params) {
         const searchParams = new URLSearchParams();
         if (params?.workspace_id)
@@ -401,6 +416,17 @@ export class PosterlyClient {
         const qs = searchParams.toString();
         return this.request('GET', `/activity${qs ? `?${qs}` : ''}`);
     }
+    async getUpdates(params) {
+        const searchParams = new URLSearchParams();
+        if (params?.limit)
+            searchParams.set('limit', String(params.limit));
+        if (params?.since)
+            searchParams.set('since', params.since);
+        if (params?.include_content)
+            searchParams.set('include_content', 'true');
+        const qs = searchParams.toString();
+        return this.request('GET', `/updates${qs ? `?${qs}` : ''}`);
+    }
     async listWebhooks(params) {
         const searchParams = new URLSearchParams();
         if (params?.workspace_id)

package/dist/lib/version.d.ts

@@ -1 +1 @@
-export declare const POSTERLY_MCP_VERSION = "0.24.1";
+export declare const POSTERLY_MCP_VERSION = "0.26.0";

package/dist/lib/version.js

@@ -5,4 +5,4 @@
 // tool set (minus the intentional pre-auth signup tools that only this stdio
 // package exposes). `npm run check:mcp-parity` enforces both the version match
 // and the tool-list match, and runs in the pre-commit hook.
-export const POSTERLY_MCP_VERSION = '0.24.1';
+export const POSTERLY_MCP_VERSION = '0.26.0';

package/dist/tools/cancel-subscription.d.ts

@@ -0,0 +1,30 @@
+import { z } from 'zod';
+import type { PosterlyClient } from '../lib/api-client.js';
+declare const CANCELLATION_REASONS: readonly ["too_expensive", "not_using", "missing_features", "technical_issues", "switching_service", "temporary_break", "other"];
+export declare const cancelSubscriptionTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        reason: z.ZodEnum<["too_expensive", "not_using", "missing_features", "technical_issues", "switching_service", "temporary_break", "other"]>;
+        feedback: z.ZodOptional<z.ZodString>;
+        immediate: z.ZodOptional<z.ZodBoolean>;
+        confirm: z.ZodLiteral<true>;
+    }, "strip", z.ZodTypeAny, {
+        confirm: true;
+        reason: "too_expensive" | "not_using" | "missing_features" | "technical_issues" | "switching_service" | "temporary_break" | "other";
+        feedback?: string | undefined;
+        immediate?: boolean | undefined;
+    }, {
+        confirm: true;
+        reason: "too_expensive" | "not_using" | "missing_features" | "technical_issues" | "switching_service" | "temporary_break" | "other";
+        feedback?: string | undefined;
+        immediate?: boolean | undefined;
+    }>;
+    execute(client: PosterlyClient, input: {
+        reason: (typeof CANCELLATION_REASONS)[number];
+        feedback?: string;
+        immediate?: boolean;
+        confirm: true;
+    }): Promise<string>;
+};
+export {};

package/dist/tools/cancel-subscription.js

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+import { mdKeyValue, mdSection, mdTitle } from '../lib/format.js';
+// Mirrors CANCELLATION_REASONS in the main app (lib/subscription-reasons.ts).
+// Kept in sync manually because the npm package cannot import from the app.
+const CANCELLATION_REASONS = [
+    'too_expensive',
+    'not_using',
+    'missing_features',
+    'technical_issues',
+    'switching_service',
+    'temporary_break',
+    'other',
+];
+function formatCanceled(result) {
+    return [
+        mdTitle(result.immediate ? 'Subscription cancelled immediately' : 'Subscription set to cancel at period end'),
+        mdSection('Details', mdKeyValue([
+            ['Immediate', result.immediate ? 'yes' : 'no'],
+            ['Cancel at period end', result.cancel_at_period_end ? 'yes' : 'no'],
+            ['Canceled at', result.canceled_at || 'at end of current period'],
+        ])),
+    ].join('\n\n');
+}
+export const cancelSubscriptionTool = {
+    name: 'cancel_subscription',
+    description: "Cancel the authenticated user's posterly subscription. DESTRUCTIVE billing action; requires the billing:write scope. ALWAYS ask the user why they are cancelling FIRST and pass their answer as `reason` (one of the allowed values). By default the subscription is set to cancel at the end of the current period; pass immediate=true only if the user explicitly wants it cancelled right now. Only call after the user explicitly confirms.",
+    inputSchema: z.object({
+        reason: z.enum(CANCELLATION_REASONS).describe('Why the user is cancelling. Ask the user before calling; do not guess.'),
+        feedback: z.string().max(2000).optional().describe('Optional free-text detail the user gave about why they are cancelling.'),
+        immediate: z.boolean().optional().describe('Cancel immediately instead of at period end. Defaults to false (cancel at period end).'),
+        confirm: z.literal(true).describe('Must be true after the user explicitly confirms the cancellation.'),
+    }),
+    async execute(client, input) {
+        const result = await client.cancelSubscription({
+            reason: input.reason,
+            feedback: input.feedback,
+            immediate: input.immediate === true,
+        });
+        return formatCanceled(result);
+    },
+};

package/dist/tools/create-api-key.d.ts

@@ -5,7 +5,7 @@ export declare const createApiKeyTool: {
     description: string;
     inputSchema: z.ZodObject<{
         name: z.ZodOptional<z.ZodString>;
-        scopes: z.ZodOptional<z.ZodArray<z.ZodEnum<["accounts:read", "accounts:write", "posts:read", "posts:write", "media:write", "analytics:read"]>, "many">>;
+        scopes: z.ZodOptional<z.ZodArray<z.ZodEnum<["accounts:read", "accounts:write", "posts:read", "posts:write", "media:write", "analytics:read", "billing:read", "billing:write"]>, "many">>;
         workspace_id: z.ZodOptional<z.ZodString>;
         expires_in_days: z.ZodOptional<z.ZodNumber>;
         confirm: z.ZodLiteral<true>;
@@ -13,13 +13,13 @@ export declare const createApiKeyTool: {
         confirm: true;
         workspace_id?: string | undefined;
         name?: string | undefined;
-        scopes?: ("accounts:read" | "accounts:write" | "posts:read" | "posts:write" | "media:write" | "analytics:read")[] | undefined;
+        scopes?: ("accounts:read" | "accounts:write" | "posts:read" | "posts:write" | "media:write" | "analytics:read" | "billing:read" | "billing:write")[] | undefined;
         expires_in_days?: number | undefined;
     }, {
         confirm: true;
         workspace_id?: string | undefined;
         name?: string | undefined;
-        scopes?: ("accounts:read" | "accounts:write" | "posts:read" | "posts:write" | "media:write" | "analytics:read")[] | undefined;
+        scopes?: ("accounts:read" | "accounts:write" | "posts:read" | "posts:write" | "media:write" | "analytics:read" | "billing:read" | "billing:write")[] | undefined;
         expires_in_days?: number | undefined;
     }>;
     execute(client: PosterlyClient, input: CreateApiKeyPayload): Promise<string>;

package/dist/tools/create-api-key.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { code, mdKeyValue, mdSection, mdTitle } from '../lib/format.js';
-const scopeSchema = z.enum(['accounts:read', 'accounts:write', 'posts:read', 'posts:write', 'media:write', 'analytics:read']);
+const scopeSchema = z.enum(['accounts:read', 'accounts:write', 'posts:read', 'posts:write', 'media:write', 'analytics:read', 'billing:read', 'billing:write']);
 function formatCreatedApiKey(result) {
     const key = result.api_key;
     return [
@@ -23,7 +23,7 @@ export const createApiKeyTool = {
     description: 'Create a new Posterly API key for the authenticated user. SECRET-CREATING WRITE: only use after explicit user confirmation. The new key can only request scopes already present on the calling dashboard-created API key; OAuth and managed assistant tokens cannot mint keys.',
     inputSchema: z.object({
         name: z.string().trim().min(1).max(120).optional().describe('Human-readable key name.'),
-        scopes: z.array(scopeSchema).min(1).max(6).optional().describe('Scopes for the new key. Omit to copy the calling key scopes. Cannot exceed the calling key scopes.'),
+        scopes: z.array(scopeSchema).min(1).max(8).optional().describe('Scopes for the new key. Omit to copy the calling key scopes. Cannot exceed the calling key scopes. billing:read and billing:write allow managing the posterly subscription (cancel/pause/resume/downgrade).'),
         workspace_id: z.string().trim().min(1).optional().describe('Optional workspace restriction. Workspace-scoped calling keys cannot create keys outside their workspace.'),
         expires_in_days: z.number().int().min(1).max(365).optional().describe('Optional expiry from now, up to 365 days. Omit for no expiry.'),
         confirm: z.literal(true).describe('Must be true after the user explicitly confirms that a new secret API key should be created.'),