@post-ripple/mcp 0.8.0 → 0.9.0

package/README.md

@@ -60,7 +60,8 @@ env = { POSTRIPPLE_API_KEY = "pr_..." }
 | `list_slideshows` | read | Photo-carousel slideshows |
 | `list_slideshow_templates` | read | Slideshow layout templates, fonts, and text treatments |
 | `get_slideshow` | read | One slideshow with per-slide render state and progress |
-| `list_posts` | read | Posts with status, schedule, errors |
+| `list_posts` | read | Posts with status, approval state, schedule, and errors |
+| `list_reviews` | read | Posts waiting for team approval or changes |
 | `get_post_metrics` | read | Per-post engagement time series |
 | `get_account_metrics` | read | Follower growth history |
 | `get_engagement_summary` | read | Org-wide totals, per-platform breakdown, top posts |
@@ -79,7 +80,7 @@ env = { POSTRIPPLE_API_KEY = "pr_..." }
 
 Notes for agents:
 
-- `schedule_post` and `publish_slideshow` publish to **real** social accounts. Always pass `idempotencyKey`, and pass `tiktokSettings` if the post should be public on TikTok (the default is private/`SELF_ONLY`).
+- `schedule_post` and `publish_slideshow` publish to **real** social accounts when the workspace allows direct publishing. If the team has enabled approval, these tools submit review items instead and return `submittedForReview: true`; use `list_reviews` to inspect them, and have an owner/admin approve them from the Post Ripple Review page. Always pass `idempotencyKey`, and pass `tiktokSettings` if the post should be public on TikTok (the default is private/`SELF_ONLY`).
 - The typical slideshow flow: `import_image_from_url` (or `get_image_upload_url` + PUT) per image → `create_slideshow` → poll `get_slideshow` until `ready` (template slides render server-side) → `publish_slideshow`. Pre-rendered JPEG slideshows are ready instantly.
 - TikTok `settings.postMode: "inbox"` sends the photo post to the account's TikTok app drafts inbox instead of publishing directly — useful when a human finishes posts from a real device.
 - Imports and publishes are asynchronous. Poll `list_videos` / `list_posts` to observe progress.

package/dist/index.js

