@fruition/fcp-mcp-server 1.29.0 → 1.30.0

package/README.md

@@ -43,6 +43,18 @@ MCP (Model Context Protocol) server that gives Claude Code direct access to the
 | `fcp_approve_job` | Approve merge for a job needing human sign-off |
 | `fcp_override_merge_window` | Force-allow an auto-merge outside its deploy window (super_admin) |
 
+### Site Ops Tools
+
+| Tool | Description |
+|------|-------------|
+| `fcp_dns_current` | Current live DNS records (A/CNAME) for a site |
+| `fcp_dns_history` | DNS snapshot history with diffs (filter recordType/limit/since) |
+| `fcp_list_deployments` | Deployments (GitHub Actions runs) across sites + stats |
+| `fcp_get_deployment_status` | Real-time k8s deployment + pod health for a site |
+| `fcp_purge_cache` | Purge edge cache (Varnish + DynamoDB + CloudFront + Cloudflare) (admin) |
+| `fcp_list_maintenance_windows` | List maintenance windows (all, or by-site with `websiteId`) |
+| `fcp_create_maintenance_window` | Create a recurring maintenance window (admin) |
+
 ### Unroo Task Management Tools
 
 | Tool | Description |

package/dist/index.d.ts

@@ -360,6 +360,62 @@ export declare class FCPClient {
         id?: number;
         repo?: string;
     }): Promise<any>;
