@fruition/fcp-mcp-server 1.19.0 → 1.20.0

package/dist/index.js

@@ -99,6 +99,7 @@ const TOOL_PERMISSIONS = {
     fcp_create_launch: 'admin',
     fcp_update_launch: 'admin',
     fcp_update_site: 'admin',
+    fcp_update_client_profile: 'admin',
     fcp_delete_checklist_item: 'admin',
     fcp_shield_add_domain: 'admin',
     fcp_shield_update_domain: 'admin',
@@ -142,6 +143,8 @@ const TOOL_PERMISSIONS = {
     fcp_list_sites: 'viewer',
     fcp_search_sites: 'viewer',
     fcp_get_site: 'viewer',
+    fcp_list_clients: 'viewer',
+    fcp_get_client: 'viewer',
     fcp_get_local_setup_guide: 'viewer',
     fcp_shield_list_domains: 'viewer',
     fcp_shield_get_domain: 'viewer',
@@ -514,6 +517,35 @@ class FCPClient {
     async getLocalSetupGuide(siteId) {
         return this.fetch(`/api/sites/${siteId}/local-setup`);
     }
+    // WebOps Client Directory
+    async listClients(filters) {
+        const params = new URLSearchParams();
+        if (filters?.q)
+            params.set('q', filters.q);
+        if (filters?.webops_lead)
+            params.set('webops_lead', filters.webops_lead);
+        if (filters?.contract_type)
+            params.set('contract_type', filters.contract_type);
+        if (filters?.tier)
+            params.set('tier', filters.tier);
+        if (filters?.marketing !== undefined)
+            params.set('marketing', String(filters.marketing));
+        if (filters?.status)
+            params.set('status', filters.status);
+        if (filters?.limit)
+            params.set('limit', String(filters.limit));
+        const qs = params.toString();
+        return this.fetch(`/api/clients${qs ? `?${qs}` : ''}`);
+    }
+    async getClient(accountId) {
+        return this.fetch(`/api/clients/${accountId}/profile`);
+    }
+    async updateClientProfile(accountId, updates) {
+        return this.fetch(`/api/clients/${accountId}/profile`, {
+            method: 'PUT',
+            body: JSON.stringify(updates),
+        });
+    }
     // Shield Domain Management
     async shieldListDomains(filters) {
         const params = new URLSearchParams();
@@ -2455,6 +2487,89 @@ const TOOLS = [
             required: ['website_id'],
         },
     },
+    // WebOps Client Directory
+    {
+        name: 'fcp_list_clients',
+        description: 'List client accounts from the WebOps Client Directory with their WebOps profile (lead, sponsor, contract type, service tier, site count). Use to answer "who manages X", "list all retainer clients", "which clients does Janine lead".',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                q: { type: 'string', description: 'Search by client/account name (substring match)' },
+                webops_lead: { type: 'string', description: 'Filter by WebOps lead (e.g. "Janine", "Mike")' },
+                contract_type: {
+                    type: 'string',
+                    description: 'Filter by contract type: tm, block, tm_or_block, retainer, pro_bono, other',
+                },
+                tier: {
+                    type: 'string',
+                    description: 'Filter by account service tier: standard, frucare, ada, redteam',
+                },
+                marketing: {
+                    type: 'boolean',
+                    description: 'Filter to marketing clients only (true) or non-marketing (false)',
+                },
+                status: {
+                    type: 'string',
+                    description: 'Profile status: active (default), deactivated, or all',
+                },
+                limit: { type: 'number', description: 'Max rows to return (default 300)' },
+            },
+        },
+    },
+    {
+        name: 'fcp_get_client',
+        description: "Get the full WebOps profile for one client account: relationship/commercial data, primary contacts, and all of the account's websites with detected analytics (GA4/GTM/Clarity/Bugherd).",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                account_id: { type: 'number', description: 'The account ID (required)' },
+            },
+            required: ['account_id'],
+        },
+    },
+    {
+        name: 'fcp_update_client_profile',
+        description: "Update business/relationship fields on a client's WebOps profile. Technical facts (CMS, hosting, FruCare) are NOT editable here -- FCP detects/owns those. Only provided fields change.",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                account_id: { type: 'number', description: 'The account ID to update (required)' },
+                webops_lead: { type: 'string', description: 'Canonical WebOps lead' },
+                relationship_sponsor: { type: 'string', description: 'Relationship sponsor' },
+                contract_type: {
+                    type: 'string',
+                    description: 'tm, block, tm_or_block, retainer, pro_bono, none, other',
+                },
+                contract_rate: { type: 'string', description: 'Freeform rate (e.g. "$155/hour")' },
+                contract_notes: { type: 'string', description: 'Contract notes' },
+                is_marketing_client: { type: 'boolean', description: 'Whether this is a marketing client' },
+                comms_platform: {
+                    type: 'string',
+                    description: 'Client collaboration platform (Google / MS Teams)',
+                },
+                client_time_zone: { type: 'string', description: 'Client time zone' },
+                meeting_cadence: { type: 'string', description: 'Meeting cadence' },
+                meeting_attendees: { type: 'string', description: 'Meeting attendees' },
+                last_client_contact: { type: 'string', description: 'Last contact note' },
+                looker_studio_url: { type: 'string', description: 'Looker Studio report URL' },
+                shared_drive_url: { type: 'string', description: 'Shared drive URL' },
+                client_assets_url: { type: 'string', description: 'Client assets URL' },
+                unroo_board_url: { type: 'string', description: 'Unroo board URL' },
+                client_goals: { type: 'string', description: 'Client goals & focus areas' },
+                what_you_need_to_know: {
+                    type: 'string',
+                    description: 'Key things to know about this client',
+                },
+                general_notes: { type: 'string', description: 'General notes' },
+                status: { type: 'string', description: 'active or deactivated' },
+                mark_reviewed: {
+                    type: 'boolean',
+                    description: 'Set true to stamp last_reviewed_at = now (confirms the profile is accurate)',
+                },
+            },
+            required: ['account_id'],
+        },
+    },
     // Fruition Shield - Shared WAF Gateway
     {
         name: 'fcp_shield_list_domains',
@@ -3253,6 +3368,28 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     ],
                 };
             }
+            // WebOps Client Directory Handlers
+            case 'fcp_list_clients': {
+                const filters = args;
+                const result = await client.listClients(filters);
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+                };
+            }
+            case 'fcp_get_client': {
+                const { account_id } = args;
+                const result = await client.getClient(account_id);
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+                };
+            }
+            case 'fcp_update_client_profile': {
+                const { account_id, ...updates } = args;
+                const result = await client.updateClientProfile(account_id, updates);
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+                };
+            }
             // Launch CRUD Handlers
             case 'fcp_create_launch': {
                 const { name, platform, launch_type, target_launch_date, ...rest } = args;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fruition/fcp-mcp-server",
-  "version": "1.19.0",
+  "version": "1.20.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",