posterly-mcp-server 0.8.2 → 0.19.0

package/README.md

@@ -93,24 +93,57 @@ Add the same server definition to your Cursor MCP settings:
 
 ## Available tools
 
-`posterly-mcp-server@0.8.2` exposes 16 tools:
+`posterly-mcp-server@0.19.0` exposes 49 tools:
 
 - `whoami`
 - `list_accounts`
+- `disconnect_account` (disconnect a connected social account after explicit confirmation)
+- `get_connect_link`
+- `list_oauth_clients`
+- `create_oauth_client` (create a public PKCE client after explicit confirmation)
+- `update_oauth_client` (update redirect URIs/scopes after explicit confirmation)
+- `delete_oauth_client` (delete a developer client after explicit confirmation)
+- `list_platforms`
+- `get_platform_schema`
+- `trigger_platform_helper`
 - `list_brands`
 - `get_brand`
 - `list_brand_accounts`
 - `get_brand_profile`
 - `list_posts`
 - `get_post`
+- `get_post_missing`
 - `create_post` (supports `thread_posts: string[]` for X / Threads reply chains, plus `platform_settings` for platform-specific composer controls)
+- `create_posts_batch` (create up to 25 confirmed posts in one API request)
 - `update_post` (also accepts `platform_settings`)
+- `update_post_status` (pause, resume, schedule, or draft a post after confirmation)
+- `update_post_release_id` (set/repair external release/group metadata after confirmation)
 - `delete_post`
+- `delete_post_group` (delete grouped draft/scheduled posts after confirmation)
 - `upload_media`
+- `upload_media_from_url`
+- `create_signed_upload`
 - `find_available_slot`
 - `generate_image`
+- `get_video_options`
+- `run_video_function` (read-only Veo helpers for cost estimation and request validation)
+- `generate_video` (queues a cost-guarded Veo video job)
+- `get_video_job` (poll one job or list recent jobs)
 - `get_account_analytics`
 - `get_post_analytics`
+- `list_google_business_reviews`
+- `get_google_business_review_link`
+- `audit_google_business_profile`
+- `suggest_google_business_review_reply`
+- `reply_google_business_review` (post/update a public GBP review reply after explicit confirmation)
+- `delete_google_business_review_reply` (delete a GBP review reply after explicit confirmation)
+- `list_activity`
+- `list_webhooks`
+- `create_webhook` (create a webhook after explicit confirmation)
+- `update_webhook` (update a webhook after explicit confirmation)
+- `delete_webhook` (delete a webhook after explicit confirmation)
+- `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.
 
@@ -136,10 +169,12 @@ much more reliable than forcing the agent to guess from raw account handles alon
 ## Example prompts
 
 - `What Posterly accounts do I have connected?`
+- `Disconnect the old Instagram account after I confirm the exact account ID`
 - `List my brands in Posterly`
 - `Show me the brand profile for Grassroots`
 - `Find the next 3 posting slots for my LinkedIn account`
 - `Schedule a post for tomorrow at 9am for the Posterly Instagram account`
+- `Pause post 971 after I confirm it is the right scheduled post`
 - `Schedule this as an Instagram Story with a first comment and @partner as collaborator`
 - `Schedule this YouTube video as unlisted, add the thumbnail URL, and put it in our launch playlist`
 - `Post this TikTok with direct-post privacy set to public and stitch disabled`
@@ -150,11 +185,11 @@ much more reliable than forcing the agent to guess from raw account handles alon
 This package uses the Posterly API/MCP add-on:
 
 - `$3/month` add-on
-- `30 requests/hour` per API key
+- `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
 