+    getDnsCurrent(websiteId: string | number): Promise<any>;
+    getDnsHistory(websiteId: string | number, opts?: {
+        recordType?: string;
+        limit?: number;
+        since?: string;
+    }): Promise<any>;
+    listDeployments(filters?: {
+        websiteIds?: string;
+        branches?: string;
+        statuses?: string;
+        conclusions?: string;
+        events?: string;
+        actor?: string;
+        startDate?: string;
+        endDate?: string;
+        sortBy?: string;
+        sortOrder?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<any>;
+    getDeploymentStatus(siteId: string | number): Promise<any>;
+    purgeCache(siteId: string | number, body?: {
+        purgeType?: string;
+        paths?: string[];
+        urls?: string[];
+        languages?: string[];
+        warmCache?: boolean;
+        warmPages?: string[];
+        verifyAfterPurge?: boolean;
+    }): Promise<any>;
+    listMaintenanceWindows(opts?: {
+        websiteId?: string | number;
+        accountId?: string | number;
+        k8sCluster?: string;
+        enabledOnly?: boolean;
+    }): Promise<any>;
+    createMaintenanceWindow(input: {
+        name: string;
+        recurrence_type: string;
+        start_time: string;
+        end_time: string;
+        website_id?: number;
+        account_id?: number;
+        k8s_cluster?: string;
+        day_of_week?: number;
+        weeks_of_month?: number[];
+        week_of_month?: number;
+        cron_expression?: string;
+        description?: string;
+        timezone?: string;
+        default_severity?: string;
+        auto_create_events?: boolean;
+        auto_create_lead_time?: number;
+        enabled?: boolean;
+        created_by?: string;
+    }): Promise<any>;
     listCertificates(filters?: {
         status?: string;
         cluster?: string;

package/dist/index.js

@@ -114,6 +114,8 @@ const TOOL_PERMISSIONS = {
     fcp_update_freeze: 'admin',
     fcp_scan_certificates: 'admin',
     fcp_spawn_task_job: 'admin',
+    fcp_purge_cache: 'admin',
+    fcp_create_maintenance_window: 'admin',
     fcp_approve_job: 'admin',
     fcp_backup_enable: 'admin',
     fcp_backup_trigger: 'admin',
@@ -166,6 +168,11 @@ const TOOL_PERMISSIONS = {
     fcp_trusted_ip_export: 'viewer',
     fcp_list_freezes: 'viewer',
     fcp_list_certificates: 'viewer',
+    fcp_dns_current: 'viewer',
+    fcp_dns_history: 'viewer',
+    fcp_list_deployments: 'viewer',
+    fcp_get_deployment_status: 'viewer',
+    fcp_list_maintenance_windows: 'viewer',
     fcp_get_certificate: 'viewer',
     fcp_list_jobs: 'viewer',
     fcp_get_job_status: 'viewer',
@@ -837,6 +844,82 @@ export class FCPClient {
         });
     }
     // ============================================================================
+    // Site Ops (DNS / Deploy / Maintenance) Methods
+    // ============================================================================
+    async getDnsCurrent(websiteId) {
+        return this.fetch(`/api/dns-history/${encodeURIComponent(String(websiteId))}/current`);
+    }
+    async getDnsHistory(websiteId, opts) {
+        const p = new URLSearchParams();
+        if (opts?.recordType)
+            p.append('record_type', opts.recordType);
+        if (opts?.limit != null)
+            p.append('limit', String(opts.limit));
+        if (opts?.since)
+            p.append('since', opts.since);
+        const qs = p.toString();
+        return this.fetch(`/api/dns-history/${encodeURIComponent(String(websiteId))}/history${qs ? `?${qs}` : ''}`);
+    }
+    async listDeployments(filters) {
+        const p = new URLSearchParams();
+        if (filters?.websiteIds)
+            p.append('websiteIds', filters.websiteIds);
+        if (filters?.branches)
+            p.append('branches', filters.branches);
+        if (filters?.statuses)
+            p.append('statuses', filters.statuses);
+        if (filters?.conclusions)
+            p.append('conclusions', filters.conclusions);
+        if (filters?.events)
+            p.append('events', filters.events);
+        if (filters?.actor)
+            p.append('actor', filters.actor);
+        if (filters?.startDate)
+            p.append('startDate', filters.startDate);
+        if (filters?.endDate)
+            p.append('endDate', filters.endDate);
+        if (filters?.sortBy)
+            p.append('sortBy', filters.sortBy);
+        if (filters?.sortOrder)
+            p.append('sortOrder', filters.sortOrder);
+        if (filters?.limit != null)
+            p.append('limit', String(filters.limit));
+        if (filters?.offset != null)
+            p.append('offset', String(filters.offset));
+        const qs = p.toString();
+        return this.fetch(`/api/deployments${qs ? `?${qs}` : ''}`);
+    }
+    async getDeploymentStatus(siteId) {
+        return this.fetch(`/api/sites/${encodeURIComponent(String(siteId))}/deployment-status`);
+    }
+    async purgeCache(siteId, body) {
+        return this.fetch(`/api/sites/${encodeURIComponent(String(siteId))}/cache-purge`, {
+            method: 'POST',
+            body: JSON.stringify(body || {}),
+        });
+    }
+    async listMaintenanceWindows(opts) {
+        // When a websiteId is provided, use the by-site view (site + account windows).
+        if (opts?.websiteId != null) {
+            return this.fetch(`/api/maintenance/windows/by-site?website_id=${encodeURIComponent(String(opts.websiteId))}`);
+        }
+        const p = new URLSearchParams();
+        if (opts?.accountId != null)
+            p.append('account_id', String(opts.accountId));
+        if (opts?.k8sCluster)
+            p.append('k8s_cluster', opts.k8sCluster);
+        if (opts?.enabledOnly)
+            p.append('enabled', 'true');
+        const qs = p.toString();
+        return this.fetch(`/api/maintenance/windows${qs ? `?${qs}` : ''}`);
+    }
+    async createMaintenanceWindow(input) {
+        return this.fetch('/api/maintenance/windows', {
+            method: 'POST',
+            body: JSON.stringify(input),
+        });
+    }
+    // ============================================================================
     // Certificate Methods
     // ============================================================================
     async listCertificates(filters) {
@@ -3240,6 +3323,133 @@ const TOOLS = [
         },
     },
     // ============================================================================
+    // Site Ops (DNS / Deploy / Maintenance) Tools
+    // ============================================================================
+    {
+        name: 'fcp_dns_current',
+        description: 'Get the current live DNS records (A / CNAME) for a site via a fresh lookup. Use before/after a migration or DNS cutover to confirm where a domain resolves now.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                websiteId: { type: 'number', description: 'FCP website id' },
+            },
+            required: ['websiteId'],
+        },
+    },
+    {
+        name: 'fcp_dns_history',
+        description: 'Get the DNS snapshot history for a site, including diffs where records changed. Optionally filter by recordType (A|CNAME), limit, and since (ISO date).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                websiteId: { type: 'number', description: 'FCP website id' },
+                recordType: { type: 'string', enum: ['A', 'CNAME'], description: 'Filter by record type' },
+                limit: { type: 'number', description: 'Max number of snapshots to return' },
+                since: { type: 'string', description: 'ISO date; only snapshots on/after this time' },
+            },
+            required: ['websiteId'],
+        },
+    },
+    {
+        name: 'fcp_list_deployments',
+        description: 'List deployments (GitHub Actions workflow runs) across all sites, with overall stats. Filter by websiteIds, branches, statuses, conclusions, events, actor, date range; paginate and sort.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                websiteIds: { type: 'string', description: 'Comma-separated website ids' },
+                branches: { type: 'string', description: 'Comma-separated branch names' },
+                statuses: { type: 'string', description: 'Comma-separated statuses' },
+                conclusions: { type: 'string', description: 'Comma-separated conclusions (success|failure|...)' },
+                events: { type: 'string', description: "Comma-separated events; 'all' to include PR builds" },
+                actor: { type: 'string', description: 'Filter by GitHub actor' },
+                startDate: { type: 'string', description: 'ISO date lower bound' },
+                endDate: { type: 'string', description: 'ISO date upper bound' },
+                sortBy: { type: 'string', enum: ['created_at', 'completed_at', 'duration'], description: 'Sort field' },
+                sortOrder: { type: 'string', enum: ['asc', 'desc'], description: 'Sort direction (default desc)' },
+                limit: { type: 'number', description: 'Page size (default 50)' },
+                offset: { type: 'number', description: 'Offset (default 0)' },
+            },
+        },
+    },
+    {
+        name: 'fcp_get_deployment_status',
+        description: 'Get real-time Kubernetes deployment + pod health for a site (replicas, pod status, image, conditions, latest GitHub run). Use to confirm a deploy rolled out cleanly.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                siteId: { type: 'number', description: 'FCP site (website) id' },
+            },
+            required: ['siteId'],
+        },
+    },
+    {
+        name: 'fcp_purge_cache',
+        description: 'Purge a site cache across configured edge layers (Varnish + DynamoDB + CloudFront + Cloudflare). Defaults to purging everything; pass paths/urls + purgeType for a targeted purge, languages for translation cache, and warmCache/verifyAfterPurge to follow up. Edge infrastructure must be configured for the site.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                siteId: { type: 'number', description: 'FCP site (website) id' },
+                purgeType: {
+                    type: 'string',
+                    enum: ['all', 'urls', 'single', 'cloudfront-only', 'cloudflare-only', 'dynamodb-only', 'varnish-only'],
+                    description: "Which layers/scope to purge (default 'all')",
+                },
+                paths: { type: 'array', items: { type: 'string' }, description: "Paths to purge (default ['/*'])" },
+                urls: { type: 'array', items: { type: 'string' }, description: 'Specific full URLs to purge (urls/single)' },
+                languages: { type: 'array', items: { type: 'string' }, description: 'Language codes for translation cache' },
+                warmCache: { type: 'boolean', description: 'Warm cache after a successful purge' },
+                warmPages: { type: 'array', items: { type: 'string' }, description: 'Pages to warm if warmCache=true' },
+                verifyAfterPurge: { type: 'boolean', description: 'Verify the site after purge' },
+            },
+            required: ['siteId'],
+        },
+    },
+    {
+        name: 'fcp_list_maintenance_windows',
+        description: 'List recurring maintenance windows. With no args lists all windows; pass websiteId to get the windows that apply to a specific site (direct + account-scoped, with next occurrence). Also filter by accountId, k8sCluster, enabledOnly.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                websiteId: { type: 'number', description: 'Site id — switches to the by-site view (site + account windows)' },
+                accountId: { type: 'number', description: 'Filter by account id (list view)' },
+                k8sCluster: { type: 'string', description: 'Filter by k8s cluster (list view)' },
+                enabledOnly: { type: 'boolean', description: 'Only enabled windows (list view)' },
+            },
+        },
+    },
+    {
+        name: 'fcp_create_maintenance_window',
+        description: 'Create a recurring maintenance window. Requires name, recurrence_type, start_time, end_time, and a scope (one of website_id, account_id, k8s_cluster). day_of_week is required for weekly/biweekly/bimonthly/monthly. timezone defaults to America/Denver.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                name: { type: 'string', description: 'Window name' },
+                recurrence_type: {
+                    type: 'string',
+                    enum: ['weekly', 'biweekly', 'bimonthly', 'monthly', 'custom'],
+                    description: 'Recurrence type',
+                },
+                start_time: { type: 'string', description: 'Start time HH:MM[:SS]' },
+                end_time: { type: 'string', description: 'End time HH:MM[:SS]' },
+                website_id: { type: 'number', description: 'Scope: site id' },
+                account_id: { type: 'number', description: 'Scope: account id' },
+                k8s_cluster: { type: 'string', description: 'Scope: k8s cluster (INFRA-wide)' },
+                day_of_week: { type: 'number', description: 'Day of week 0=Sun..6=Sat (required for weekly/biweekly/bimonthly/monthly)' },
+                weeks_of_month: { type: 'array', items: { type: 'number' }, description: 'Weeks of month for bimonthly (e.g. [1,3])' },
+                week_of_month: { type: 'number', description: 'Week of month for monthly' },
+                cron_expression: { type: 'string', description: 'Cron expression for custom recurrence' },
+                description: { type: 'string', description: 'Optional description' },
+                timezone: { type: 'string', description: "IANA tz (default 'America/Denver')" },
+                default_severity: { type: 'string', description: "Default event severity (default 'low')" },
+                auto_create_events: { type: 'boolean', description: 'Auto-create events for occurrences' },
+                auto_create_lead_time: { type: 'number', description: 'Hours of lead time for auto-created events (default 24)' },
+                enabled: { type: 'boolean', description: 'Enabled (default true)' },
+                created_by: { type: 'string', description: 'Creator identifier' },
+            },
+            required: ['name', 'recurrence_type', 'start_time', 'end_time'],
+        },
+    },
+    // ============================================================================
     // Certificate Tools
     // ============================================================================
     {
@@ -5225,6 +5435,41 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 };
             }
             // ============================================================================
+            // Site Ops (DNS / Deploy / Maintenance) Handlers
+            // ============================================================================
+            case 'fcp_dns_current': {
+                const { websiteId } = args;
+                const result = await client.getDnsCurrent(websiteId);
+                return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+            }
+            case 'fcp_dns_history': {
+                const { websiteId, recordType, limit, since } = args;
+                const result = await client.getDnsHistory(websiteId, { recordType, limit, since });
+                return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+            }
+            case 'fcp_list_deployments': {
+                const result = await client.listDeployments(args);
+                return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+            }
+            case 'fcp_get_deployment_status': {
+                const { siteId } = args;
+                const result = await client.getDeploymentStatus(siteId);
+                return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+            }
+            case 'fcp_purge_cache': {
+                const { siteId, ...body } = args;
+                const result = await client.purgeCache(siteId, body);
+                return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+            }
+            case 'fcp_list_maintenance_windows': {
+                const result = await client.listMaintenanceWindows(args);
+                return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+            }
+            case 'fcp_create_maintenance_window': {
+                const result = await client.createMaintenanceWindow(args);
+                return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+            }
+            // ============================================================================
             // Certificate Handlers
             // ============================================================================
             case 'fcp_list_certificates': {

package/package.json

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