@fruition/fcp-mcp-server 1.8.0 → 1.10.0

package/dist/index.js

@@ -329,6 +329,10 @@ class FCPClient {
             body: JSON.stringify(options || {}),
         });
     }
+    // Local Setup Guide
+    async getLocalSetupGuide(siteId) {
+        return this.fetch(`/api/sites/${siteId}/local-setup`);
+    }
     // Shield Domain Management
     async shieldListDomains(filters) {
         const params = new URLSearchParams();
@@ -415,6 +419,9 @@ class FCPClient {
             body: JSON.stringify(input),
         });
     }
+    async backupSanitizeStatus(jobId) {
+        return this.fetch(`/api/backup/download/status?jobId=${encodeURIComponent(jobId)}`);
+    }
     async backupListPairings(siteId) {
         const params = new URLSearchParams();
         if (siteId)
@@ -1889,6 +1896,20 @@ const TOOLS = [
             required: ['website_id'],
         },
     },
+    {
+        name: 'fcp_get_local_setup_guide',
+        description: 'Generate a local development setup guide for a website. Returns CMS-specific instructions for cloning, DDEV configuration, .env template, database import, and verification steps. Works for Bedrock WordPress, standard WordPress, and Drupal sites.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                website_id: {
+                    type: 'number',
+                    description: 'The website ID to generate setup guide for',
+                },
+            },
+            required: ['website_id'],
+        },
+    },
     {
         name: 'fcp_create_site',
         description: 'Create a new website with optional staging environments. Production site is created first, then staging sites are linked to it.',
@@ -2294,7 +2315,7 @@ const TOOLS = [
     },
     {
         name: 'fcp_backup_download_prepared',
-        description: 'Prepare a backup download with optional sanitization. Returns a presigned download URL with metadata.',
+        description: 'Prepare a backup download with optional sanitization. For production backups, sanitization is the default — this returns a jobId to poll via fcp_backup_sanitize_status. For non-production backups, returns a presigned download URL directly.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -2316,12 +2337,26 @@ const TOOLS = [
                 },
                 sanitize: {
                     type: 'boolean',
-                    description: 'Whether to sanitize production data (optional)',
+                    description: 'Whether to sanitize production data. Defaults to true for production environments. Set to false to skip sanitization (non-production only).',
                 },
             },
             required: ['siteId', 'backupId', 'downloadType'],
         },
     },
+    {
+        name: 'fcp_backup_sanitize_status',
+        description: 'Check the status of a database sanitization job. Poll this after fcp_backup_download_prepared returns a jobId. When status is "completed", the response includes a presigned downloadUrl for the sanitized backup.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                jobId: {
+                    type: 'string',
+                    description: 'The sanitization job ID returned by fcp_backup_download_prepared',
+                },
+            },
+            required: ['jobId'],
+        },
+    },
     {
         name: 'fcp_backup_list_pairings',
         description: 'List site pairings for backup management. Optionally filter by site ID. Shows production/staging/dev relationships grouped by account.',
@@ -2610,6 +2645,22 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     ],
                 };
             }
+            case 'fcp_get_local_setup_guide': {
+                const { website_id } = args;
+                const result = await client.getLocalSetupGuide(website_id);
+                // Return the guide as readable text, with structured data as JSON
+                const guide = result.guide || '';
+                const siteInfo = result.site || {};
+                const ddevInfo = result.ddev || {};
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: guide + '\n\n---\n\n**Structured Data:**\n```json\n' + JSON.stringify({ site: siteInfo, ddev: ddevInfo }, null, 2) + '\n```',
+                        },
+                    ],
+                };
+            }
             case 'fcp_create_site': {
                 const { account_id, domain, cms, url_full, git_provider, git_link, hosting_provider, fru_hosted, k8s_cluster, k8s_namespace, staging, } = args;
                 const result = await client.createSite({ account_id, domain, cms, url_full, git_provider, git_link, hosting_provider, fru_hosted, k8s_cluster, k8s_namespace }, staging);
@@ -3330,6 +3381,13 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
                 };
             }
+            case 'fcp_backup_sanitize_status': {
+                const { jobId } = args;
+                const result = await client.backupSanitizeStatus(jobId);
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+                };
+            }
             case 'fcp_backup_list_pairings': {
                 const { siteId } = args;
                 const result = await client.backupListPairings(siteId);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fruition/fcp-mcp-server",
-  "version": "1.8.0",
+  "version": "1.10.0",
   "description": "MCP Server for FCP Launch Coordination System - enables Claude Code to interact with FCP launches and track development time",
   "main": "dist/index.js",
   "type": "module",