@@ -77,6 +77,7 @@ const orgParam = {
 };
 const platformEnum = z.enum(["tiktok", "instagram", "youtube", "other"]);
 const postStatusEnum = z.enum([
+    "draft",
     "scheduled",
     "pending",
     "uploading",
@@ -175,7 +176,7 @@ const slideSchema = z.object({
         .describe("Darkening scrim over the background (template slides only); omit to use the template's default"),
 });
 // ---- read tools ----
-register("whoami", "Get who this key acts as and which organizations it can work in, plus the key's scopes. When an organization is selected (single-org key, organizationId argument, or POSTRIPPLE_ORG), also returns that workspace's overview: connected accounts, active groups, scheduled posts. Call this first to orient yourself.", { ...orgParam });
+register("whoami", "Get who this key acts as and which organizations it can work in, plus the key's scopes. When an organization is selected (single-org key, organizationId argument, or POSTRIPPLE_ORG), also returns that workspace's overview: connected accounts, active groups, scheduled posts, and whether team approval is required. Call this first to orient yourself.", { ...orgParam });
 register("list_social_accounts", "List the workspace's connected social accounts (TikTok / Instagram / YouTube) with connection health: status (active/expired/revoked/error), token expiry, and last error. Use the returned accountId for scheduling and metrics tools.", { ...orgParam });
 register("list_videos", "List videos in the workspace library, newest first. Videos with status 'completed' are publishable; 'pending'/'downloading' are still being imported.", {
     ...orgParam,
@@ -222,12 +223,20 @@ register("get_creation", "Get the render status of a video created with create_v
 register("list_slideshows", "List photo-carousel slideshows with status ('draft' = still being composed, 'ready' = publishable) and a signed coverUrl thumbnail (first rendered slide, or a background for drafts).", { ...orgParam, limit: z.number().min(1).max(200).optional() });
 register("list_slideshow_templates", "List the slideshow layout templates: canvas size, each template's text slots with exact geometry (x/y anchor, maxWidth, fontSize, lineHeight — all normalized to the canvas) and defaults (font, color, treatment), the template's default overlay scrim, available fonts and text treatments, and the max slide count. Call before create_slideshow when composing template-based slides — use the slot geometry rather than inventing your own placement.", {});
 register("get_slideshow", "Get one slideshow in full detail: per-slide render state, each text field's text AND its style overrides (font, color, treatment, fontScale, x/y position, maxWidth, align, rotation — null style means the template slot defaults apply), the slide's overlay scrim, and signed image URLs (renderedUrl = the finished slide, backgroundUrl = the photo behind it; both expire in ~1h). Use it to study how existing slides are actually styled before composing new ones, or poll it after create_slideshow returns status 'rendering' — publish once status is 'ready'.", { ...orgParam, slideshowId: z.string() });
-register("list_posts", "List posts (scheduled, publishing, published, failed, canceled), newest first. Scheduled posts include scheduledFor; published posts include platformPostId and publishedAt.", {
+register("list_posts", "List posts (including review drafts, scheduled, publishing, published, failed, and canceled), newest first. Review posts include approvalStatus, submittedByName, and reviewNote; scheduled posts include scheduledFor; published posts include platformPostId and publishedAt.", {
     ...orgParam,
     status: postStatusEnum.optional(),
     platform: platformEnum.optional(),
     limit: z.number().min(1).max(200).optional(),
 });
+register("list_reviews", "List posts waiting for team review. When approval is required, schedule_post and publish_slideshow submit work here instead of publishing or scheduling it. Use this to see approvalStatus, reviewer notes, target account, planned publish time, and a preview URL. Human approval is completed from Post Ripple's Review page.", {
+    ...orgParam,
+    status: z
+        .enum(["in_review", "changes_requested"])
+        .optional()
+        .describe("Filter to items awaiting review or items sent back for changes"),
+    limit: z.number().min(1).max(200).optional(),
+});
 register("get_post_metrics", "Get engagement for one published post: latest snapshot (views/likes/comments/shares) plus the time series of scraped metrics.", {
     ...orgParam,
     postId: z.string(),
@@ -365,7 +374,7 @@ register("create_video", "Render a short-form (9:16) video from library ingredie
     backgroundId: z.string().optional().describe("green_screen_meme: image id from list_backgrounds (required)"),
 });
 // ---- publish tools ----
-register("schedule_post", "Schedule a completed library video to publish on a connected account at a future time. This posts to a REAL social account when the time arrives. The platform is derived from the account. Uses one 'posts' credit (refunded if canceled). ALWAYS pass idempotencyKey (any unique string) so retries can't double-post. For TikTok, pass tiktokSettings to control privacy — omitting it publishes as private (SELF_ONLY). For YouTube, pass title.", {
+register("schedule_post", "Schedule a completed library video to publish on a connected account at a future time. This posts to a REAL social account when the time arrives unless the team requires approval; in that case it creates an in-review item and returns submittedForReview=true. The platform is derived from the account. Uses one 'posts' credit when scheduled (or when approved; review submissions do not consume a credit yet). ALWAYS pass idempotencyKey (any unique string) so retries can't double-post. For TikTok, pass tiktokSettings to control privacy — omitting it publishes as private (SELF_ONLY). For YouTube, pass title.", {
     ...orgParam,
     videoId: z.string(),
     accountId: z.string(),
@@ -389,7 +398,7 @@ register("reschedule_post", "Move a still-scheduled post to a new future time. F
     ...args,
     scheduledFor: toEpochMs(args.scheduledFor, "scheduledFor"),
 }));
-register("publish_slideshow", "Publish or schedule a READY slideshow to one or more Instagram/TikTok accounts as a native carousel / photo post. This posts to REAL social accounts. Omit scheduledFor to publish immediately; pass it to schedule (uses one 'posts' credit per account, refunded if canceled). ALWAYS pass idempotencyKey so retries can't double-post. TikTok targets without settings publish as SELF_ONLY (private); pass settings with postMode 'inbox' to send a draft to the account's TikTok app inbox instead.", {
+register("publish_slideshow", "Publish or schedule a READY slideshow to one or more Instagram/TikTok accounts as a native carousel / photo post. This posts to REAL social accounts unless the team requires approval; in that case it creates in-review items and returns submittedForReview=true. Omit scheduledFor to publish immediately; pass it to schedule. Posts use one 'posts' credit per account when published/scheduled or approved (review submissions do not consume a credit yet). ALWAYS pass idempotencyKey so retries can't double-post. TikTok targets without settings publish as SELF_ONLY (private); pass settings with postMode 'inbox' to send a draft to the account's TikTok app inbox instead.", {
     ...orgParam,
     slideshowId: z.string(),
     targets: z

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@post-ripple/mcp",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "MCP server that lets AI agents (Claude Code, Codex, opencode) manage a Post Ripple workspace: content, scheduling, publishing, and analytics.",
   "type": "module",
   "bin": {