-Each API call counts as one request, so you can still schedule multiple posts in a single request to maximize throughput.
+Each API call counts as one request, so use `create_posts_batch` when you need to schedule multiple posts in one confirmed operation.
 
 Details: [poster.ly/dashboard/api](https://www.poster.ly/dashboard/api)
 

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

@@ -0,0 +1,392 @@
+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 platformAliases: {
+        readonly bluesky: "bluesky";
+        readonly devto: "devto";
+        readonly discord: "discord";
+        readonly facebook: "facebook";
+        readonly gmb: "google_business";
+        readonly google_business: "google_business";
+        readonly google_business_profile: "google_business";
+        readonly hashnode: "hashnode";
+        readonly instagram: "instagram";
+        readonly instagram_standalone: "instagram";
+        readonly linkedin: "linkedin";
+        readonly mastodon: "mastodon";
+        readonly medium: "medium";
+        readonly pinterest: "pinterest";
+        readonly reddit: "reddit";
+        readonly skool: "skool";
+        readonly slack: "slack";
+        readonly telegram: "telegram";
+        readonly threads: "threads";
+        readonly tiktok: "tiktok";
+        readonly twitter: "twitter";
+        readonly whop: "whop";
+        readonly wordpress: "wordpress";
+        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", "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 connectAliases: {
+        readonly bluesky: "bluesky";
+        readonly devto: "devto";
+        readonly discord: "discord";
+        readonly facebook: "facebook";
+        readonly facebook_instagram: "meta";
+        readonly facebook_pages: "facebook";
+        readonly gmb: "google_business";
+        readonly google_business: "google_business";
+        readonly google_business_profile: "google_business";
+        readonly hashnode: "hashnode";
+        readonly instagram: "instagram";
+        readonly instagram_direct: "instagram";
+        readonly instagram_standalone: "instagram";
+        readonly linkedin: "linkedin";
+        readonly linkedin_company: "linkedin_page";
+        readonly linkedin_page: "linkedin_page";
+        readonly linkedin_personal: "linkedin";
+        readonly mastodon: "mastodon";
+        readonly medium: "medium";
+        readonly meta: "meta";
+        readonly meta_business: "meta";
+        readonly pinterest: "pinterest";
+        readonly reddit: "reddit";
+        readonly skool: "skool";
+        readonly slack: "slack";
+        readonly telegram: "telegram";
+        readonly threads: "threads";
+        readonly tiktok: "tiktok";
+        readonly twitter: "twitter";
+        readonly whop: "whop";
+        readonly wordpress: "wordpress";
+        readonly x: "twitter";
+        readonly x_twitter: "twitter";
+        readonly youtube: "youtube";
+    };
+    readonly platforms: readonly [{
+        readonly id: "instagram";
+        readonly label: "Instagram";
+        readonly status: "supported";
+        readonly aliases: readonly ["instagram-standalone"];
+        readonly postTypes: readonly ["image", "carousel", "reel", "story", "story_series"];
+        readonly analyticsSupported: true;
+        readonly helpers: readonly [];
+    }, {
+        readonly id: "facebook";
+        readonly label: "Facebook";
+        readonly status: "supported";
+        readonly aliases: readonly [];
+        readonly postTypes: readonly ["text", "image", "video", "carousel", "reel", "story", "cover_photo"];
+        readonly analyticsSupported: false;
+        readonly helpers: readonly [];
+    }, {
+        readonly id: "tiktok";
+        readonly label: "TikTok";
+        readonly status: "supported";
+        readonly aliases: readonly [];
+        readonly postTypes: readonly ["video", "image"];
+        readonly analyticsSupported: false;
+        readonly helpers: readonly ["tiktok.creator_info"];
+    }, {
+        readonly id: "twitter";
+        readonly label: "X";
+        readonly status: "supported";
+        readonly aliases: readonly ["x"];
+        readonly postTypes: readonly ["text", "image", "video", "carousel", "x_thread"];
+        readonly analyticsSupported: false;
+        readonly helpers: readonly ["x.quota"];
+    }, {
+        readonly id: "linkedin";
+        readonly label: "LinkedIn";
+        readonly status: "supported";
+        readonly aliases: readonly [];
+        readonly postTypes: readonly ["text", "image", "video", "carousel", "document"];
+        readonly analyticsSupported: true;
+        readonly helpers: readonly ["linkedin.recent_mentions"];
+    }, {
+        readonly id: "youtube";
+        readonly label: "YouTube";
+        readonly status: "supported";
+        readonly aliases: readonly [];
+        readonly postTypes: readonly ["video"];
+        readonly analyticsSupported: true;
+        readonly helpers: readonly ["youtube.playlists"];
+    }, {
+        readonly id: "pinterest";
+        readonly label: "Pinterest";
+        readonly status: "supported";
+        readonly aliases: readonly [];
+        readonly postTypes: readonly ["image", "video", "carousel"];
+        readonly analyticsSupported: true;
+        readonly helpers: readonly ["pinterest.boards"];
+    }, {
+        readonly id: "threads";
+        readonly label: "Threads";
+        readonly status: "supported";
+        readonly aliases: readonly [];
+        readonly postTypes: readonly ["text", "image", "video", "carousel", "threads_thread"];
+        readonly analyticsSupported: false;
+        readonly helpers: readonly [];
+    }, {
+        readonly id: "google_business";
+        readonly label: "Google Business";
+        readonly status: "supported";
+        readonly aliases: readonly ["gmb", "google-business", "google_business_profile"];
+        readonly postTypes: readonly ["standard", "event", "offer"];
+        readonly analyticsSupported: true;
+        readonly helpers: readonly [];
+    }, {
+        readonly id: "telegram";
+        readonly label: "Telegram";
+        readonly status: "supported";
+        readonly aliases: readonly [];
+        readonly postTypes: readonly ["text", "image", "video", "media_group"];
+        readonly analyticsSupported: false;
+        readonly helpers: readonly [];
+    }, {
+        readonly id: "bluesky";
+        readonly label: "Bluesky";
+        readonly status: "supported";
+        readonly aliases: readonly [];
+        readonly postTypes: readonly ["text", "image", "carousel"];
+        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: "wordpress";
+        readonly label: "WordPress";
+        readonly status: "planned";
+        readonly aliases: readonly [];
+        readonly postTypes: readonly [];
+        readonly analyticsSupported: false;
+        readonly helpers: readonly [];
+    }, {
+        readonly id: "mastodon";
+        readonly label: "Mastodon";
+        readonly status: "planned";
+        readonly aliases: readonly [];
+        readonly postTypes: readonly [];
+        readonly analyticsSupported: false;
+        readonly helpers: readonly [];
+    }, {
+        readonly id: "medium";
+        readonly label: "Medium";
+        readonly status: "planned";
+        readonly aliases: readonly [];
+        readonly postTypes: readonly [];
+        readonly analyticsSupported: false;
+        readonly helpers: readonly [];
+    }, {
+        readonly id: "devto";
+        readonly label: "Dev.to";
+        readonly status: "planned";
+        readonly aliases: readonly [];
+        readonly postTypes: readonly [];
+        readonly analyticsSupported: false;
+        readonly helpers: readonly [];
+    }, {
+        readonly id: "hashnode";
+        readonly label: "Hashnode";
+        readonly status: "planned";
+        readonly aliases: readonly [];
+        readonly postTypes: readonly [];
+        readonly analyticsSupported: false;
+        readonly helpers: readonly [];
+    }, {
+        readonly id: "discord";
+        readonly label: "Discord";
+        readonly status: "planned";
+        readonly aliases: readonly [];
+        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";
+        readonly status: "planned";
+        readonly aliases: readonly [];
+        readonly postTypes: readonly [];
+        readonly analyticsSupported: false;
+        readonly helpers: readonly [];
+    }, {
+        readonly id: "whop";
+        readonly label: "Whop";
+        readonly status: "planned";
+        readonly aliases: readonly [];
+        readonly postTypes: readonly [];
+        readonly analyticsSupported: false;
+        readonly helpers: readonly [];
+    }];
+    readonly connectTargets: readonly [{
+        readonly id: "instagram";
+        readonly label: "Instagram";
+        readonly status: "supported";
+        readonly aliases: readonly ["instagram-standalone", "instagram_direct"];
+        readonly method: "dashboard_oauth";
+    }, {
+        readonly id: "meta";
+        readonly label: "Meta";
+        readonly status: "supported";
+        readonly aliases: readonly ["facebook_instagram", "meta_business"];
+        readonly method: "dashboard_oauth";
+    }, {
+        readonly id: "facebook";
+        readonly label: "Facebook Pages";
+        readonly status: "supported";
+        readonly aliases: readonly ["facebook_pages"];
+        readonly method: "dashboard_oauth";
+    }, {
+        readonly id: "youtube";
+        readonly label: "YouTube";
+        readonly status: "supported";
+        readonly aliases: readonly [];
+        readonly method: "dashboard_oauth";
+    }, {
+        readonly id: "tiktok";
+        readonly label: "TikTok";
+        readonly status: "supported";
+        readonly aliases: readonly [];
+        readonly method: "dashboard_oauth";
+    }, {
+        readonly id: "linkedin";
+        readonly label: "LinkedIn Personal";
+        readonly status: "supported";
+        readonly aliases: readonly ["linkedin_personal"];
+        readonly method: "dashboard_oauth";
+    }, {
+        readonly id: "linkedin_page";
+        readonly label: "LinkedIn Page";
+        readonly status: "supported";
+        readonly aliases: readonly ["linkedin-page", "linkedin_company", "linkedin-company"];
+        readonly method: "dashboard_oauth";
+    }, {
+        readonly id: "threads";
+        readonly label: "Threads";
+        readonly status: "supported";
+        readonly aliases: readonly [];
+        readonly method: "dashboard_oauth";
+    }, {
+        readonly id: "google_business";
+        readonly label: "Google Business Profile";
+        readonly status: "supported";
+        readonly aliases: readonly ["gmb", "google-business", "google_business_profile"];
+        readonly method: "dashboard_oauth";
+    }, {
+        readonly id: "pinterest";
+        readonly label: "Pinterest";
+        readonly status: "supported";
+        readonly aliases: readonly [];
+        readonly method: "dashboard_oauth";
+    }, {
+        readonly id: "twitter";
+        readonly label: "X (Twitter)";
+        readonly status: "supported";
+        readonly aliases: readonly ["x", "x_twitter"];
+        readonly method: "dashboard_oauth";
+    }, {
+        readonly id: "telegram";
+        readonly label: "Telegram";
+        readonly status: "supported";
+        readonly aliases: readonly [];
+        readonly method: "manual_credentials";
+    }, {
+        readonly id: "bluesky";
+        readonly label: "Bluesky";
+        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: "wordpress";
+        readonly label: "WordPress";
+        readonly status: "planned";
+        readonly aliases: readonly [];
+        readonly method: "planned";
+    }, {
+        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 aliases: readonly [];
+        readonly method: "planned";
+    }, {
+        readonly id: "devto";
+        readonly label: "Dev.to";
+        readonly status: "planned";
+        readonly aliases: readonly [];
+        readonly method: "planned";
+    }, {
+        readonly id: "hashnode";
+        readonly label: "Hashnode";
+        readonly status: "planned";
+        readonly aliases: readonly [];
+        readonly method: "planned";
+    }, {
+        readonly id: "discord";
+        readonly label: "Discord";
+        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";
+        readonly status: "planned";
+        readonly aliases: readonly [];
+        readonly method: "planned";
+    }, {
+        readonly id: "whop";
+        readonly label: "Whop";
+        readonly status: "planned";
+        readonly aliases: readonly [];
+        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", "linkedin", "youtube", "pinterest", "google_business"];