@fruition/fcp-mcp-server 1.29.0 → 1.31.0

package/README.md

@@ -33,6 +33,13 @@ MCP (Model Context Protocol) server that gives Claude Code direct access to the
 | `fcp_get_certificate` | Single certificate detail (issuer, SANs, expiry) |
 | `fcp_scan_certificates` | Trigger a cert-monitor scan run |
 
+### Cluster Gateway Tools
+
+| Tool | Description |
+|------|-------------|
+| `fcp_db_query` | Run a read-only SQL query (SELECT/SHOW/EXPLAIN/DESCRIBE) against a site's read-only DB replica |
+| `fcp_cluster_http` | GET/HEAD an in-cluster Kubernetes Service URL through FCP (devs firewalled off the cluster) |
+
 ### Tasker Job Control Tools
 
 | Tool | Description |
@@ -43,6 +50,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,76 @@ 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>;
+    clusterDbQuery(input: {
+        site?: number | string;
+        domain?: string;
+        sql: string;
+        limit?: number;
+    }): Promise<any>;
+    clusterHttp(input: {
+        cluster: string;
+        namespace: string;
+        service: string;
+        port: number;
+        path?: string;
+        method?: string;
+    }): Promise<any>;
     listCertificates(filters?: {
         status?: string;
         cluster?: string;
@@ -395,6 +465,46 @@ export declare class FCPClient {
         reason?: string;
         ttl_minutes?: number;
     }): Promise<any>;
+    clusterPods(input: {
+        site?: string;
+        domain?: string;
+        cluster?: string;
+        namespace?: string;
+        labelSelector?: string;
+    }): Promise<any>;
+    clusterLogs(input: {
+        pod: string;
+        site?: string;
+        domain?: string;
+        cluster?: string;
+        namespace?: string;
+    }): Promise<any>;
+    clusterIngress(input: {
+        site?: string;
+        domain?: string;
+        cluster?: string;
+        namespace?: string;
+    }): Promise<any>;
+    clusterDeployments(input: {
+        site?: string;
+        domain?: string;
+        cluster?: string;
+        namespace?: string;
+    }): Promise<any>;
+    clusterEvents(input: {
+        site?: string;
+        domain?: string;
+        cluster?: string;
+        namespace?: string;
+    }): Promise<any>;
+    clusterDescribe(input: {
+        kind: string;
+        name: string;
+        site?: string;
+        domain?: string;
+        cluster?: string;
+        namespace?: string;
+    }): Promise<any>;
     backupListSites(): Promise<any>;
     backupGetConfig(): Promise<any>;
     backupListEligible(): Promise<any>;

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',
@@ -165,7 +167,20 @@ const TOOL_PERMISSIONS = {
     fcp_trusted_ip_list_ranges: 'viewer',
     fcp_trusted_ip_export: 'viewer',
     fcp_list_freezes: 'viewer',
+    fcp_db_query: 'viewer',
+    fcp_cluster_http: 'viewer',
     fcp_list_certificates: 'viewer',
+    fcp_cluster_pods: 'viewer',
+    fcp_cluster_logs: 'viewer',
+    fcp_cluster_ingress: 'viewer',
+    fcp_cluster_deployments: 'viewer',
+    fcp_cluster_events: 'viewer',
+    fcp_cluster_describe: '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 +852,97 @@ 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),
+        });
+    }
+    // ============================================================================
+    // Cluster DB + HTTP Methods
+    // ============================================================================
+    async clusterDbQuery(input) {
+        return this.fetch('/api/cluster/db-query', {
+            method: 'POST',
+            body: JSON.stringify(input),
+        });
+    }
+    async clusterHttp(input) {
+        return this.fetch('/api/cluster/http', {
+            method: 'POST',
+            body: JSON.stringify(input),
+        });
+    }
+    // ============================================================================
     // Certificate Methods
     // ============================================================================
     async listCertificates(filters) {
@@ -910,6 +1016,90 @@ export class FCPClient {
         return this.fetch(path, { method: 'POST', body: JSON.stringify(body) });
     }
     // ============================================================================
+    // Cluster Info (read-only) Methods
+    // ============================================================================
+    async clusterPods(input) {
+        const p = new URLSearchParams();
+        if (input.site)
+            p.append('site', input.site);
+        if (input.domain)
+            p.append('domain', input.domain);
+        if (input.cluster)
+            p.append('cluster', input.cluster);
+        if (input.namespace)
+            p.append('namespace', input.namespace);
+        if (input.labelSelector)
+            p.append('labelSelector', input.labelSelector);
+        const qs = p.toString();
+        return this.fetch(`/api/cluster/info/pods${qs ? `?${qs}` : ''}`);
+    }
+    async clusterLogs(input) {
+        const p = new URLSearchParams();
+        p.append('pod', input.pod);
+        if (input.site)
+            p.append('site', input.site);
+        if (input.domain)
+            p.append('domain', input.domain);
+        if (input.cluster)
+            p.append('cluster', input.cluster);
+        if (input.namespace)
+            p.append('namespace', input.namespace);
+        return this.fetch(`/api/cluster/info/logs?${p.toString()}`);
+    }
+    async clusterIngress(input) {
+        const p = new URLSearchParams();
+        if (input.site)
+            p.append('site', input.site);
+        if (input.domain)
+            p.append('domain', input.domain);
+        if (input.cluster)
+            p.append('cluster', input.cluster);
+        if (input.namespace)
+            p.append('namespace', input.namespace);
+        const qs = p.toString();
+        return this.fetch(`/api/cluster/info/ingress${qs ? `?${qs}` : ''}`);
+    }
+    async clusterDeployments(input) {
+        const p = new URLSearchParams();
+        if (input.site)
+            p.append('site', input.site);
+        if (input.domain)
+            p.append('domain', input.domain);
+        if (input.cluster)
+            p.append('cluster', input.cluster);
+        if (input.namespace)
+            p.append('namespace', input.namespace);
+        const qs = p.toString();
+        return this.fetch(`/api/cluster/info/deployments${qs ? `?${qs}` : ''}`);
+    }
+    async clusterEvents(input) {
+        const p = new URLSearchParams();
+        if (input.site)
+            p.append('site', input.site);
+        if (input.domain)
+            p.append('domain', input.domain);
+        if (input.cluster)
+            p.append('cluster', input.cluster);
+        if (input.namespace)
+            p.append('namespace', input.namespace);
+        const qs = p.toString();
+        return this.fetch(`/api/cluster/info/events${qs ? `?${qs}` : ''}`);
+    }
+    async clusterDescribe(input) {
+        const p = new URLSearchParams();
+        p.append('kind', input.kind);
+        p.append('name', input.name);
+        if (input.site)
+            p.append('site', input.site);
+        if (input.domain)
+            p.append('domain', input.domain);
+        if (input.cluster)
+            p.append('cluster', input.cluster);
+        if (input.namespace)
+            p.append('namespace', input.namespace);
+        return this.fetch(`/api/cluster/info/describe?${p.toString()}`);
+    }
+    // ============================================================================
     // Backup Management Methods
     // ============================================================================
     async backupListSites() {
@@ -3240,6 +3430,166 @@ 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'],
+        },
+    },
+    // ============================================================================
+    // Cluster DB + HTTP Tools
+    // ============================================================================
+    {
+        name: 'fcp_db_query',
+        description: 'Run a READ-ONLY SQL query against a site\'s read-only DB replica. Provide either site (numeric id) or domain, plus a single SELECT/SHOW/EXPLAIN/DESCRIBE statement. Writes/DDL/multi-statement are rejected. Rows are capped (default 200). Use to inspect site data without cluster access.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                site: { type: 'number', description: 'Site id (provide site OR domain)' },
+                domain: { type: 'string', description: 'Site domain (provide site OR domain)' },
+                sql: { type: 'string', description: 'Single read-only statement (SELECT/SHOW/EXPLAIN/DESCRIBE)' },
+                limit: { type: 'number', description: 'Max rows to return (default 200, max 1000)' },
+            },
+            required: ['sql'],
+        },
+    },
+    {
+        name: 'fcp_cluster_http',
+        description: 'Fetch an in-cluster Kubernetes Service URL through FCP (devs are firewalled off the cluster). Builds http://<service>.<namespace>:<port>/<path>. Only GET/HEAD allowed; response body is size-capped. Use to hit health/metrics/internal endpoints.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                cluster: { type: 'string', description: 'Target cluster name (recorded for audit)' },
+                namespace: { type: 'string', description: 'Kubernetes namespace' },
+                service: { type: 'string', description: 'Kubernetes Service name' },
+                port: { type: 'number', description: 'Service port' },
+                path: { type: 'string', description: 'Request path (default /)' },
+                method: { type: 'string', enum: ['GET', 'HEAD'], description: 'HTTP method (default GET)' },
+            },
+            required: ['cluster', 'namespace', 'service', 'port'],
+        },
+    },
+    // ============================================================================
     // Certificate Tools
     // ============================================================================
     {
@@ -3338,6 +3688,93 @@ const TOOLS = [
         },
     },
     // ============================================================================
