@wplaunchify/ml-mcp-server 2.1.0 → 2.1.3

package/build/tools/fluent-community-core.js

@@ -53,14 +53,18 @@ const createSpaceSchema = z.object({
     slug: z.string().optional().describe('Space slug (URL-friendly name)'),
     description: z.string().optional().describe('Space description'),
     privacy: z.enum(['public', 'private']).optional().default('public').describe('Privacy setting'),
-    status: z.enum(['active', 'inactive']).optional().default('active').describe('Space status')
+    status: z.enum(['active', 'inactive']).optional().default('active').describe('Space status'),
+    logo: z.string().optional().describe('Space logo/thumbnail URL'),
+    cover_photo: z.string().optional().describe('Space cover photo URL')
 });
 const updateSpaceSchema = z.object({
     space_id: z.number().describe('The ID of the space to update'),
     title: z.string().optional().describe('Space title'),
     description: z.string().optional().describe('Space description'),
     privacy: z.enum(['public', 'private']).optional().describe('Privacy setting'),
-    status: z.enum(['active', 'inactive', 'archived']).optional().describe('Space status')
+    status: z.enum(['active', 'inactive', 'archived']).optional().describe('Space status'),
+    logo: z.string().optional().describe('Space logo/thumbnail URL'),
+    cover_photo: z.string().optional().describe('Space cover photo URL')
 });
 // Comments
 const listCommentsSchema = z.object({
@@ -273,8 +277,8 @@ export const fluentCommunityCoreTools = [
     // Spaces (4)
     { name: 'fc_list_spaces', description: 'List all spaces in FluentCommunity', inputSchema: { type: 'object', properties: listSpacesSchema.shape } },
     { name: 'fc_get_space', description: 'Get detailed information about a specific space', inputSchema: { type: 'object', properties: getSpaceSchema.shape } },
-    { name: 'fc_create_space', description: 'Create a new space in FluentCommunity', inputSchema: { type: 'object', properties: createSpaceSchema.shape } },
-    { name: 'fc_update_space', description: 'Update an existing space', inputSchema: { type: 'object', properties: updateSpaceSchema.shape } },
+    { name: 'fc_create_space', description: 'Create a new space in FluentCommunity. IMPORTANT: For logo/cover_photo, you MUST first use fc_sideload_media to upload the image - regular URLs will be silently ignored!', inputSchema: { type: 'object', properties: createSpaceSchema.shape } },
+    { name: 'fc_update_space', description: 'Update an existing space. IMPORTANT: For logo/cover_photo, you MUST first use fc_sideload_media to upload the image - regular URLs will be silently ignored!', inputSchema: { type: 'object', properties: updateSpaceSchema.shape } },
     // Comments (4)
     { name: 'fc_list_comments', description: 'List FluentCommunity comments', inputSchema: { type: 'object', properties: listCommentsSchema.shape } },
     { name: 'fc_create_comment', description: 'Create a new comment on a post', inputSchema: { type: 'object', properties: createCommentSchema.shape } },

package/build/tools/fluent-community-learning.d.ts

@@ -341,6 +341,23 @@ export declare const fluentCommunityLearningHandlers: {
             }[];
         };
     }>;
+    fc_sideload_media: (args: any) => Promise<{
+        toolResult: {
+            content: {
+                type: string;
+                text: string;
+            }[];
+            isError?: undefined;
+        };
+    } | {
+        toolResult: {
+            isError: boolean;
+            content: {
+                type: string;
+                text: string;
+            }[];
+        };
+    }>;
     fc_search_giphy: (args: any) => Promise<{
         toolResult: {
             content: {

package/build/tools/fluent-community-learning.js

@@ -136,6 +136,10 @@ const uploadMediaSchema = z.object({
     file_url: z.string().describe('URL of file to upload'),
     file_name: z.string().optional().describe('File name')
 });
+const sideloadMediaSchema = z.object({
+    url: z.string().describe('URL of image to download and upload to FluentCommunity. Use this to set space logo/cover_photo - FluentCommunity only accepts images from its own media system.'),
+    context: z.string().optional().default('space').describe('Context for the media (space, profile, post). Default: space')
+});
 // Giphy
 const searchGiphySchema = z.object({
     query: z.string().describe('Search query for GIFs'),
@@ -187,9 +191,10 @@ export const fluentCommunityLearningTools = [
     { name: 'fc_create_quiz', description: 'Create a new quiz in a course', inputSchema: { type: 'object', properties: createQuizSchema.shape } },
     { name: 'fc_update_quiz', description: 'Update an existing quiz', inputSchema: { type: 'object', properties: updateQuizSchema.shape } },
     { name: 'fc_delete_quiz', description: 'Delete a quiz', inputSchema: { type: 'object', properties: deleteQuizSchema.shape } },
-    // Media (2)
+    // Media (3)
     { name: 'fc_list_media', description: 'List media items', inputSchema: { type: 'object', properties: listMediaSchema.shape } },
     { name: 'fc_upload_media', description: 'Upload media file', inputSchema: { type: 'object', properties: uploadMediaSchema.shape } },
+    { name: 'fc_sideload_media', description: 'Download image from any URL and upload to FluentCommunity media system. REQUIRED for setting space logo/cover_photo - FluentCommunity only accepts images from its own media table. Returns URL that works with fc_update_space.', inputSchema: { type: 'object', properties: sideloadMediaSchema.shape } },
     // Giphy (1)
     { name: 'fc_search_giphy', description: 'Search Giphy for GIFs', inputSchema: { type: 'object', properties: searchGiphySchema.shape } },
     // Webhooks (3)
@@ -424,6 +429,15 @@ export const fluentCommunityLearningHandlers = {
             return { toolResult: { isError: true, content: [{ type: 'text', text: `Error: ${error.message}` }] } };
         }
     },
+    fc_sideload_media: async (args) => {
+        try {
+            const response = await makeWordPressRequest('POST', 'fc-manager/v1/media/sideload', args);
+            return { toolResult: { content: [{ type: 'text', text: JSON.stringify(response, null, 2) }] } };
+        }
+        catch (error) {
+            return { toolResult: { isError: true, content: [{ type: 'text', text: `Error: ${error.message}` }] } };
+        }
+    },
     // Giphy
     fc_search_giphy: async (args) => {
         try {

package/build/tools/fluent-community.d.ts

@@ -1007,6 +1007,23 @@ export declare const fluentCommunityHandlers: {
             }[];
         };
     }>;
+    fc_sideload_media: (args: any) => Promise<{
+        toolResult: {
+            content: {
+                type: string;
+                text: string;
+            }[];
+            isError?: undefined;
+        };
+    } | {
+        toolResult: {
+            isError: boolean;
+            content: {
+                type: string;
+                text: string;
+            }[];
+        };
+    }>;
     fc_search_giphy: (args: any) => Promise<{
         toolResult: {
             content: {

package/build/tools/fluent-community.js

@@ -52,14 +52,18 @@ const createSpaceSchema = z.object({
     slug: z.string().optional().describe('Space slug (URL-friendly name)'),
     description: z.string().optional().describe('Space description'),
     privacy: z.enum(['public', 'private']).optional().default('public').describe('Privacy setting'),
-    status: z.enum(['active', 'inactive']).optional().default('active').describe('Space status')
+    status: z.enum(['active', 'inactive']).optional().default('active').describe('Space status'),
+    logo: z.string().optional().describe('Space logo/thumbnail URL'),
+    cover_photo: z.string().optional().describe('Space cover photo URL')
 });
 const updateSpaceSchema = z.object({
     space_id: z.number().describe('The ID of the space to update'),
     title: z.string().optional().describe('Space title'),
     description: z.string().optional().describe('Space description'),
     privacy: z.enum(['public', 'private']).optional().describe('Privacy setting'),
-    status: z.enum(['active', 'inactive', 'archived']).optional().describe('Space status')
+    status: z.enum(['active', 'inactive', 'archived']).optional().describe('Space status'),
+    logo: z.string().optional().describe('Space logo/thumbnail URL'),
+    cover_photo: z.string().optional().describe('Space cover photo URL')
 });
 const listCommentsSchema = z.object({
     post_id: z.number().optional().describe('Filter comments by post ID'),
@@ -343,6 +347,10 @@ const uploadMediaSchema = z.object({
     file_url: z.string().describe('URL of file to upload'),
     file_name: z.string().optional().describe('File name')
 });
+const sideloadMediaSchema = z.object({
+    url: z.string().describe('URL of image to download and upload to FluentCommunity. Use this to set space logo/cover_photo - FluentCommunity only accepts images from its own media system.'),
+    context: z.string().optional().default('space').describe('Context for the media (space, profile, post). Default: space')
+});
 // Giphy Schema
 const searchGiphySchema = z.object({
     query: z.string().describe('Search query for GIFs'),
@@ -469,12 +477,12 @@ export const fluentCommunityTools = [
     },
     {
         name: 'fc_create_space',
-        description: 'Create a new space in FluentCommunity',
+        description: 'Create a new space in FluentCommunity. IMPORTANT: For logo/cover_photo, you MUST first use fc_sideload_media to upload the image - regular URLs will be silently ignored!',
         inputSchema: { type: 'object', properties: createSpaceSchema.shape }
     },
     {
         name: 'fc_update_space',
-        description: 'Update an existing FluentCommunity space',
+        description: 'Update an existing FluentCommunity space. IMPORTANT: For logo/cover_photo, you MUST first use fc_sideload_media to upload the image - regular URLs will be silently ignored!',
         inputSchema: { type: 'object', properties: updateSpaceSchema.shape }
     },
     // ==================== COMMENTS TOOLS ====================
@@ -742,6 +750,11 @@ export const fluentCommunityTools = [
         description: 'Upload media file',
         inputSchema: { type: 'object', properties: uploadMediaSchema.shape }
     },
+    {
+        name: 'fc_sideload_media',
+        description: 'Download image from any URL and upload to FluentCommunity media system. REQUIRED for setting space logo/cover_photo - FluentCommunity only accepts images from its own media table. Returns URL that works with fc_update_space.',
+        inputSchema: { type: 'object', properties: sideloadMediaSchema.shape }
+    },
     // ==================== GIPHY ====================
     {
         name: 'fc_search_giphy',
@@ -1559,6 +1572,15 @@ export const fluentCommunityHandlers = {
             return { toolResult: { isError: true, content: [{ type: 'text', text: `Error: ${error.message}` }] } };
         }
     },
+    fc_sideload_media: async (args) => {
+        try {
+            const response = await makeWordPressRequest('POST', 'fc-manager/v1/media/sideload', args);
+            return { toolResult: { content: [{ type: 'text', text: JSON.stringify(response, null, 2) }] } };
+        }
+        catch (error) {
+            return { toolResult: { isError: true, content: [{ type: 'text', text: `Error: ${error.message}` }] } };
+        }
+    },
     // ==================== GIPHY HANDLERS ====================
     fc_search_giphy: async (args) => {
         try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wplaunchify/ml-mcp-server",
-  "version": "2.1.0",
+  "version": "2.1.3",
   "description": "Universal MCP Server for WordPress + Fluent Suite (Community, CRM, Cart) + MinuteLaunch Plugins. Comprehensive tools for AI-powered WordPress management via Claude, Cursor, and other MCP clients.",
   "type": "module",
   "main": "./build/server.js",