@jclvsh/dropspace 2.0.0

package/dist/tools/keys.js

@@ -0,0 +1,107 @@
+import { z } from "zod";
+const SCOPES = ["read", "write", "delete", "publish", "generate", "admin"];
+export function registerKeyTools(server, client) {
+    server.tool("get_current_api_key", "get the current API key's info — name, scopes, and prefix (no scope required)", {}, async () => {
+        try {
+            const result = await client.get("/keys/me");
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    server.tool("list_api_keys", "list your API keys (requires admin scope)", {}, async () => {
+        try {
+            const result = await client.get("/keys");
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    server.tool("create_api_key", "create a new API key — the raw key is returned once, store it securely (requires admin scope)", {
+        name: z.string().min(1).max(100).describe("key name (1-100 characters)"),
+        scopes: z.array(z.enum(SCOPES)).optional().describe("permission scopes (defaults to all scopes)"),
+    }, async (args) => {
+        try {
+            const result = await client.post("/keys", args);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    server.tool("rename_api_key", "rename an API key (requires admin scope)", {
+        id: z.string().uuid().describe("API key ID"),
+        name: z.string().min(1).max(100).describe("new key name (1-100 characters)"),
+    }, async ({ id, name }) => {
+        try {
+            const result = await client.patch(`/keys/${id}`, { name });
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    server.tool("revoke_api_key", "permanently revoke an API key (requires admin scope)", {
+        id: z.string().uuid().describe("API key ID"),
+    }, async ({ id }) => {
+        try {
+            await client.delete(`/keys/${id}`);
+            return {
+                content: [{ type: "text", text: "API key revoked successfully" }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}

package/dist/tools/launches.d.ts

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

package/dist/tools/launches.js

@@ -0,0 +1,492 @@
+import { z } from "zod";
+// 11 enum values but only 10 distinct platforms — linkedin-community is a LinkedIn variant, not a separate platform.
+// auto-post (7): facebook, linkedin, twitter, reddit, instagram, tiktok, youtube
+// guided  (3): substack, producthunt, hackernews
+// .max(10) on platform arrays reflects the 10 real platforms.
+const PLATFORMS = [
+    "facebook",
+    "linkedin",
+    "linkedin-community",
+    "twitter",
+    "reddit",
+    "instagram",
+    "tiktok",
+    "youtube",
+    "substack",
+    "producthunt",
+    "hackernews",
+];
+const AUTO_POST_PLATFORMS = ["facebook", "linkedin", "twitter", "reddit", "instagram", "tiktok", "youtube"];
+const VIDEO_GENERATION_PLATFORMS = ["instagram", "tiktok"];
+const inlineMediaItemSchema = z.discriminatedUnion("source", [
+    z.object({
+        source: z.literal("url"),
+        url: z.string().url().describe("media URL"),
+        filename: z.string().max(255).optional().describe("filename"),
+    }),
+    z.object({
+        source: z.literal("base64"),
+        data: z.string().min(1).describe("base64-encoded data"),
+        filename: z.string().min(1).max(255).describe("filename (required for base64)"),
+        mime_type: z
+            .enum(["image/jpeg", "image/png", "image/webp", "image/gif", "video/mp4", "video/quicktime"])
+            .describe("MIME type (required for base64)"),
+    }),
+]);
+const mediaAssetSchema = z.object({
+    id: z.string().min(1).describe("asset ID"),
+    url: z.string().url().describe("asset URL"),
+    type: z.enum(["image", "video"]).describe("asset type"),
+    filename: z.string().min(1).describe("filename"),
+    size: z.number().nonnegative().describe("file size in bytes"),
+    mime_type: z.string().min(1).describe("MIME type"),
+    width: z.number().positive().nullable().optional().describe("width in pixels"),
+    height: z.number().positive().nullable().optional().describe("height in pixels"),
+    thumbnail_url: z.string().url().nullable().optional().describe("thumbnail URL"),
+    generation_id: z.string().optional().describe("AI generation ID"),
+});
+export function registerLaunchTools(server, client) {
+    server.tool("list_launches", "list your launches with pagination", {
+        page: z.number().int().positive().optional().describe("page number (default: 1)"),
+        page_size: z.number().int().min(1).max(100).optional().describe("items per page (default: 50, max: 100)"),
+    }, async ({ page, page_size }) => {
+        try {
+            const params = {};
+            if (page !== undefined)
+                params.page = String(page);
+            if (page_size !== undefined)
+                params.page_size = String(page_size);
+            const result = await client.get("/launches", params);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    server.tool("create_launch", "create a new launch for publishing to social platforms", {
+        title: z.string().describe("launch title"),
+        product_description: z
+            .string()
+            .optional()
+            .describe("product description - required unless custom_content or platform_contents is provided"),
+        platforms: z
+            .array(z.enum(PLATFORMS))
+            .min(1)
+            .max(10)
+            .optional()
+            .describe("target platforms - required unless dropspace_platforms or user_platform_accounts is provided (inferred from their union)"),
+        product_url: z.string().url().optional().describe("product URL"),
+        scheduled_date: z
+            .string()
+            .optional()
+            .describe("ISO 8601 datetime to schedule (must be at least 15 minutes in the future)"),
+        persona_id: z.string().uuid().optional().describe("persona ID for tone/style"),
+        dropspace_platforms: z
+            .array(z.enum(PLATFORMS))
+            .optional()
+            .describe("platforms to post via official dropspace accounts"),
+        media_mode: z.enum(["images", "video"]).optional().describe("media mode for the launch"),
+        user_platform_accounts: z
+            .record(z.string(), z.string())
+            .optional()
+            .describe('map of platform key to token_id (UUID). most platforms use simple keys: "twitter", "reddit", "instagram", "tiktok", "youtube". LinkedIn uses "linkedin:personal" or "linkedin:organization:<org_id>". Facebook uses "facebook:page:<page_id>". multiple keys allowed'),
+        platform_contents: z
+            .record(z.string(), z.record(z.string(), z.unknown()))
+            .optional()
+            .describe('per-platform content — each value needs "content" (string). Reddit also requires "title" (max 300). Twitter supports "thread" (string[], max 6, each ≤280 or ≤25,000 for X Premium) instead of "content". TikTok supports "tiktok_settings": { "privacy_level": "PUBLIC_TO_EVERYONE"|"FOLLOWER_OF_CREATOR"|"MUTUAL_FOLLOW_FRIENDS"|"SELF_ONLY" (required before publish), "allow_comments"?, "allow_duet"?, "allow_stitch"?, "is_commercial"?, "is_your_brand"?, "is_branded_content"?, "auto_add_music"? (booleans) }. YouTube requires video and supports "title" (max 100 chars). character limits: Twitter 280/tweet (25,000 for X Premium), LinkedIn 3000, Instagram 2200, Reddit 3000, Facebook 3000, TikTok 4000, YouTube 5000 (description). X Premium status is auto-detected from the connected account. mutually exclusive with custom_content'),
+        custom_content: z
+            .union([z.string().min(1), z.array(z.string()).min(1).max(6)])
+            .optional()
+            .describe("single content string for all platforms, or array of tweet strings for twitter thread mode (each ≤280 chars or ≤25,000 for X Premium, mutually exclusive with platform_contents)"),
+        custom_content_reddit_title: z
+            .string()
+            .min(1)
+            .max(300)
+            .optional()
+            .describe("reddit title (required when custom_content is used with reddit platform)"),
+        media: z
+            .array(inlineMediaItemSchema)
+            .min(1)
+            .max(10)
+            .optional()
+            .describe("inline media (URL or base64, 1-10 items, mutually exclusive with media_assets)"),
+        media_assets: z
+            .array(mediaAssetSchema)
+            .optional()
+            .describe("pre-uploaded media asset references (mutually exclusive with media)"),
+        media_attach_platforms: z
+            .array(z.enum(AUTO_POST_PLATFORMS))
+            .optional()
+            .describe("platforms to attach media to"),
+        // Disabled: AI video generation is currently disabled in production
+        // generate_ai_videos: z
+        // 	.array(z.enum(VIDEO_GENERATION_PLATFORMS))
+        // 	.optional()
+        // 	.describe("platforms to auto-generate AI videos for"),
+        publish: z
+            .boolean()
+            .optional()
+            .describe("immediately publish after creation (returns 202). mutually exclusive with scheduled_date"),
+        wait: z
+            .boolean()
+            .optional()
+            .describe("wait for publishing to complete and return post URLs inline (returns 200). requires publish: true"),
+    }, async (args) => {
+        try {
+            const result = await client.post("/launches", args);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    server.tool("get_launch", "get a launch by ID with posting status per platform", {
+        id: z.string().uuid().describe("launch ID"),
+    }, async ({ id }) => {
+        try {
+            const result = await client.get(`/launches/${id}`);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    server.tool("update_launch", "update a launch (cannot update running/completed/partial launches)", {
+        id: z.string().uuid().describe("launch ID"),
+        scheduled_date: z.string().nullable().optional().describe("ISO 8601 datetime or null to clear"),
+        status: z
+            .enum(["draft", "manual", "trigger", "scheduled", "cancelled"])
+            .optional()
+            .describe("launch status"),
+        platforms: z
+            .array(z.enum(PLATFORMS))
+            .min(1)
+            .max(10)
+            .optional()
+            .describe("target platforms for this launch"),
+        name: z.string().max(200).optional().describe("launch name/title"),
+        product_description: z.string().max(10000).optional().describe("product description"),
+        product_url: z.string().url().or(z.literal("")).optional().describe("product URL (empty string to clear)"),
+        persona_id: z
+            .string()
+            .uuid()
+            .nullable()
+            .optional()
+            .describe("persona ID for content generation, null to clear"),
+        platform_contents: z
+            .record(z.string(), z.record(z.string(), z.unknown()))
+            .optional()
+            .describe('per-platform content update (deep-merged with existing). each value can include "content" (string). Twitter supports "thread" (string[]) instead. Reddit "title" is optional on update. TikTok "tiktok_settings" is deep-merged — you can update individual fields (e.g. just "privacy_level") without overwriting the rest. see create_launch for full field details'),
+        dropspace_platforms: z.array(z.enum(PLATFORMS)).optional().describe("official dropspace account platforms"),
+        user_platform_accounts: z
+            .record(z.string(), z.string())
+            .optional()
+            .describe('map of platform key to token_id (UUID). most platforms use simple keys: "twitter", "reddit", "instagram", "tiktok", "youtube". LinkedIn uses "linkedin:personal" or "linkedin:organization:<org_id>". Facebook uses "facebook:page:<page_id>". multiple keys allowed'),
+        media: z
+            .array(inlineMediaItemSchema)
+            .min(1)
+            .max(10)
+            .optional()
+            .describe("inline media (URL or base64, 1-10 items, mutually exclusive with media_assets)"),
+        media_assets: z
+            .array(mediaAssetSchema)
+            .optional()
+            .describe("pre-uploaded media asset references (mutually exclusive with media)"),
+        media_attach_platforms: z
+            .array(z.enum(AUTO_POST_PLATFORMS))
+            .optional()
+            .describe("platforms to attach media to"),
+        media_mode: z.enum(["images", "video"]).optional().describe("media mode"),
+    }, async ({ id, ...body }) => {
+        try {
+            const result = await client.patch(`/launches/${id}`, body);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    server.tool("delete_launch", "delete a launch (cannot delete running launches)", {
+        id: z.string().uuid().describe("launch ID"),
+    }, async ({ id }) => {
+        try {
+            await client.delete(`/launches/${id}`);
+            return {
+                content: [{ type: "text", text: "launch deleted successfully" }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    server.tool("publish_launch", "publish a launch to all configured platforms (queued async)", {
+        id: z.string().uuid().describe("launch ID"),
+    }, async ({ id }) => {
+        try {
+            const result = await client.post(`/launches/${id}/publish`);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    server.tool("retry_launch", "retry failed platforms for a launch", {
+        id: z.string().uuid().describe("launch ID"),
+    }, async ({ id }) => {
+        try {
+            const result = await client.post(`/launches/${id}/retry`);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    server.tool("generate_content", "generate AI content for a launch's platforms using Claude", {
+        id: z.string().uuid().describe("launch ID"),
+        platforms: z
+            .array(z.enum(PLATFORMS))
+            .min(1)
+            .max(10)
+            .optional()
+            .describe("specific platforms to generate for (defaults to all launch platforms)"),
+        // Disabled: AI video generation is currently disabled in production
+        // generate_video_scripts: z
+        // 	.array(z.enum(VIDEO_GENERATION_PLATFORMS))
+        // 	.optional()
+        // 	.describe("platforms to generate video scripts for"),
+    }, async ({ id, platforms }) => {
+        try {
+            const body = {};
+            if (platforms)
+                body.platforms = platforms;
+            // Disabled: AI video generation is currently disabled in production
+            // if (generate_video_scripts) body.generate_video_scripts = generate_video_scripts;
+            const result = await client.post(`/launches/${id}/generate-content`, body);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    server.tool("get_launch_analytics", "get publishing analytics with per-post engagement metrics (likes, views, shares, etc.)", {
+        id: z.string().uuid().describe("launch ID"),
+    }, async ({ id }) => {
+        try {
+            const result = await client.get(`/launches/${id}/analytics`);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    server.tool("get_batch_launch_analytics", "get cached analytics for multiple launches in one request (no live refresh, max 100 IDs)", {
+        ids: z.array(z.string().uuid()).min(1).max(100).describe("launch IDs to fetch analytics for"),
+    }, async ({ ids }) => {
+        try {
+            const result = await client.get("/launches/analytics", {
+                ids: ids.join(","),
+            });
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    server.tool("get_launch_status", "get detailed posting status with per-platform logs", {
+        id: z.string().uuid().describe("launch ID"),
+    }, async ({ id }) => {
+        try {
+            const result = await client.get(`/launches/${id}/status`);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    server.tool("retry_launch_content", "retry AI content generation for failed platforms (requires generate scope)", {
+        id: z.string().uuid().describe("launch ID"),
+        platforms: z
+            .array(z.enum(PLATFORMS))
+            .min(1)
+            .optional()
+            .describe("specific platforms to retry (defaults to all failed platforms)"),
+    }, async ({ id, platforms }) => {
+        try {
+            const body = {};
+            if (platforms)
+                body.platforms = platforms;
+            const result = await client.post(`/launches/${id}/retry-content`, body);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // ============================================================================
+    // Delete Post
+    // ============================================================================
+    server.tool("delete_post", "Delete a single published post from its platform. Only works for Twitter, Facebook, LinkedIn, Reddit, and YouTube. Instagram and TikTok do not support API deletion.", {
+        launch_id: z.string().uuid().describe("launch ID"),
+        posting_log_id: z.string().uuid().describe("posting log ID (from launch status)"),
+    }, async ({ launch_id, posting_log_id }) => {
+        try {
+            const result = await client.delete(`/launches/${launch_id}/posts/${posting_log_id}`);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // ============================================================================
+    // Delete All Posts
+    // ============================================================================
+    server.tool("delete_all_posts", "Delete all published posts for a launch from their platforms. Only deletes from Twitter, Facebook, LinkedIn, Reddit, and YouTube. Instagram and TikTok posts are skipped (require manual deletion).", {
+        launch_id: z.string().uuid().describe("launch ID"),
+    }, async ({ launch_id }) => {
+        try {
+            const result = await client.delete(`/launches/${launch_id}/posts`);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}

package/dist/tools/personas.d.ts

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