@firecms/mcp-server 3.2.0-canary.9c3d298 → 3.3.0-canary.2064433

package/dist/server.js

@@ -4,16 +4,31 @@ import { registerAuthTools } from "./tools/auth.js";
 import { registerProjectTools } from "./tools/projects.js";
 import { registerUserTools } from "./tools/users.js";
 import { registerCollectionTools } from "./tools/collections.js";
+import { registerCollectionSchemaTools } from "./tools/collection-schemas.js";
 import { registerDocumentTools } from "./tools/documents.js";
 import { registerExportTools } from "./tools/export.js";
+import { registerImportTools } from "./tools/import.js";
+import { registerProjectConfigTools } from "./tools/project-config.js";
 import { registerProjectResources } from "./resources/project.js";
 /**
  * Create and configure the FireCMS MCP server with all tools and resources.
+ *
+ * Tool categories:
+ * - Auth:              Login/logout/current user
+ * - Projects:          List projects, root collections
+ * - Project Config:    Name, colors, locale, feature toggles (admin-only)
+ * - Users:             User management (invite, roles, remove)
+ * - Collection Schemas: CRUD for collection configurations (admin-only)
+ * - AI Collections:    AI-powered schema generation/modification
+ * - Documents:         Firestore CRUD (list, get, create, update, delete, count)
+ * - Export:            Data export as JSON
+ * - Import:            Bulk data import (admin-only)
+ * - Resources:         Read-only context (collections, users, schemas, config)
  */
 export function createFireCMSMcpServer() {
     const server = new McpServer({
         name: "FireCMS Cloud",
-        version: "0.1.0",
+        version: "0.2.0",
     });
     const api = new FireCMSApiClient();
     // Auth tools (login/logout)
@@ -21,13 +36,19 @@ export function createFireCMSMcpServer() {
     // Project & user management (via backend API)
     registerProjectTools(server, api);
     registerUserTools(server, api);
+    // Project configuration (admin-only)
+    registerProjectConfigTools(server, api);
+    // Collection schema CRUD (admin-only — the core feature for agent-driven CMS management)
+    registerCollectionSchemaTools(server, api);
     // Collection schema AI tools (via backend API)
     registerCollectionTools(server, api);
     // Firestore document CRUD (via backend API proxy)
     registerDocumentTools(server, api);
     // Data export (via backend API)
     registerExportTools(server, api);
-    // Resources
+    // Data import (admin-only)
+    registerImportTools(server, api);
+    // Resources (read-only contextual data)
     registerProjectResources(server, api);
     return server;
 }

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAElE;;GAEG;AACH,MAAM,UAAU,sBAAsB;IAClC,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QACzB,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,OAAO;KACnB,CAAC,CAAC;IAEH,MAAM,GAAG,GAAG,IAAI,gBAAgB,EAAE,CAAC;IAEnC,4BAA4B;IAC5B,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAE1B,8CAA8C;IAC9C,oBAAoB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAClC,iBAAiB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE/B,+CAA+C;IAC/C,uBAAuB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAErC,kDAAkD;IAClD,qBAAqB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEnC,gCAAgC;IAChC,mBAAmB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEjC,YAAY;IACZ,wBAAwB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEtC,OAAO,MAAM,CAAC;AAClB,CAAC"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,6BAA6B,EAAE,MAAM,+BAA+B,CAAC;AAC9E,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAElE;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,sBAAsB;IAClC,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QACzB,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,OAAO;KACnB,CAAC,CAAC;IAEH,MAAM,GAAG,GAAG,IAAI,gBAAgB,EAAE,CAAC;IAEnC,4BAA4B;IAC5B,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAE1B,8CAA8C;IAC9C,oBAAoB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAClC,iBAAiB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE/B,qCAAqC;IACrC,0BAA0B,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAExC,yFAAyF;IACzF,6BAA6B,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE3C,+CAA+C;IAC/C,uBAAuB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAErC,kDAAkD;IAClD,qBAAqB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEnC,gCAAgC;IAChC,mBAAmB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEjC,2BAA2B;IAC3B,mBAAmB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEjC,wCAAwC;IACxC,wBAAwB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEtC,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/dist/tools/collection-schemas.d.ts

@@ -0,0 +1,8 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { FireCMSApiClient } from "../api-client.js";
+/**
+ * Register collection schema CRUD tools — manage the collection configurations
+ * stored in FireCMS Cloud. Admin-only operations.
+ */
+export declare function registerCollectionSchemaTools(server: McpServer, api: FireCMSApiClient): void;
+//# sourceMappingURL=collection-schemas.d.ts.map

package/dist/tools/collection-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection-schemas.d.ts","sourceRoot":"","sources":["../../src/tools/collection-schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAqCpD;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,gBAAgB,QAgRrF"}

package/dist/tools/collection-schemas.js

@@ -0,0 +1,278 @@
+import { z } from "zod";
+/**
+ * Property schema definition for collection properties.
+ * Supports all FireCMS property types.
+ */
+const PropertySchema = z.object({
+    dataType: z.enum([
+        "string", "number", "boolean", "date", "map",
+        "array", "geopoint", "reference",
+    ]).describe("The data type of this property"),
+    name: z.string().optional().describe("Display name for the property"),
+    description: z.string().optional().describe("Description shown as a tooltip"),
+    validation: z.record(z.any()).optional().describe("Validation rules (e.g., { required: true, min: 0, max: 100 })"),
+    enumValues: z.array(z.object({
+        id: z.string().describe("Enum value ID"),
+        label: z.string().describe("Display label"),
+        color: z.string().optional().describe("Color for the enum chip"),
+    })).optional().describe("Enum values for string/number fields (renders as select/chips)"),
+    multiline: z.boolean().optional().describe("For strings: render as textarea"),
+    markdown: z.boolean().optional().describe("For strings: render as markdown editor"),
+    url: z.union([z.boolean(), z.enum(["image", "video", "audio"])]).optional().describe("For strings: treat as URL, optionally specify media type"),
+    email: z.boolean().optional().describe("For strings: validate as email"),
+    storage: z.object({
+        storagePath: z.string().describe("Firebase Storage path"),
+        acceptedFiles: z.array(z.string()).optional().describe("Accepted MIME types"),
+        maxSize: z.number().optional().describe("Max file size in bytes"),
+    }).optional().describe("For strings: file upload configuration"),
+    of: z.any().optional().describe("For arrays: the property definition of array items"),
+    properties: z.record(z.any()).optional().describe("For maps: nested property definitions"),
+    path: z.string().optional().describe("For references: target collection path"),
+    previewProperties: z.array(z.string()).optional().describe("For references: properties to show in preview"),
+    disabled: z.boolean().optional().describe("If true, field is read-only in the form"),
+    columnWidth: z.number().optional().describe("Column width in pixels for table view"),
+    hideFromCollection: z.boolean().optional().describe("If true, hide from the table view"),
+}).passthrough();
+/**
+ * Register collection schema CRUD tools — manage the collection configurations
+ * stored in FireCMS Cloud. Admin-only operations.
+ */
+export function registerCollectionSchemaTools(server, api) {
+    // ─── 1. List all collection schemas ────────────────────
+    server.registerTool("list_collection_schemas", {
+        description: `List all persisted collection schemas for a FireCMS project. Returns the collection 
+configurations (name, path, properties, etc.) that define how data is displayed and edited in the CMS.`,
+        inputSchema: {
+            projectId: z.string().describe("Firebase project ID"),
+        },
+        annotations: { readOnlyHint: true },
+    }, async ({ projectId }) => {
+        try {
+            await api.assertAdmin(projectId);
+            const schemas = await api.listCollectionSchemas(projectId);
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify(schemas, null, 2),
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error: ${error.response?.data?.error ?? error.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // ─── 2. Get a single collection schema ─────────────────
+    server.registerTool("get_collection_schema", {
+        description: `Get the full schema definition for a specific collection, including all properties, 
+validation rules, display configuration, and subcollection definitions.`,
+        inputSchema: {
+            projectId: z.string().describe("Firebase project ID"),
+            collectionId: z.string().describe("Collection ID (usually same as the Firestore path, e.g., 'products')"),
+        },
+        annotations: { readOnlyHint: true },
+    }, async ({ projectId, collectionId }) => {
+        try {
+            await api.assertAdmin(projectId);
+            const schema = await api.getCollectionSchema(projectId, collectionId);
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify(schema, null, 2),
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error: ${error.response?.data?.error ?? error.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // ─── 3. Save (create/replace) a collection schema ──────
+    server.registerTool("save_collection_schema", {
+        description: `Create or fully replace a collection schema. This defines how a Firestore collection 
+is displayed and edited in FireCMS. Requires at minimum: id, path, and name. 
+
+Example schema:
+{
+  "id": "products",
+  "path": "products",
+  "name": "Products",
+  "singularName": "Product",
+  "icon": "ShoppingCart",
+  "description": "Product catalog",
+  "group": "Shop",
+  "properties": {
+    "name": { "dataType": "string", "name": "Name", "validation": { "required": true } },
+    "price": { "dataType": "number", "name": "Price", "validation": { "required": true, "min": 0 } },
+    "status": { "dataType": "string", "name": "Status", "enumValues": [
+      { "id": "draft", "label": "Draft" },
+      { "id": "published", "label": "Published" }
+    ]}
+  },
+  "propertiesOrder": ["name", "price", "status"]
+}`,
+        inputSchema: {
+            projectId: z.string().describe("Firebase project ID"),
+            collectionId: z.string().describe("Collection ID (e.g., 'products')"),
+            schema: z.object({
+                path: z.string().describe("Firestore collection path"),
+                name: z.string().describe("Display name for the collection"),
+                singularName: z.string().optional().describe("Singular name (e.g., 'Product')"),
+                description: z.string().optional().describe("Collection description"),
+                icon: z.string().optional().describe("Material icon name (e.g., 'ShoppingCart')"),
+                group: z.string().optional().describe("Navigation group name"),
+                properties: z.record(PropertySchema).describe("Property definitions keyed by field name"),
+                propertiesOrder: z.array(z.string()).optional().describe("Display order of properties"),
+                defaultSize: z.enum(["xs", "s", "m", "l", "xl"]).optional().describe("Default row size in table"),
+                initialSort: z.tuple([z.string(), z.enum(["asc", "desc"])]).optional().describe("Default sort [field, direction]"),
+            }).passthrough().describe("Complete collection schema definition"),
+        },
+    }, async ({ projectId, collectionId, schema }) => {
+        try {
+            await api.assertAdmin(projectId);
+            const fullSchema = { id: collectionId, ...schema };
+            const result = await api.saveCollectionSchema(projectId, collectionId, fullSchema);
+            return {
+                content: [{
+                        type: "text",
+                        text: `Collection schema "${collectionId}" saved successfully.\n\n${JSON.stringify(result, null, 2)}`,
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error: ${error.response?.data?.error ?? error.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // ─── 4. Update (partial) a collection schema ───────────
+    server.registerTool("update_collection_schema", {
+        description: `Partially update an existing collection schema. Only the specified fields are modified 
+(merged with the existing schema). Use this for changes like renaming, updating the group, 
+changing display settings, or adding new properties.`,
+        inputSchema: {
+            projectId: z.string().describe("Firebase project ID"),
+            collectionId: z.string().describe("Collection ID to update"),
+            data: z.record(z.any()).describe("Fields to update (merged with existing schema)"),
+        },
+    }, async ({ projectId, collectionId, data }) => {
+        try {
+            await api.assertAdmin(projectId);
+            const result = await api.updateCollectionSchema(projectId, collectionId, data);
+            return {
+                content: [{
+                        type: "text",
+                        text: `Collection schema "${collectionId}" updated successfully.\n\n${JSON.stringify(result, null, 2)}`,
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error: ${error.response?.data?.error ?? error.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // ─── 5. Delete a collection schema ─────────────────────
+    server.registerTool("delete_collection_schema", {
+        description: `Delete a collection schema from FireCMS. This removes the collection configuration 
+from the CMS — it does NOT delete the underlying Firestore data. The collection will simply 
+no longer appear in the FireCMS UI.`,
+        inputSchema: {
+            projectId: z.string().describe("Firebase project ID"),
+            collectionId: z.string().describe("Collection ID to delete"),
+        },
+        annotations: { destructiveHint: true },
+    }, async ({ projectId, collectionId }) => {
+        try {
+            await api.assertAdmin(projectId);
+            await api.deleteCollectionSchema(projectId, collectionId);
+            return {
+                content: [{
+                        type: "text",
+                        text: `Collection schema "${collectionId}" deleted successfully. Note: the underlying Firestore data was not affected.`,
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error: ${error.response?.data?.error ?? error.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // ─── 6. Save (add/update) a single property ────────────
+    server.registerTool("save_property", {
+        description: `Add or update a single property in a collection schema. This is more granular than 
+updating the entire schema — use it when you want to add a new field or modify an existing 
+one without affecting other properties.
+
+Example property:
+{
+  "dataType": "string",
+  "name": "Description",
+  "description": "Product description",
+  "multiline": true,
+  "validation": { "required": true, "max": 500 }
+}`,
+        inputSchema: {
+            projectId: z.string().describe("Firebase project ID"),
+            collectionId: z.string().describe("Collection ID"),
+            propertyKey: z.string().describe("Property field key (e.g., 'description', 'price')"),
+            property: PropertySchema.describe("Property definition"),
+            namespace: z.string().optional().describe("Dot-separated namespace for nested properties in maps (e.g., 'address' for address.street)"),
+        },
+    }, async ({ projectId, collectionId, propertyKey, property, namespace }) => {
+        try {
+            await api.assertAdmin(projectId);
+            const result = await api.saveProperty(projectId, collectionId, propertyKey, property, namespace);
+            return {
+                content: [{
+                        type: "text",
+                        text: `Property "${propertyKey}" saved in collection "${collectionId}" successfully.\n\n${JSON.stringify(result, null, 2)}`,
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error: ${error.response?.data?.error ?? error.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // ─── 7. Delete a property ──────────────────────────────
+    server.registerTool("delete_property", {
+        description: `Remove a property from a collection schema. This removes the field definition from 
+the CMS configuration — it does NOT delete the field from existing Firestore documents.`,
+        inputSchema: {
+            projectId: z.string().describe("Firebase project ID"),
+            collectionId: z.string().describe("Collection ID"),
+            propertyKey: z.string().describe("Property key to remove"),
+            namespace: z.string().optional().describe("Dot-separated namespace for nested properties"),
+        },
+        annotations: { destructiveHint: true },
+    }, async ({ projectId, collectionId, propertyKey, namespace }) => {
+        try {
+            await api.assertAdmin(projectId);
+            await api.deleteProperty(projectId, collectionId, propertyKey, namespace);
+            return {
+                content: [{
+                        type: "text",
+                        text: `Property "${propertyKey}" removed from collection "${collectionId}". Note: existing Firestore data was not affected.`,
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error: ${error.response?.data?.error ?? error.message}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=collection-schemas.js.map

package/dist/tools/collection-schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection-schemas.js","sourceRoot":"","sources":["../../src/tools/collection-schemas.ts"],"names":[],"mappings":"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"}

package/dist/tools/import.d.ts

@@ -0,0 +1,8 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { FireCMSApiClient } from "../api-client.js";
+/**
+ * Register data import tools — bulk operations for Firestore documents.
+ * Admin-only operations.
+ */
+export declare function registerImportTools(server: McpServer, api: FireCMSApiClient): void;
+//# sourceMappingURL=import.d.ts.map

package/dist/tools/import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import.d.ts","sourceRoot":"","sources":["../../src/tools/import.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,gBAAgB,QAwD3E"}

package/dist/tools/import.js

@@ -0,0 +1,57 @@
+import { z } from "zod";
+/**
+ * Register data import tools — bulk operations for Firestore documents.
+ * Admin-only operations.
+ */
+export function registerImportTools(server, api) {
+    server.registerTool("import_documents", {
+        description: `Bulk import documents into a Firestore collection. Useful for seeding data, 
+migrations, or restoring from a backup. Each document can optionally specify an ID; 
+if omitted, Firestore generates one. Use "merge: true" to update existing documents 
+instead of overwriting.
+
+Maximum 500 documents per call. For larger imports, call multiple times.`,
+        inputSchema: {
+            projectId: z.string().describe("Firebase project ID"),
+            collectionPath: z.string().describe("Target collection path (e.g., 'products')"),
+            documents: z.array(z.object({
+                id: z.string().optional().describe("Optional document ID"),
+                data: z.record(z.any()).describe("Document fields"),
+            })).describe("Array of documents to import (max 500)"),
+            merge: z.boolean().optional().describe("If true, merge with existing documents instead of overwriting (default: false)"),
+            databaseId: z.string().optional().describe("Firestore database ID (default: '(default)')"),
+        },
+    }, async ({ projectId, collectionPath, documents, merge, databaseId }) => {
+        try {
+            await api.assertAdmin(projectId);
+            if (documents.length > 500) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: `Error: Maximum 500 documents per import call. You provided ${documents.length}. Split into batches.`,
+                        }],
+                    isError: true,
+                };
+            }
+            const result = await api.importDocuments(projectId, {
+                path: collectionPath,
+                documents,
+                merge: merge ?? false,
+                databaseId,
+            });
+            return {
+                content: [{
+                        type: "text",
+                        text: `Successfully imported ${documents.length} document(s) into "${collectionPath}".\n\n${JSON.stringify(result, null, 2)}`,
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error importing: ${error.response?.data?.error ?? error.message}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=import.js.map

package/dist/tools/import.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import.js","sourceRoot":"","sources":["../../src/tools/import.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAiB,EAAE,GAAqB;IAExE,MAAM,CAAC,YAAY,CACf,kBAAkB,EAClB;QACI,WAAW,EAAE;;;;;yEAKgD;QAC7D,WAAW,EAAE;YACT,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;YACrD,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;YAChF,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;gBACxB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;gBAC1D,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC;aACtD,CAAC,CAAC,CAAC,QAAQ,CAAC,wCAAwC,CAAC;YACtD,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gFAAgF,CAAC;YACxH,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;SAC7F;KACJ,EACD,KAAK,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE;QAClE,IAAI,CAAC;YACD,MAAM,GAAG,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;YAEjC,IAAI,SAAS,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;gBACzB,OAAO;oBACH,OAAO,EAAE,CAAC;4BACN,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,8DAA8D,SAAS,CAAC,MAAM,uBAAuB;yBAC9G,CAAC;oBACF,OAAO,EAAE,IAAI;iBAChB,CAAC;YACN,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,eAAe,CAAC,SAAS,EAAE;gBAChD,IAAI,EAAE,cAAc;gBACpB,SAAS;gBACT,KAAK,EAAE,KAAK,IAAI,KAAK;gBACrB,UAAU;aACb,CAAC,CAAC;YACH,OAAO;gBACH,OAAO,EAAE,CAAC;wBACN,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,yBAAyB,SAAS,CAAC,MAAM,sBAAsB,cAAc,SAAS,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;qBAChI,CAAC;aACL,CAAC;QACN,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YAClB,OAAO;gBACH,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,oBAAoB,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;gBAC9G,OAAO,EAAE,IAAI;aAChB,CAAC;QACN,CAAC;IACL,CAAC,CACJ,CAAC;AACN,CAAC"}

package/dist/tools/project-config.d.ts

@@ -0,0 +1,8 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { FireCMSApiClient } from "../api-client.js";
+/**
+ * Register project configuration tools — manage project settings like
+ * name, colors, locale, feature toggles, etc. Admin-only operations.
+ */
+export declare function registerProjectConfigTools(server: McpServer, api: FireCMSApiClient): void;
+//# sourceMappingURL=project-config.d.ts.map

package/dist/tools/project-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-config.d.ts","sourceRoot":"","sources":["../../src/tools/project-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,gBAAgB,QAiMlF"}

package/dist/tools/project-config.js

@@ -0,0 +1,174 @@
+import { z } from "zod";
+/**
+ * Register project configuration tools — manage project settings like
+ * name, colors, locale, feature toggles, etc. Admin-only operations.
+ */
+export function registerProjectConfigTools(server, api) {
+    // ─── 1. Get project configuration ──────────────────────
+    server.registerTool("get_project_config", {
+        description: `Get the full configuration for a FireCMS project, including:
+- Project name, logo, and brand colors (primary/secondary)
+- Subscription plan and trial status
+- Feature toggles (text search, entity history, App Check)
+- Default locale settings
+- Customization revision info`,
+        inputSchema: {
+            projectId: z.string().describe("Firebase project ID"),
+        },
+        annotations: { readOnlyHint: true },
+    }, async ({ projectId }) => {
+        try {
+            await api.assertAdmin(projectId);
+            const config = await api.getProjectConfig(projectId);
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify(config, null, 2),
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error: ${error.response?.data?.error ?? error.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // ─── 2. Update project name ────────────────────────────
+    server.registerTool("update_project_name", {
+        description: "Update the display name of a FireCMS project.",
+        inputSchema: {
+            projectId: z.string().describe("Firebase project ID"),
+            name: z.string().describe("New project name"),
+        },
+    }, async ({ projectId, name }) => {
+        try {
+            await api.assertAdmin(projectId);
+            await api.updateProjectConfig(projectId, { name });
+            return {
+                content: [{
+                        type: "text",
+                        text: `Project name updated to "${name}".`,
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error: ${error.response?.data?.error ?? error.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // ─── 3. Update brand colors ────────────────────────────
+    server.registerTool("update_project_colors", {
+        description: "Update the primary and/or secondary brand colors for the CMS UI. Colors should be hex values (e.g., '#0070F4').",
+        inputSchema: {
+            projectId: z.string().describe("Firebase project ID"),
+            primaryColor: z.string().optional().describe("Primary color hex (e.g., '#0070F4')"),
+            secondaryColor: z.string().optional().describe("Secondary color hex (e.g., '#FF5B79')"),
+        },
+    }, async ({ projectId, primaryColor, secondaryColor }) => {
+        try {
+            await api.assertAdmin(projectId);
+            const data = {};
+            if (primaryColor)
+                data.primary_color = primaryColor;
+            if (secondaryColor)
+                data.secondary_color = secondaryColor;
+            await api.updateProjectConfig(projectId, data);
+            const parts = [];
+            if (primaryColor)
+                parts.push(`primary → ${primaryColor}`);
+            if (secondaryColor)
+                parts.push(`secondary → ${secondaryColor}`);
+            return {
+                content: [{
+                        type: "text",
+                        text: `Brand colors updated: ${parts.join(", ")}.`,
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error: ${error.response?.data?.error ?? error.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // ─── 4. Update default locale ──────────────────────────
+    server.registerTool("update_default_locale", {
+        description: "Change the default locale for the CMS (affects date formatting, etc.).",
+        inputSchema: {
+            projectId: z.string().describe("Firebase project ID"),
+            locale: z.string().describe("Locale code (e.g., 'en', 'es', 'de', 'fr', 'it')"),
+        },
+    }, async ({ projectId, locale }) => {
+        try {
+            await api.assertAdmin(projectId);
+            await api.updateProjectConfig(projectId, { default_locale: locale });
+            return {
+                content: [{
+                        type: "text",
+                        text: `Default locale updated to "${locale}".`,
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error: ${error.response?.data?.error ?? error.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // ─── 5. Toggle text search ─────────────────────────────
+    server.registerTool("toggle_text_search", {
+        description: "Enable or disable the local text search feature for a project.",
+        inputSchema: {
+            projectId: z.string().describe("Firebase project ID"),
+            enabled: z.boolean().describe("true to enable, false to disable"),
+        },
+    }, async ({ projectId, enabled }) => {
+        try {
+            await api.assertAdmin(projectId);
+            await api.updateProjectConfig(projectId, { local_text_search_enabled: enabled });
+            return {
+                content: [{
+                        type: "text",
+                        text: `Local text search ${enabled ? "enabled" : "disabled"}.`,
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error: ${error.response?.data?.error ?? error.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // ─── 6. Toggle entity history ──────────────────────────
+    server.registerTool("toggle_entity_history", {
+        description: "Enable or disable entity history tracking (audit log of document changes) for a project.",
+        inputSchema: {
+            projectId: z.string().describe("Firebase project ID"),
+            enabled: z.boolean().describe("true to enable, false to disable"),
+        },
+    }, async ({ projectId, enabled }) => {
+        try {
+            await api.assertAdmin(projectId);
+            await api.updateProjectConfig(projectId, { history_default_enabled: enabled });
+            return {
+                content: [{
+                        type: "text",
+                        text: `Entity history tracking ${enabled ? "enabled" : "disabled"}.`,
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error: ${error.response?.data?.error ?? error.message}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=project-config.js.map

package/dist/tools/project-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-config.js","sourceRoot":"","sources":["../../src/tools/project-config.ts"],"names":[],"mappings":"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"}