posterly-mcp-server 0.23.1 → 0.24.0

package/README.md

@@ -162,6 +162,10 @@ Authenticated tools require `POSTERLY_API_KEY`:
 - `get_video_job` (poll one job or list recent jobs)
 - `get_account_analytics`
 - `get_post_analytics`
+- `get_performance_profile` (read an account's 90-day performance profile: top formats, timing, caption-length patterns, engagement-rate trend, narrative summary)
+- `get_post_insights` (list per-post feedback-loop insights: performance tier, diagnosis, next action, metrics, baseline)
+- `list_post_suggestions` (list evidence-based weekly post drafts in the account's learned voice, each with a rationale)
+- `dismiss_suggestion` (dismiss a post suggestion after confirmation; never touches one already scheduled)
 - `list_google_business_reviews`
 - `get_google_business_review_link`
 - `audit_google_business_profile`
@@ -182,7 +186,13 @@ Authenticated tools require `POSTERLY_API_KEY`:
 - `test_webhook` (send a signed test delivery after explicit confirmation)
 - `get_x_posting_quota`
 
-Analytics tools currently support Instagram, LinkedIn, Google Business Profile, Pinterest, and YouTube.
+Analytics tools currently support Instagram, Facebook Pages, LinkedIn, Google Business Profile, Pinterest, YouTube, and Threads.
+
+## Media uploads
+
+This npm/stdio server can read local file paths. When `upload_media` receives a larger local file, it automatically requests a signed upload URL and uploads the raw bytes before returning the public media URL.
+
+The hosted HTTP MCP endpoint cannot do that for local files by itself because MCP tool calls are JSON-only. On hosted HTTP MCP, `upload_media` is for small base64 uploads up to 5MB decoded. For larger media there, use `upload_media_from_url` for public direct media URLs, or call `create_signed_upload` only from clients that can also `PUT` the raw file bytes to the returned `upload_url`.
 
 ## What the brand tools are for
 
@@ -226,7 +236,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
-- works across all 11 supported platforms
+- 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,10 +1,10 @@
 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"];
-    readonly plannedPlatformIds: readonly ["reddit", "wordpress", "mastodon", "medium", "devto", "hashnode", "discord", "slack", "skool", "whop"];
-    readonly allPlatformIds: readonly ["instagram", "facebook", "tiktok", "twitter", "linkedin", "youtube", "pinterest", "threads", "google_business", "telegram", "bluesky", "reddit", "wordpress", "mastodon", "medium", "devto", "hashnode", "discord", "slack", "skool", "whop"];
-    readonly supportedPlatformInputs: readonly ["bluesky", "facebook", "gmb", "google-business", "google_business", "google_business_profile", "instagram", "instagram-standalone", "linkedin", "pinterest", "telegram", "threads", "tiktok", "twitter", "x", "youtube"];
-    readonly allPlatformInputs: readonly ["bluesky", "devto", "discord", "facebook", "gmb", "google-business", "google_business", "google_business_profile", "hashnode", "instagram", "instagram-standalone", "linkedin", "mastodon", "medium", "pinterest", "reddit", "skool", "slack", "telegram", "threads", "tiktok", "twitter", "whop", "wordpress", "x", "youtube"];
+    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 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";
         readonly devto: "devto";
@@ -16,6 +16,7 @@ export declare const PLATFORM_MANIFEST: {
         readonly hashnode: "hashnode";
         readonly instagram: "instagram";
         readonly instagram_standalone: "instagram";
+        readonly lemmy: "lemmy";
         readonly linkedin: "linkedin";
         readonly mastodon: "mastodon";
         readonly medium: "medium";
@@ -32,10 +33,10 @@ export declare const PLATFORM_MANIFEST: {
         readonly x: "twitter";
         readonly youtube: "youtube";
     };
-    readonly helperNames: readonly ["linkedin.recent_mentions", "pinterest.boards", "tiktok.creator_info", "x.quota", "youtube.playlists"];
-    readonly analyticsPlatformIds: readonly ["instagram", "facebook", "linkedin", "youtube", "pinterest", "google_business"];
-    readonly connectTargetIds: readonly ["instagram", "meta", "facebook", "youtube", "tiktok", "linkedin", "linkedin_page", "threads", "google_business", "pinterest", "twitter", "telegram", "bluesky", "reddit", "wordpress", "mastodon", "medium", "devto", "hashnode", "discord", "slack", "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", "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 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 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";
         readonly devto: "devto";
@@ -50,6 +51,7 @@ export declare const PLATFORM_MANIFEST: {
         readonly instagram: "instagram";
         readonly instagram_direct: "instagram";
         readonly instagram_standalone: "instagram";
+        readonly lemmy: "lemmy";
         readonly linkedin: "linkedin";
         readonly linkedin_company: "linkedin_page";
         readonly linkedin_page: "linkedin_page";
@@ -119,7 +121,7 @@ export declare const PLATFORM_MANIFEST: {
         readonly aliases: readonly [];
         readonly postTypes: readonly ["video"];
         readonly analyticsSupported: true;
-        readonly helpers: readonly ["youtube.playlists"];
+        readonly helpers: readonly [];
     }, {
         readonly id: "pinterest";
         readonly label: "Pinterest";
@@ -134,7 +136,7 @@ export declare const PLATFORM_MANIFEST: {
         readonly status: "supported";
         readonly aliases: readonly [];
         readonly postTypes: readonly ["text", "image", "video", "carousel", "threads_thread"];
-        readonly analyticsSupported: false;
+        readonly analyticsSupported: true;
         readonly helpers: readonly [];
     }, {
         readonly id: "google_business";
@@ -161,56 +163,64 @@ export declare const PLATFORM_MANIFEST: {
         readonly analyticsSupported: false;
         readonly helpers: readonly [];
     }, {
-        readonly id: "reddit";
-        readonly label: "Reddit";
-        readonly status: "planned";
+        readonly id: "discord";
+        readonly label: "Discord";
+        readonly status: "supported";
         readonly aliases: readonly [];
-        readonly postTypes: readonly [];
+        readonly postTypes: readonly ["text", "image", "video", "carousel"];
         readonly analyticsSupported: false;
         readonly helpers: readonly [];
     }, {
-        readonly id: "wordpress";
-        readonly label: "WordPress";
-        readonly status: "planned";
+        readonly id: "mastodon";
+        readonly label: "Mastodon";
+        readonly status: "supported";
         readonly aliases: readonly [];
-        readonly postTypes: readonly [];
+        readonly postTypes: readonly ["text", "image", "video", "carousel"];
         readonly analyticsSupported: false;
         readonly helpers: readonly [];
     }, {
-        readonly id: "mastodon";
-        readonly label: "Mastodon";
-        readonly status: "planned";
+        readonly id: "devto";
+        readonly label: "Dev.to";
+        readonly status: "supported";
         readonly aliases: readonly [];
-        readonly postTypes: readonly [];
+        readonly postTypes: readonly ["text", "image"];
         readonly analyticsSupported: false;
         readonly helpers: readonly [];
     }, {
-        readonly id: "medium";
-        readonly label: "Medium";
-        readonly status: "planned";
+        readonly id: "hashnode";
+        readonly label: "Hashnode";
+        readonly status: "supported";
         readonly aliases: readonly [];
-        readonly postTypes: readonly [];
+        readonly postTypes: readonly ["text", "image"];
         readonly analyticsSupported: false;
         readonly helpers: readonly [];
     }, {
-        readonly id: "devto";
-        readonly label: "Dev.to";
-        readonly status: "planned";
+        readonly id: "wordpress";
+        readonly label: "WordPress";
+        readonly status: "supported";
         readonly aliases: readonly [];
-        readonly postTypes: readonly [];
+        readonly postTypes: readonly ["text", "image"];
         readonly analyticsSupported: false;
         readonly helpers: readonly [];
     }, {
-        readonly id: "hashnode";
-        readonly label: "Hashnode";
+        readonly id: "lemmy";
+        readonly label: "Lemmy";
+        readonly status: "supported";
+        readonly aliases: readonly [];
+        readonly postTypes: readonly ["text", "image"];
+        readonly analyticsSupported: false;
+        readonly helpers: readonly [];
+    }, {
+        readonly id: "reddit";
+        readonly label: "Reddit";
         readonly status: "planned";
         readonly aliases: readonly [];
         readonly postTypes: readonly [];
         readonly analyticsSupported: false;
         readonly helpers: readonly [];
     }, {
-        readonly id: "discord";
-        readonly label: "Discord";
+        readonly id: "medium";
+        readonly label: "Medium";
         readonly status: "planned";
         readonly aliases: readonly [];
         readonly postTypes: readonly [];
@@ -320,44 +330,50 @@ export declare const PLATFORM_MANIFEST: {
         readonly aliases: readonly [];
         readonly method: "manual_credentials";
     }, {
-        readonly id: "reddit";
-        readonly label: "Reddit";
-        readonly status: "planned";
-        readonly aliases: readonly [];
-        readonly method: "planned";
-    }, {
-        readonly id: "wordpress";
-        readonly label: "WordPress";
-        readonly status: "planned";
+        readonly id: "discord";
+        readonly label: "Discord";
+        readonly status: "supported";
         readonly aliases: readonly [];
-        readonly method: "planned";
+        readonly method: "manual_credentials";
     }, {
         readonly id: "mastodon";
         readonly label: "Mastodon";
-        readonly status: "planned";
-        readonly aliases: readonly [];
-        readonly method: "planned";
-    }, {
-        readonly id: "medium";
-        readonly label: "Medium";
-        readonly status: "planned";
+        readonly status: "supported";
         readonly aliases: readonly [];
-        readonly method: "planned";
+        readonly method: "manual_credentials";
     }, {
         readonly id: "devto";
         readonly label: "Dev.to";
-        readonly status: "planned";
+        readonly status: "supported";
         readonly aliases: readonly [];
-        readonly method: "planned";
+        readonly method: "manual_credentials";
     }, {
         readonly id: "hashnode";
         readonly label: "Hashnode";
+        readonly status: "supported";
+        readonly aliases: readonly [];
+        readonly method: "manual_credentials";
+    }, {
+        readonly id: "wordpress";
+        readonly label: "WordPress";
+        readonly status: "supported";
+        readonly aliases: readonly [];
+        readonly method: "manual_credentials";
+    }, {
+        readonly id: "lemmy";
+        readonly label: "Lemmy";
+        readonly status: "supported";
+        readonly aliases: readonly [];
+        readonly method: "manual_credentials";
+    }, {
+        readonly id: "reddit";
+        readonly label: "Reddit";
         readonly status: "planned";
         readonly aliases: readonly [];
         readonly method: "planned";
     }, {
-        readonly id: "discord";
-        readonly label: "Discord";
+        readonly id: "medium";
+        readonly label: "Medium";
         readonly status: "planned";
         readonly aliases: readonly [];
         readonly method: "planned";
@@ -381,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"];
-export declare const PLANNED_PLATFORM_IDS: readonly ["reddit", "wordpress", "mastodon", "medium", "devto", "hashnode", "discord", "slack", "skool", "whop"];
-export declare const ALL_PLATFORM_IDS: readonly ["instagram", "facebook", "tiktok", "twitter", "linkedin", "youtube", "pinterest", "threads", "google_business", "telegram", "bluesky", "reddit", "wordpress", "mastodon", "medium", "devto", "hashnode", "discord", "slack", "skool", "whop"];
-export declare const SUPPORTED_PLATFORM_INPUTS: readonly ["bluesky", "facebook", "gmb", "google-business", "google_business", "google_business_profile", "instagram", "instagram-standalone", "linkedin", "pinterest", "telegram", "threads", "tiktok", "twitter", "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", "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", "youtube.playlists"];
-export declare const CONNECT_TARGET_IDS: readonly ["instagram", "meta", "facebook", "youtube", "tiktok", "linkedin", "linkedin_page", "threads", "google_business", "pinterest", "twitter", "telegram", "bluesky", "reddit", "wordpress", "mastodon", "medium", "devto", "hashnode", "discord", "slack", "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", "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", "google_business"];
+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 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_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"];