@jclvsh/dropspace 2.6.0 → 2.7.1

package/README.md

@@ -1,6 +1,6 @@
 # @jclvsh/dropspace
 
-MCP server and CLI for the [Dropspace](https://www.dropspace.dev) API. Lets AI agents (Claude Code, Cursor) and humans manage launches, personas, platform connections, API keys, and webhooks.
+MCP server and CLI for the [Dropspace](https://www.dropspace.dev) API. Lets AI agents (Claude Code, Cursor) and humans manage launches, personas, media generation, boosts, autopilot, platform connections, API keys, and webhooks. 54 tools across 12 categories.
 
 ## Installation
 
@@ -46,11 +46,15 @@ dropspace launches --help
 | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------- | ----- |
 | launches    | list, create, get, update, delete, publish, retry, generate, retry-content, analytics, batch-analytics, status, delete-post, delete-posts | 14    |
 | personas    | list, create, get, update, delete, analyze                                                                                                | 6     |
+| media       | generate, job                                                                                                                             | 2     |
 | connections | list                                                                                                                                      | 1     |
-| keys        | me, list, create, rename, revoke                                                                                                          | 5     |
-| webhooks    | list, create, get, update, delete, rotate-secret, deliveries                                                                              | 7     |
+| boosts      | create, list, get, activate, cancel, performance                                                                                          | 6     |
+| credits     | balance, purchase                                                                                                                         | 2     |
+| keys        | me, list, create, rename, revoke, rotate                                                                                                  | 6     |
+| webhooks    | list, create, get, update, delete, test, rotate-secret, deliveries                                                                        | 8     |
 | status      | dropspace official account connections                                                                                                    | 1     |
 | usage       | plan, limits, and billing period                                                                                                          | 1     |
+| autopilot   | status, configure, review, approve, reject, run, runs                                                                                     | 7     |
 
 ## MCP Server Configuration
 
@@ -115,6 +119,7 @@ Add to your `.cursor/mcp.json`:
 | `generate_content`     | Generate AI content and video scripts for a launch             |
 | `retry_launch_content` | Retry AI content generation for failed platforms               |
 | `get_launch_analytics` | Get publishing analytics with per-post engagement metrics      |
+| `get_batch_launch_analytics` | Get analytics for multiple launches in one call          |
 | `get_launch_status`    | Get detailed posting status with per-platform logs             |
 
 #### `create_launch` Parameters
@@ -194,12 +199,37 @@ Add to your `.cursor/mcp.json`:
 | `tiktok_samples`    | array  | No       | TikTok writing samples (max 50)     |
 | `linkedin_samples`  | array  | No       | LinkedIn writing samples (max 50)   |
 
+### Media
+
+| Tool             | Description                                                                  |
+| ---------------- | ---------------------------------------------------------------------------- |
+| `generate_media` | Submit an AI image or video generation job for a launch (returns a job ID)   |
+| `get_media_job`  | Poll a media generation job's status; returns the result URL when complete   |
+
 ### Connections
 
 | Tool               | Description                               |
 | ------------------ | ----------------------------------------- |
 | `list_connections` | List your connected social media accounts |
 
+### Boosts
+
+| Tool                    | Description                                                              |
+| ----------------------- | ------------------------------------------------------------------------ |
+| `create_boost`          | Create a paid Meta boost on an organic Facebook/Instagram launch (paused) |
+| `list_boosts`           | List all boosts attached to a launch                                     |
+| `get_boost`             | Get a boost by ID with current performance metrics                       |
+| `activate_boost`        | Activate a paused boost — ad spend begins immediately                    |
+| `cancel_boost`          | Cancel a boost (deletes the Meta campaign, irreversible)                 |
+| `get_boost_performance` | Fetch latest boost metrics (impressions, clicks, reach, spend)           |
+
+### Credits
+
+| Tool                   | Description                                                  |
+| ---------------------- | ------------------------------------------------------------ |
+| `get_credit_balance`   | Get MPP credit balance and available packs (agent payments)  |
+| `purchase_credit_pack` | Purchase a credit pack via MPP (Stripe-based agent payments) |
+
 ### Posts
 
 | Tool               | Description                                            |
@@ -216,6 +246,7 @@ Add to your `.cursor/mcp.json`:
 | `create_api_key`      | Create a new API key (raw key returned once)       |
 | `rename_api_key`      | Rename an API key                                  |
 | `revoke_api_key`      | Permanently revoke an API key                      |
+| `rotate_api_key`      | Rotate an API key (new raw key returned once)      |
 
 #### `create_api_key` Parameters
 
@@ -233,6 +264,7 @@ Add to your `.cursor/mcp.json`:
 | `get_webhook`             | Get a webhook by ID                                          |
 | `update_webhook`          | Update a webhook's URL, events, or active status             |
 | `delete_webhook`          | Delete a webhook                                             |
+| `test_webhook`            | Send a test delivery to a webhook endpoint                   |
 | `rotate_webhook_secret`   | Rotate a webhook's signing secret (new secret returned once) |
 | `list_webhook_deliveries` | List delivery attempts for a webhook                         |
 
@@ -264,6 +296,20 @@ Add to your `.cursor/mcp.json`:
 | ----------- | ------------------------------------------------------- |
 | `get_usage` | Get your current plan, usage limits, and billing period |
 
+### Autopilot
+
+| Tool                      | Description                                                                |
+| ------------------------- | -------------------------------------------------------------------------- |
+| `get_autopilot`           | Get autopilot status: config, queued ideas, drafts pending review          |
+| `configure_autopilot`     | Create or update the autopilot config (merge semantics)                    |
+| `list_autopilot_review`   | List autopilot drafts awaiting approval (review mode)                      |
+| `approve_autopilot_draft` | Approve a draft — schedules it for publishing                              |
+| `reject_autopilot_draft`  | Reject a draft — deletes it, refunds the launch slot, learns from feedback |
+| `run_autopilot_now`       | Trigger a manual autopilot run immediately (2 per hour)                    |
+| `list_autopilot_runs`     | Recent run history with per-step stats and errors                          |
+
+Autopilot is available on pro and premium plans.
+
 ## API Key & Scopes
 
 Generate an API key at [www.dropspace.dev/settings](https://www.dropspace.dev/settings) under the API section.

package/dist/cli.js

@@ -14,6 +14,7 @@ import { registerUsageCommands } from "./commands/usage.js";
 import { registerCreditCommands } from "./commands/credits.js";
 import { registerMediaCommands } from "./commands/media.js";
 import { registerBoostCommands } from "./commands/boosts.js";
+import { registerAutopilotCommands } from "./commands/autopilot.js";
 const program = new Command()
     .name("dropspace")
     .description("dropspace CLI - manage launches, personas, boosts, and more")
@@ -32,6 +33,7 @@ try {
     registerCreditCommands(program, client);
     registerMediaCommands(program, client);
     registerBoostCommands(program, client);
+    registerAutopilotCommands(program, client);
     await program.parseAsync(process.argv);
 }
 catch (error) {

package/dist/commands/autopilot.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+import type { DropspaceClient } from "../client.js";
+export declare function registerAutopilotCommands(program: Command, client: DropspaceClient): void;

package/dist/commands/autopilot.js

@@ -0,0 +1,169 @@
+import { formatOutput, handleError, getFormat } from "../cli-utils.js";
+export function registerAutopilotCommands(program, client) {
+    const autopilot = program
+        .command("autopilot")
+        .alias("ap")
+        .description("autonomous content engine (pro/premium plans)");
+    autopilot
+        .command("status")
+        .description("show autopilot config, queued ideas, and pending review count")
+        .action(async () => {
+        try {
+            const result = await client.get("/autopilot");
+            formatOutput(result, getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    autopilot
+        .command("configure")
+        .description("create or update the autopilot config (only the flags you pass change)")
+        .option("--enabled", "turn nightly runs on")
+        .option("--disabled", "turn nightly runs off")
+        .option("--mode <mode>", "review | auto")
+        .option("--platforms <list>", "comma-separated platforms: facebook,linkedin,twitter,reddit,instagram,tiktok,youtube")
+        .option("--formats <list>", "comma-separated formats: text,visual,video")
+        .option("--persona <id>", 'persona uuid for voice (use "none" to clear)')
+        .option("--times <list>", "comma-separated posting times HH:MM (config timezone)")
+        .option("--days <list>", "comma-separated days of week 0-6 (0 = sunday)")
+        .option("--run-hour <n>", "local hour the nightly run fires (0-23)")
+        .option("--timezone <tz>", "IANA timezone, e.g. America/New_York")
+        .option("--product-url <url>", "product link included in posts")
+        .option("--brief <text>", "product brief (what you're building, who it's for)")
+        .option("--pillars <list>", "comma-separated content pillars")
+        .option("--min-queue <n>", "ideas to keep queued (1-30)")
+        .option("--max-posts <n>", "daily posting cap (1-10)")
+        .action(async (opts) => {
+        try {
+            const body = {};
+            if (opts.enabled)
+                body.enabled = true;
+            if (opts.disabled)
+                body.enabled = false;
+            if (opts.mode)
+                body.mode = opts.mode;
+            if (opts.platforms)
+                body.platforms = String(opts.platforms)
+                    .split(",")
+                    .map((p) => p.trim());
+            if (opts.formats)
+                body.formats = String(opts.formats)
+                    .split(",")
+                    .map((f) => f.trim());
+            if (opts.persona)
+                body.persona_id = opts.persona === "none" ? null : opts.persona;
+            if (opts.times || opts.days) {
+                body.posting_times = {
+                    ...(opts.times
+                        ? {
+                            times: String(opts.times)
+                                .split(",")
+                                .map((t) => t.trim()),
+                        }
+                        : {}),
+                    ...(opts.days
+                        ? {
+                            days: String(opts.days)
+                                .split(",")
+                                .map((d) => parseInt(d.trim(), 10)),
+                        }
+                        : {}),
+                };
+            }
+            if (opts.runHour !== undefined)
+                body.run_hour = parseInt(opts.runHour, 10);
+            if (opts.timezone)
+                body.timezone = opts.timezone;
+            if (opts.productUrl)
+                body.product_url = opts.productUrl;
+            if (opts.brief)
+                body.product_brief = opts.brief;
+            if (opts.pillars)
+                body.content_pillars = String(opts.pillars)
+                    .split(",")
+                    .map((p) => p.trim());
+            if (opts.minQueue !== undefined)
+                body.min_queue = parseInt(opts.minQueue, 10);
+            if (opts.maxPosts !== undefined)
+                body.max_posts_per_day = parseInt(opts.maxPosts, 10);
+            const result = await client.patch("/autopilot", body);
+            formatOutput(result, getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    autopilot
+        .command("review")
+        .description("list drafts awaiting approval")
+        .option("-p, --page <n>", "page number", "1")
+        .option("-s, --page-size <n>", "items per page (max 50)", "20")
+        .action(async (opts) => {
+        try {
+            const params = {};
+            if (opts.page)
+                params.page = opts.page;
+            if (opts.pageSize)
+                params.page_size = opts.pageSize;
+            const result = await client.get("/autopilot/review", params);
+            formatOutput(result, getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    autopilot
+        .command("approve <launchId>")
+        .description("approve a draft - schedules it for publishing")
+        .action(async (launchId) => {
+        try {
+            const result = await client.post(`/autopilot/review/${launchId}/approve`);
+            formatOutput(result, getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    autopilot
+        .command("reject <launchId>")
+        .description("reject a draft - deletes it and refunds the launch slot")
+        .option("-f, --feedback <text>", "what to avoid next time (max 500 chars)")
+        .action(async (launchId, opts) => {
+        try {
+            const result = await client.post(`/autopilot/review/${launchId}/reject`, opts.feedback ? { feedback: opts.feedback } : {});
+            formatOutput(result, getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    autopilot
+        .command("run")
+        .description("trigger a manual run now (limited to 2 per hour)")
+        .action(async () => {
+        try {
+            const result = await client.post("/autopilot/run");
+            formatOutput(result, getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    autopilot
+        .command("runs")
+        .description("recent run history")
+        .option("-l, --limit <n>", "rows to return (max 30)", "9")
+        .action(async (opts) => {
+        try {
+            const params = {};
+            if (opts.limit)
+                params.limit = opts.limit;
+            const result = await client.get("/autopilot/runs", params);
+            formatOutput(result, getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+}

package/dist/index.js

@@ -12,6 +12,7 @@ import { registerUsageTools } from "./tools/usage.js";
 import { registerCreditTools } from "./tools/credits.js";
 import { registerMediaTools } from "./tools/media.js";
 import { registerBoostTools } from "./tools/boosts.js";
+import { registerAutopilotTools } from "./tools/autopilot.js";
 const server = new McpServer({
     name: "dropspace",
     version: "2.5.0",
@@ -27,5 +28,6 @@ registerUsageTools(server, client);
 registerCreditTools(server, client);
 registerMediaTools(server, client);
 registerBoostTools(server, client);
+registerAutopilotTools(server, client);
 const transport = new StdioServerTransport();
 await server.connect(transport);

package/dist/tools/autopilot.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { DropspaceClient } from "../client.js";
+export declare function registerAutopilotTools(server: McpServer, client: DropspaceClient): void;

package/dist/tools/autopilot.js

@@ -0,0 +1,123 @@
+import { z } from "zod";
+const AUTO_POST_PLATFORMS = ["facebook", "linkedin", "twitter", "reddit", "instagram", "tiktok", "youtube"];
+function ok(result) {
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+}
+function err(error) {
+    return {
+        content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+        isError: true,
+    };
+}
+export function registerAutopilotTools(server, client) {
+    server.tool("get_autopilot", "get autopilot status: config, queued ideas, and drafts pending review. autopilot is the autonomous content engine that drafts and schedules posts nightly (pro/premium plans).", {}, async () => {
+        try {
+            return ok(await client.get("/autopilot"));
+        }
+        catch (error) {
+            return err(error);
+        }
+    });
+    server.tool("configure_autopilot", "create or update the autopilot config. merge semantics: only the fields you send change. enabling requires at least one platform with a connected account.", {
+        enabled: z.boolean().optional().describe("turn nightly runs on/off"),
+        mode: z
+            .enum(["review", "auto"])
+            .optional()
+            .describe("review = drafts wait for approval; auto = publishes on schedule"),
+        platforms: z
+            .array(z.enum(AUTO_POST_PLATFORMS))
+            .optional()
+            .describe("platforms to post on (must have connected accounts)"),
+        formats: z
+            .array(z.enum(["text", "visual", "video"]))
+            .optional()
+            .describe("content formats the engine may produce"),
+        persona_id: z.string().nullable().optional().describe("voice persona uuid (null to clear)"),
+        posting_times: z
+            .object({
+            times: z.array(z.string()).describe('posting times as "HH:MM" in the config timezone'),
+            days: z.array(z.number().int().min(0).max(6)).describe("days of week (0 = sunday)"),
+        })
+            .optional(),
+        run_hour: z.number().int().min(0).max(23).optional().describe("local hour the nightly run fires"),
+        timezone: z.string().optional().describe("IANA timezone, e.g. America/New_York"),
+        product_url: z.string().nullable().optional().describe("product link included in posts"),
+        product_brief: z
+            .string()
+            .nullable()
+            .optional()
+            .describe("what you're building, who it's for (max 2000 chars)"),
+        content_pillars: z
+            .array(z.string())
+            .nullable()
+            .optional()
+            .describe("themes the engine rotates across (max 10)"),
+        min_queue: z.number().int().min(1).max(30).optional().describe("ideas to keep queued"),
+        max_posts_per_day: z.number().int().min(1).max(10).optional().describe("daily posting cap"),
+    }, async (input) => {
+        try {
+            return ok(await client.patch("/autopilot", input));
+        }
+        catch (error) {
+            return err(error);
+        }
+    });
+    server.tool("list_autopilot_review", "list autopilot drafts awaiting approval (review mode). each item is a draft launch - approve, reject, or edit it via update_launch first.", {
+        page: z.number().int().positive().optional().describe("page number (default: 1)"),
+        page_size: z.number().int().min(1).max(50).optional().describe("items per page (default: 20, max: 50)"),
+    }, async ({ page, page_size }) => {
+        try {
+            const params = {};
+            if (page !== undefined)
+                params.page = String(page);
+            if (page_size !== undefined)
+                params.page_size = String(page_size);
+            return ok(await client.get("/autopilot/review", params));
+        }
+        catch (error) {
+            return err(error);
+        }
+    });
+    server.tool("approve_autopilot_draft", "approve an autopilot draft - schedules it for publishing (a stale scheduled date rolls forward to the next posting slot).", {
+        launch_id: z.string().describe("the draft launch id from list_autopilot_review"),
+    }, async ({ launch_id }) => {
+        try {
+            return ok(await client.post(`/autopilot/review/${launch_id}/approve`));
+        }
+        catch (error) {
+            return err(error);
+        }
+    });
+    server.tool("reject_autopilot_draft", "reject an autopilot draft - deletes it and refunds the launch slot. optional feedback teaches future runs what to avoid.", {
+        launch_id: z.string().describe("the draft launch id from list_autopilot_review"),
+        feedback: z.string().max(500).optional().describe("why this doesn't work (feeds future generation)"),
+    }, async ({ launch_id, feedback }) => {
+        try {
+            return ok(await client.post(`/autopilot/review/${launch_id}/reject`, feedback ? { feedback } : {}));
+        }
+        catch (error) {
+            return err(error);
+        }
+    });
+    server.tool("run_autopilot_now", "trigger a manual autopilot run immediately instead of waiting for the nightly run. steps already completed today are skipped (limited to 2 per hour).", {}, async () => {
+        try {
+            return ok(await client.post("/autopilot/run"));
+        }
+        catch (error) {
+            return err(error);
+        }
+    });
+    server.tool("list_autopilot_runs", "recent autopilot run history - one row per run step (refresh_insights, generate_blueprints, schedule_slots) with stats and errors.", {
+        limit: z.number().int().min(1).max(30).optional().describe("rows to return (default: 9)"),
+    }, async ({ limit }) => {
+        try {
+            const params = {};
+            if (limit !== undefined)
+                params.limit = String(limit);
+            return ok(await client.get("/autopilot/runs", params));
+        }
+        catch (error) {
+            return err(error);
+        }
+    });
+}

package/dist/types.d.ts

@@ -341,3 +341,52 @@ export interface Boost {
     ended_at: string | null;
     last_synced_at: string | null;
 }
+export interface AutopilotPostingTimes {
+    times: string[];
+    days: number[];
+}
+export interface AutopilotConfig {
+    enabled: boolean;
+    mode: "review" | "auto";
+    platforms: string[];
+    formats: string[];
+    persona_id: string | null;
+    posting_times: AutopilotPostingTimes;
+    run_hour: number;
+    timezone: string;
+    product_url: string | null;
+    product_brief: string | null;
+    content_pillars: string[] | null;
+    min_queue: number;
+    max_posts_per_day: number;
+    paused: boolean;
+    pause_reason: string | null;
+    created_at: string;
+    updated_at: string;
+}
+export interface AutopilotStatus {
+    configured: boolean;
+    config: AutopilotConfig | null;
+    queued_ideas: number;
+    pending_review: number;
+}
+export interface AutopilotReviewItem {
+    launch_id: string;
+    hook: string;
+    platform: string;
+    format: string;
+    content: string | null;
+    reddit_title: string | null;
+    scheduled_date: string | null;
+    media_count: number;
+    created_at: string;
+}
+export interface AutopilotRun {
+    run_date: string;
+    step: string;
+    status: string;
+    stats: Record<string, unknown>;
+    error: string | null;
+    started_at: string;
+    completed_at: string | null;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@jclvsh/dropspace",
-	"version": "2.6.0",
+	"version": "2.7.1",
 	"description": "MCP server and CLI for the Dropspace API",
 	"type": "module",
 	"main": "dist/index.js",