+    // Cluster Info (read-only) Tools
+    // ============================================================================
+    {
+        name: 'fcp_cluster_pods',
+        description: 'List pods in a namespace (read-only cluster gateway for firewalled devs). Target a namespace by EITHER a site (\"site\"/\"domain\") OR an explicit \"cluster\"+\"namespace\" pair. Optional labelSelector.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                site: { type: 'string', description: 'Website id or domain (resolves cluster+namespace)' },
+                domain: { type: 'string', description: 'Alias for site: a domain to resolve' },
+                cluster: { type: 'string', description: 'Explicit cluster name (with namespace)' },
+                namespace: { type: 'string', description: 'Explicit namespace (with cluster)' },
+                labelSelector: { type: 'string', description: 'Optional label selector (e.g. app=web)' },
+            },
+        },
+    },
+    {
+        name: 'fcp_cluster_logs',
+        description: 'Tail logs (last 1000 lines) for a pod (read-only cluster gateway). Requires pod. Target a namespace by EITHER a site (\"site\"/\"domain\") OR an explicit \"cluster\"+\"namespace\" pair.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                pod: { type: 'string', description: 'Pod name to read logs from' },
+                site: { type: 'string', description: 'Website id or domain (resolves cluster+namespace)' },
+                domain: { type: 'string', description: 'Alias for site: a domain to resolve' },
+                cluster: { type: 'string', description: 'Explicit cluster name (with namespace)' },
+                namespace: { type: 'string', description: 'Explicit namespace (with cluster)' },
+            },
+            required: ['pod'],
+        },
+    },
+    {
+        name: 'fcp_cluster_ingress',
+        description: 'List ingresses in a namespace (read-only cluster gateway). Target a namespace by EITHER a site (\"site\"/\"domain\") OR an explicit \"cluster\"+\"namespace\" pair.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                site: { type: 'string', description: 'Website id or domain (resolves cluster+namespace)' },
+                domain: { type: 'string', description: 'Alias for site: a domain to resolve' },
+                cluster: { type: 'string', description: 'Explicit cluster name (with namespace)' },
+                namespace: { type: 'string', description: 'Explicit namespace (with cluster)' },
+            },
+        },
+    },
+    {
+        name: 'fcp_cluster_deployments',
+        description: 'List deployments in a namespace (read-only cluster gateway). Target a namespace by EITHER a site (\"site\"/\"domain\") OR an explicit \"cluster\"+\"namespace\" pair.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                site: { type: 'string', description: 'Website id or domain (resolves cluster+namespace)' },
+                domain: { type: 'string', description: 'Alias for site: a domain to resolve' },
+                cluster: { type: 'string', description: 'Explicit cluster name (with namespace)' },
+                namespace: { type: 'string', description: 'Explicit namespace (with cluster)' },
+            },
+        },
+    },
+    {
+        name: 'fcp_cluster_events',
+        description: 'List namespace events sorted by lastTimestamp (read-only cluster gateway). Target a namespace by EITHER a site (\"site\"/\"domain\") OR an explicit \"cluster\"+\"namespace\" pair.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                site: { type: 'string', description: 'Website id or domain (resolves cluster+namespace)' },
+                domain: { type: 'string', description: 'Alias for site: a domain to resolve' },
+                cluster: { type: 'string', description: 'Explicit cluster name (with namespace)' },
+                namespace: { type: 'string', description: 'Explicit namespace (with cluster)' },
+            },
+        },
+    },
+    {
+        name: 'fcp_cluster_describe',
+        description: 'kubectl describe <kind> <name> in a namespace (read-only cluster gateway). Requires kind + name. Target a namespace by EITHER a site (\"site\"/\"domain\") OR an explicit \"cluster\"+\"namespace\" pair.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                kind: { type: 'string', description: 'Resource kind (e.g. pod, deployment, ingress)' },
+                name: { type: 'string', description: 'Resource name to describe' },
+                site: { type: 'string', description: 'Website id or domain (resolves cluster+namespace)' },
+                domain: { type: 'string', description: 'Alias for site: a domain to resolve' },
+                cluster: { type: 'string', description: 'Explicit cluster name (with namespace)' },
+                namespace: { type: 'string', description: 'Explicit namespace (with cluster)' },
+            },
+            required: ['kind', 'name'],
+        },
+    },
+    // ============================================================================
     // Backup Management Tools
     // ============================================================================
     {
@@ -5225,6 +5662,52 @@ 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) }] };
+            }
+            // ============================================================================
+            // Cluster DB + HTTP Handlers
+            // ============================================================================
+            case 'fcp_db_query': {
+                const result = await client.clusterDbQuery(args);
+                return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+            }
+            case 'fcp_cluster_http': {
+                const result = await client.clusterHttp(args);
+                return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+            }
+            // ============================================================================
             // Certificate Handlers
             // ============================================================================
             case 'fcp_list_certificates': {
@@ -5273,6 +5756,33 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
             }
             // ============================================================================
+            // Cluster Info (read-only) Handlers
+            // ============================================================================
+            case 'fcp_cluster_pods': {
+                const result = await client.clusterPods(args);
+                return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+            }
+            case 'fcp_cluster_logs': {
+                const result = await client.clusterLogs(args);
+                return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+            }
+            case 'fcp_cluster_ingress': {
+                const result = await client.clusterIngress(args);
+                return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+            }
+            case 'fcp_cluster_deployments': {
+                const result = await client.clusterDeployments(args);
+                return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+            }
+            case 'fcp_cluster_events': {
+                const result = await client.clusterEvents(args);
+                return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+            }
+            case 'fcp_cluster_describe': {
+                const result = await client.clusterDescribe(args);
+                return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+            }
+            // ============================================================================
             // Backup Management Handlers
             // ============================================================================
             case 'fcp_backup_list_sites': {

package/package.json

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