@firecms/mcp-server 3.3.0-canary.451aa49 → 3.3.0-canary.7e3431b

package/README.md

@@ -1,6 +1,8 @@
 # @firecms/mcp-server
 
-MCP server for [FireCMS Cloud](https://firecms.co). Lets AI assistants manage your CMS — browse data, create/update/delete documents, manage users, and generate collection schemas with AI.
+MCP server for [FireCMS Cloud](https://firecms.co). Lets AI assistants manage your CMS — browse data, create/update/delete documents, manage collection schemas and properties, configure project settings, manage users, and generate collection schemas with AI.
+
+> **Admin-only**: All write operations require the authenticated user to have the `admin` role on the target project. Read operations are available to any authenticated project member.
 
 ## Setup
 
@@ -23,6 +25,19 @@ Add to `claude_desktop_config.json`:
 }
 ```
 
+Or use npx (no build required):
+
+```json
+{
+  "mcpServers": {
+    "firecms": {
+      "command": "npx",
+      "args": ["@firecms/mcp-server"]
+    }
+  }
+}
+```
+
 Use `firecms_login` to sign in when prompted. Tokens shared with FireCMS CLI (`~/.firecms/tokens.json`).
 
 ## Tools
@@ -34,16 +49,47 @@ Use `firecms_login` to sign in when prompted. Tokens shared with FireCMS CLI (`~
 | `firecms_logout` | Sign out |
 | `firecms_get_current_user` | Show current user |
 
-### Projects & Users
+### Projects & Root Collections
 | Tool | Description |
 |------|-------------|
 | `list_projects` | List FireCMS Cloud projects |
 | `get_root_collections` | List Firestore root collections |
+
+### Project Configuration 🔒
+| Tool | Description |
+|------|-------------|
+| `get_project_config` | Get full project config (name, colors, plan, features) |
+| `update_project_name` | Rename a project |
+| `update_project_colors` | Update primary/secondary brand colors |
+| `update_default_locale` | Change the default locale |
+| `toggle_text_search` | Enable/disable local text search |
+| `toggle_entity_history` | Enable/disable entity history tracking |
+
+### Users 🔒
+| Tool | Description |
+|------|-------------|
 | `list_users` | List project users and roles |
 | `add_user` | Invite a user |
 | `update_user_roles` | Change user roles |
 | `remove_user` | Remove a user |
 
+### Collection Schemas 🔒
+| Tool | Description |
+|------|-------------|
+| `list_collection_schemas` | List all persisted collection schemas |
+| `get_collection_schema` | Get full schema for a collection |
+| `save_collection_schema` | Create or replace a collection schema |
+| `update_collection_schema` | Partially update a collection schema |
+| `delete_collection_schema` | Delete a collection schema (data untouched) |
+| `save_property` | Add or update a single property in a collection |
+| `delete_property` | Remove a property from a collection schema |
+
+### AI Schema Generation
+| Tool | Description |
+|------|-------------|
+| `generate_collection` | AI-generate a collection schema from a prompt |
+| `modify_collection` | AI-modify an existing schema from a prompt |
+
 ### Documents (Firestore CRUD)
 | Tool | Description |
 |------|-------------|
@@ -54,16 +100,49 @@ Use `firecms_login` to sign in when prompted. Tokens shared with FireCMS CLI (`~
 | `delete_document` | Delete a document |
 | `count_documents` | Count documents in a collection |
 
-### AI & Export
+### Data Import & Export
 | Tool | Description |
 |------|-------------|
-| `generate_collection` | AI-generate a collection schema |
-| `modify_collection` | AI-modify an existing schema |
 | `export_collection` | Export collection data as JSON |
+| `import_documents` 🔒 | Bulk import documents (max 500/call) |
+
+> 🔒 = Admin-only operation
 
 ## Resources
 
 | URI | Description |
 |-----|-------------|
-| `firecms://projects/{id}/collections` | Project's Firestore collections |
-| `firecms://projects/{id}/users` | Project users |
+| `firecms://projects/{id}/collections` | Firestore root-level collections |
+| `firecms://projects/{id}/users` | Project users and roles |
+| `firecms://projects/{id}/schemas` | All collection schemas (full config tree) |
+| `firecms://projects/{id}/config` | Project configuration snapshot |
+
+## Example Workflows
+
+### Create a collection from scratch
+```
+1. firecms_login          → authenticate
+2. list_projects          → pick your project
+3. save_collection_schema → define the schema
+4. import_documents       → seed with initial data
+```
+
+### AI-assisted schema creation
+```
+1. generate_collection    → describe what you want in natural language
+2. save_collection_schema → persist the generated schema
+```
+
+### Modify an existing collection
+```
+1. get_collection_schema  → read current schema
+2. save_property          → add/update individual fields
+3. update_collection_schema → update display settings
+```
+
+## Security
+
+- **Authentication**: Google OAuth via browser, same as `firecms login` CLI
+- **Authorization**: Write operations enforce admin role check per project
+- **Token storage**: `~/.firecms/tokens.json` (shared with CLI)
+- **Admin cache**: Role checks are cached for 5 minutes per project

package/dist/api-client.d.ts

@@ -1,18 +1,71 @@
 /**
  * Typed HTTP client for the FireCMS Cloud backend REST API.
  * Uses the same tokens as the FireCMS CLI (from ~/.firecms/tokens.json).
+ *
+ * Architecture notes:
+ * - Collection schemas are stored in the CLIENT's Firestore at
+ *   `__FIRECMS/config/collections/{collectionId}`. We use the existing
+ *   document CRUD proxy endpoints to read/write them.
+ * - Project config (name, colors, locale) is stored in the SaaS backend's
+ *   Firestore at `projects/{projectId}`. Dedicated `/config` endpoints
+ *   handle this.
+ * - Bulk import uses the admin `batch_write` endpoint.
  */
 export declare class FireCMSApiClient {
     private client;
+    private adminCache;
+    /** Cache admin checks for 5 minutes */
+    private static ADMIN_CACHE_TTL_MS;
     constructor();
     private authHeaders;
     private request;
+    /**
+     * Verify that the current user is an admin of the given project.
+     * Results are cached for 5 minutes per project.
+     * @throws Error if the user is not an admin.
+     */
+    assertAdmin(projectId: string): Promise<void>;
+    private notAdminError;
     listProjects(): Promise<any>;
     getRootCollections(projectId: string): Promise<any>;
+    getProjectConfig(projectId: string): Promise<any>;
+    updateProjectConfig(projectId: string, data: Record<string, any>): Promise<any>;
     listUsers(projectId: string): Promise<any>;
     createUser(projectId: string, email: string, roles: string[]): Promise<any>;
     updateUser(projectId: string, userId: string, roles: string[]): Promise<any>;
     deleteUser(projectId: string, userId: string): Promise<any>;
+    /**
+     * List all persisted collection schemas.
+     * Uses the document list endpoint to read from `__FIRECMS/config/collections`.
+     */
+    listCollectionSchemas(projectId: string): Promise<any[]>;
+    /**
+     * Get a single collection schema by its document ID.
+     */
+    getCollectionSchema(projectId: string, collectionId: string): Promise<any>;
+    /**
+     * Create or fully replace a collection schema.
+     * Uses the document create/update endpoints to write to `__FIRECMS/config/collections/{id}`.
+     */
+    saveCollectionSchema(projectId: string, collectionId: string, schema: Record<string, any>): Promise<any>;
+    /**
+     * Partially update an existing collection schema (merge).
+     */
+    updateCollectionSchema(projectId: string, collectionId: string, data: Record<string, any>): Promise<any>;
+    /**
+     * Delete a collection schema.
+     */
+    deleteCollectionSchema(projectId: string, collectionId: string): Promise<any>;
+    /**
+     * Add or update a single property within a collection schema.
+     * Reads the current schema, modifies the property, and writes back.
+     */
+    saveProperty(projectId: string, collectionId: string, propertyKey: string, property: Record<string, any>, namespace?: string): Promise<any>;
+    /**
+     * Delete a property from a collection schema.
+     * Reads the current schema, removes the property, and writes back.
+     */
+    deleteProperty(projectId: string, collectionId: string, propertyKey: string, namespace?: string): Promise<any>;
     generateCollection(prompt: string, existingCollections?: any[], existingCollection?: any): Promise<any>;
     listDocuments(projectId: string, body: {
         path: string;
@@ -31,5 +84,22 @@ export declare class FireCMSApiClient {
     updateDocument(projectId: string, path: string, documentId: string, data: Record<string, any>, databaseId?: string): Promise<any>;
     deleteDocument(projectId: string, path: string, documentId: string, databaseId?: string): Promise<any>;
     countDocuments(projectId: string, path: string, databaseId?: string): Promise<any>;
+    /**
+     * Bulk import documents into a collection using the admin batch_write endpoint.
+     * This writes directly to the client's Firestore via the delegated service account.
+     */
+    importDocuments(projectId: string, body: {
+        path: string;
+        documents: Array<{
+            id?: string;
+            data: Record<string, any>;
+        }>;
+        merge?: boolean;
+        databaseId?: string;
+    }): Promise<any>;
+    /**
+     * Generate a random Firestore-style document ID.
+     */
+    private generateId;
 }
 //# sourceMappingURL=api-client.d.ts.map

package/dist/api-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,qBAAa,gBAAgB;IACzB,OAAO,CAAC,MAAM,CAAgB;;YAUhB,WAAW;YAWX,OAAO;IAWf,YAAY,IAAI,OAAO,CAAC,GAAG,CAAC;IAI5B,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IASnD,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAI1C,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC;IAQ3E,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC;IAQ5E,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAM3D,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,mBAAmB,GAAE,GAAG,EAAO,EAAE,kBAAkB,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IAU3G,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE;QACzC,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,OAAO,CAAC,EAAE,KAAK,CAAC;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,GAAG,CAAA;SAAE,CAAC,CAAC;QAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;KACvB,GAAG,OAAO,CAAC,GAAG,CAAC;IAQV,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAQnG,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAQlI,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAQjI,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAQtG,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;CAO3F"}
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"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"}

package/dist/api-client.js

@@ -1,12 +1,30 @@
 import axios from "axios";
-import { getValidTokens } from "./auth.js";
+import { getValidTokens, getCurrentUserEmail } from "./auth.js";
 const API_URL = "https://api.firecms.co";
+/**
+ * The Firestore path where collection schemas are persisted in the CLIENT's
+ * Firestore (not the SaaS backend). The backend's document CRUD endpoints
+ * proxy operations into the client's project Firestore.
+ */
+const COLLECTIONS_CONFIG_PATH = "__FIRECMS/config/collections";
 /**
  * Typed HTTP client for the FireCMS Cloud backend REST API.
  * Uses the same tokens as the FireCMS CLI (from ~/.firecms/tokens.json).
+ *
+ * Architecture notes:
+ * - Collection schemas are stored in the CLIENT's Firestore at
+ *   `__FIRECMS/config/collections/{collectionId}`. We use the existing
+ *   document CRUD proxy endpoints to read/write them.
+ * - Project config (name, colors, locale) is stored in the SaaS backend's
+ *   Firestore at `projects/{projectId}`. Dedicated `/config` endpoints
+ *   handle this.
+ * - Bulk import uses the admin `batch_write` endpoint.
  */
 export class FireCMSApiClient {
     client;
+    adminCache = new Map();
+    /** Cache admin checks for 5 minutes */
+    static ADMIN_CACHE_TTL_MS = 5 * 60 * 1000;
     constructor() {
         this.client = axios.create({
             baseURL: API_URL,
@@ -32,6 +50,34 @@ export class FireCMSApiClient {
         });
         return response.data;
     }
+    // ─── Admin guard ──────────────────────────────────────────
+    /**
+     * Verify that the current user is an admin of the given project.
+     * Results are cached for 5 minutes per project.
+     * @throws Error if the user is not an admin.
+     */
+    async assertAdmin(projectId) {
+        const cached = this.adminCache.get(projectId);
+        if (cached && (Date.now() - cached.checkedAt) < FireCMSApiClient.ADMIN_CACHE_TTL_MS) {
+            if (!cached.isAdmin) {
+                throw this.notAdminError(projectId);
+            }
+            return;
+        }
+        const users = await this.listUsers(projectId);
+        const currentEmail = getCurrentUserEmail();
+        const me = users.find((u) => u.email?.toLowerCase() === currentEmail?.toLowerCase());
+        const isAdmin = me?.roles?.includes("admin") ?? false;
+        this.adminCache.set(projectId, { isAdmin, checkedAt: Date.now() });
+        if (!isAdmin) {
+            throw this.notAdminError(projectId);
+        }
+    }
+    notAdminError(projectId) {
+        const email = getCurrentUserEmail() ?? "unknown";
+        return new Error(`Access denied: ${email} is not an admin of project "${projectId}". ` +
+            `The FireCMS MCP server requires admin access for this operation.`);
+    }
     // ─── Projects ──────────────────────────────────────────
     async listProjects() {
         return this.request({ method: "GET", url: "/projects" });
@@ -42,6 +88,20 @@ export class FireCMSApiClient {
             url: `/projects/${projectId}/firestore_root_collections`,
         });
     }
+    // ─── Project Config (SaaS backend Firestore) ──────────
+    async getProjectConfig(projectId) {
+        return this.request({
+            method: "GET",
+            url: `/projects/${projectId}/config`,
+        });
+    }
+    async updateProjectConfig(projectId, data) {
+        return this.request({
+            method: "PATCH",
+            url: `/projects/${projectId}/config`,
+            data,
+        });
+    }
     // ─── Users ─────────────────────────────────────────────
     async listUsers(projectId) {
         return this.request({ method: "GET", url: `/projects/${projectId}/users` });
@@ -63,7 +123,118 @@ export class FireCMSApiClient {
     async deleteUser(projectId, userId) {
         return this.request({ method: "DELETE", url: `/projects/${projectId}/users/${userId}` });
     }
-    // ─── Collections ───────────────────────────────────────
+    // ─── Collection Schemas (client Firestore via document proxy) ───────
+    /**
+     * List all persisted collection schemas.
+     * Uses the document list endpoint to read from `__FIRECMS/config/collections`.
+     */
+    async listCollectionSchemas(projectId) {
+        const response = await this.request({
+            method: "POST",
+            url: `/projects/${projectId}/documents/list`,
+            data: { path: COLLECTIONS_CONFIG_PATH, limit: 500 },
+        });
+        // The document list endpoint returns { data: Document[] } or { documents: Document[] }
+        return response?.data ?? response?.documents ?? [];
+    }
+    /**
+     * Get a single collection schema by its document ID.
+     */
+    async getCollectionSchema(projectId, collectionId) {
+        return this.request({
+            method: "POST",
+            url: `/projects/${projectId}/documents/get`,
+            data: { path: COLLECTIONS_CONFIG_PATH, documentId: collectionId },
+        });
+    }
+    /**
+     * Create or fully replace a collection schema.
+     * Uses the document create/update endpoints to write to `__FIRECMS/config/collections/{id}`.
+     */
+    async saveCollectionSchema(projectId, collectionId, schema) {
+        // Try update first (if doc exists), fall back to create
+        try {
+            return await this.request({
+                method: "POST",
+                url: `/projects/${projectId}/documents/update`,
+                data: {
+                    path: COLLECTIONS_CONFIG_PATH,
+                    documentId: collectionId,
+                    data: { ...schema, id: collectionId },
+                },
+            });
+        }
+        catch (error) {
+            // If the document doesn't exist, create it
+            if (error.response?.status === 404) {
+                return this.request({
+                    method: "POST",
+                    url: `/projects/${projectId}/documents/create`,
+                    data: {
+                        path: COLLECTIONS_CONFIG_PATH,
+                        documentId: collectionId,
+                        data: { ...schema, id: collectionId },
+                    },
+                });
+            }
+            throw error;
+        }
+    }
+    /**
+     * Partially update an existing collection schema (merge).
+     */
+    async updateCollectionSchema(projectId, collectionId, data) {
+        return this.request({
+            method: "POST",
+            url: `/projects/${projectId}/documents/update`,
+            data: {
+                path: COLLECTIONS_CONFIG_PATH,
+                documentId: collectionId,
+                data,
+            },
+        });
+    }
+    /**
+     * Delete a collection schema.
+     */
+    async deleteCollectionSchema(projectId, collectionId) {
+        return this.request({
+            method: "POST",
+            url: `/projects/${projectId}/documents/delete`,
+            data: {
+                path: COLLECTIONS_CONFIG_PATH,
+                documentId: collectionId,
+            },
+        });
+    }
+    /**
+     * Add or update a single property within a collection schema.
+     * Reads the current schema, modifies the property, and writes back.
+     */
+    async saveProperty(projectId, collectionId, propertyKey, property, namespace) {
+        // Get current schema
+        const current = await this.getCollectionSchema(projectId, collectionId);
+        const schemaData = current?.data ?? current ?? {};
+        // Build the properties map
+        const properties = schemaData.properties ?? {};
+        const key = namespace ? `${namespace}:${propertyKey}` : propertyKey;
+        properties[key] = property;
+        // Write back
+        return this.updateCollectionSchema(projectId, collectionId, { properties });
+    }
+    /**
+     * Delete a property from a collection schema.
+     * Reads the current schema, removes the property, and writes back.
+     */
+    async deleteProperty(projectId, collectionId, propertyKey, namespace) {
+        const current = await this.getCollectionSchema(projectId, collectionId);
+        const schemaData = current?.data ?? current ?? {};
+        const properties = schemaData.properties ?? {};
+        const key = namespace ? `${namespace}:${propertyKey}` : propertyKey;
+        delete properties[key];
+        return this.updateCollectionSchema(projectId, collectionId, { properties });
+    }
+    // ─── AI Collection Generation ──────────────────────────
     async generateCollection(prompt, existingCollections = [], existingCollection) {
         return this.request({
             method: "POST",
@@ -71,7 +242,7 @@ export class FireCMSApiClient {
             data: { prompt, existingCollections, existingCollection },
         });
     }
-    // ─── Documents (Firestore CRUD via backend) ─────────────
+    // ─── Documents (Firestore CRUD via backend proxy) ──────
     async listDocuments(projectId, body) {
         return this.request({
             method: "POST",
@@ -114,5 +285,38 @@ export class FireCMSApiClient {
             data: { path, databaseId },
         });
     }
+    // ─── Data Import (admin batch_write) ────────────────────
+    /**
+     * Bulk import documents into a collection using the admin batch_write endpoint.
+     * This writes directly to the client's Firestore via the delegated service account.
+     */
+    async importDocuments(projectId, body) {
+        // Transform documents into BatchOperation format expected by the backend
+        const operations = body.documents.map(doc => ({
+            type: (body.merge ? "update" : "set"),
+            path: body.path,
+            documentId: doc.id ?? this.generateId(),
+            data: doc.data,
+        }));
+        return this.request({
+            method: "POST",
+            url: `/projects/${projectId}/admin/documents/batch_write`,
+            data: {
+                operations,
+                databaseId: body.databaseId,
+            },
+        });
+    }
+    /**
+     * Generate a random Firestore-style document ID.
+     */
+    generateId() {
+        const chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
+        let id = "";
+        for (let i = 0; i < 20; i++) {
+            id += chars.charAt(Math.floor(Math.random() * chars.length));
+        }
+        return id;
+    }
 }
 //# sourceMappingURL=api-client.js.map

package/dist/api-client.js.map

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

package/dist/resources/project.d.ts

@@ -2,6 +2,7 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { FireCMSApiClient } from "../api-client.js";
 /**
  * Register MCP resources — read-only contextual data about FireCMS projects.
+ * Resources provide ambient context to the LLM without requiring explicit tool calls.
  */
 export declare function registerProjectResources(server: McpServer, api: FireCMSApiClient): void;
 //# sourceMappingURL=project.d.ts.map

package/dist/resources/project.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/resources/project.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAoB,MAAM,yCAAyC,CAAC;AACtF,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,gBAAgB,QA6DhF"}
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/resources/project.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAoB,MAAM,yCAAyC,CAAC;AACtF,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,gBAAgB,QAiIhF"}

package/dist/resources/project.js

@@ -1,8 +1,10 @@
 import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
 /**
  * Register MCP resources — read-only contextual data about FireCMS projects.
+ * Resources provide ambient context to the LLM without requiring explicit tool calls.
  */
 export function registerProjectResources(server, api) {
+    // ─── Root collections ──────────────────────────────────
     server.registerResource("project-collections", new ResourceTemplate("firecms://projects/{projectId}/collections", { list: undefined }), {
         description: "Firestore root-level collections for a FireCMS project",
         mimeType: "application/json",
@@ -28,6 +30,7 @@ export function registerProjectResources(server, api) {
             };
         }
     });
+    // ─── Project users ─────────────────────────────────────
     server.registerResource("project-users", new ResourceTemplate("firecms://projects/{projectId}/users", { list: undefined }), {
         description: "Users with access to a FireCMS project",
         mimeType: "application/json",
@@ -53,5 +56,57 @@ export function registerProjectResources(server, api) {
             };
         }
     });
+    // ─── Collection schemas (full schema tree) ─────────────
+    server.registerResource("project-schemas", new ResourceTemplate("firecms://projects/{projectId}/schemas", { list: undefined }), {
+        description: "All persisted collection schemas for a FireCMS project — the full configuration tree including properties, validation rules, and display settings",
+        mimeType: "application/json",
+    }, async (uri, variables) => {
+        const projectId = variables.projectId;
+        try {
+            const schemas = await api.listCollectionSchemas(projectId);
+            return {
+                contents: [{
+                        uri: uri.href,
+                        mimeType: "application/json",
+                        text: JSON.stringify(schemas, null, 2),
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                contents: [{
+                        uri: uri.href,
+                        mimeType: "application/json",
+                        text: JSON.stringify({ error: error.message }),
+                    }],
+            };
+        }
+    });
+    // ─── Project configuration ─────────────────────────────
+    server.registerResource("project-config", new ResourceTemplate("firecms://projects/{projectId}/config", { list: undefined }), {
+        description: "Project configuration — name, colors, subscription plan, feature toggles, and locale settings",
+        mimeType: "application/json",
+    }, async (uri, variables) => {
+        const projectId = variables.projectId;
+        try {
+            const config = await api.getProjectConfig(projectId);
+            return {
+                contents: [{
+                        uri: uri.href,
+                        mimeType: "application/json",
+                        text: JSON.stringify(config, null, 2),
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                contents: [{
+                        uri: uri.href,
+                        mimeType: "application/json",
+                        text: JSON.stringify({ error: error.message }),
+                    }],
+            };
+        }
+    });
 }
 //# sourceMappingURL=project.js.map

package/dist/resources/project.js.map

@@ -1 +1 @@
-{"version":3,"file":"project.js","sourceRoot":"","sources":["../../src/resources/project.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAGtF;;GAEG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAAiB,EAAE,GAAqB;IAE7E,MAAM,CAAC,gBAAgB,CACnB,qBAAqB,EACrB,IAAI,gBAAgB,CAAC,4CAA4C,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EACvF;QACI,WAAW,EAAE,wDAAwD;QACrE,QAAQ,EAAE,kBAAkB;KAC/B,EACD,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE;QACrB,MAAM,SAAS,GAAG,SAAS,CAAC,SAAmB,CAAC;QAChD,IAAI,CAAC;YACD,MAAM,WAAW,GAAG,MAAM,GAAG,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC;YAC5D,OAAO;gBACH,QAAQ,EAAE,CAAC;wBACP,GAAG,EAAE,GAAG,CAAC,IAAI;wBACb,QAAQ,EAAE,kBAAkB;wBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;qBAC7C,CAAC;aACL,CAAC;QACN,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YAClB,OAAO;gBACH,QAAQ,EAAE,CAAC;wBACP,GAAG,EAAE,GAAG,CAAC,IAAI;wBACb,QAAQ,EAAE,kBAAkB;wBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;qBACjD,CAAC;aACL,CAAC;QACN,CAAC;IACL,CAAC,CACJ,CAAC;IAEF,MAAM,CAAC,gBAAgB,CACnB,eAAe,EACf,IAAI,gBAAgB,CAAC,sCAAsC,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EACjF;QACI,WAAW,EAAE,wCAAwC;QACrD,QAAQ,EAAE,kBAAkB;KAC/B,EACD,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE;QACrB,MAAM,SAAS,GAAG,SAAS,CAAC,SAAmB,CAAC;QAChD,IAAI,CAAC;YACD,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;YAC7C,OAAO;gBACH,QAAQ,EAAE,CAAC;wBACP,GAAG,EAAE,GAAG,CAAC,IAAI;wBACb,QAAQ,EAAE,kBAAkB;wBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;qBACvC,CAAC;aACL,CAAC;QACN,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YAClB,OAAO;gBACH,QAAQ,EAAE,CAAC;wBACP,GAAG,EAAE,GAAG,CAAC,IAAI;wBACb,QAAQ,EAAE,kBAAkB;wBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;qBACjD,CAAC;aACL,CAAC;QACN,CAAC;IACL,CAAC,CACJ,CAAC;AACN,CAAC"}
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../../src/resources/project.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAGtF;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAAiB,EAAE,GAAqB;IAE7E,0DAA0D;IAE1D,MAAM,CAAC,gBAAgB,CACnB,qBAAqB,EACrB,IAAI,gBAAgB,CAAC,4CAA4C,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EACvF;QACI,WAAW,EAAE,wDAAwD;QACrE,QAAQ,EAAE,kBAAkB;KAC/B,EACD,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE;QACrB,MAAM,SAAS,GAAG,SAAS,CAAC,SAAmB,CAAC;QAChD,IAAI,CAAC;YACD,MAAM,WAAW,GAAG,MAAM,GAAG,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC;YAC5D,OAAO;gBACH,QAAQ,EAAE,CAAC;wBACP,GAAG,EAAE,GAAG,CAAC,IAAI;wBACb,QAAQ,EAAE,kBAAkB;wBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;qBAC7C,CAAC;aACL,CAAC;QACN,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YAClB,OAAO;gBACH,QAAQ,EAAE,CAAC;wBACP,GAAG,EAAE,GAAG,CAAC,IAAI;wBACb,QAAQ,EAAE,kBAAkB;wBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;qBACjD,CAAC;aACL,CAAC;QACN,CAAC;IACL,CAAC,CACJ,CAAC;IAEF,0DAA0D;IAE1D,MAAM,CAAC,gBAAgB,CACnB,eAAe,EACf,IAAI,gBAAgB,CAAC,sCAAsC,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EACjF;QACI,WAAW,EAAE,wCAAwC;QACrD,QAAQ,EAAE,kBAAkB;KAC/B,EACD,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE;QACrB,MAAM,SAAS,GAAG,SAAS,CAAC,SAAmB,CAAC;QAChD,IAAI,CAAC;YACD,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;YAC7C,OAAO;gBACH,QAAQ,EAAE,CAAC;wBACP,GAAG,EAAE,GAAG,CAAC,IAAI;wBACb,QAAQ,EAAE,kBAAkB;wBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;qBACvC,CAAC;aACL,CAAC;QACN,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YAClB,OAAO;gBACH,QAAQ,EAAE,CAAC;wBACP,GAAG,EAAE,GAAG,CAAC,IAAI;wBACb,QAAQ,EAAE,kBAAkB;wBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;qBACjD,CAAC;aACL,CAAC;QACN,CAAC;IACL,CAAC,CACJ,CAAC;IAEF,0DAA0D;IAE1D,MAAM,CAAC,gBAAgB,CACnB,iBAAiB,EACjB,IAAI,gBAAgB,CAAC,wCAAwC,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EACnF;QACI,WAAW,EAAE,mJAAmJ;QAChK,QAAQ,EAAE,kBAAkB;KAC/B,EACD,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE;QACrB,MAAM,SAAS,GAAG,SAAS,CAAC,SAAmB,CAAC;QAChD,IAAI,CAAC;YACD,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,qBAAqB,CAAC,SAAS,CAAC,CAAC;YAC3D,OAAO;gBACH,QAAQ,EAAE,CAAC;wBACP,GAAG,EAAE,GAAG,CAAC,IAAI;wBACb,QAAQ,EAAE,kBAAkB;wBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;qBACzC,CAAC;aACL,CAAC;QACN,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YAClB,OAAO;gBACH,QAAQ,EAAE,CAAC;wBACP,GAAG,EAAE,GAAG,CAAC,IAAI;wBACb,QAAQ,EAAE,kBAAkB;wBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;qBACjD,CAAC;aACL,CAAC;QACN,CAAC;IACL,CAAC,CACJ,CAAC;IAEF,0DAA0D;IAE1D,MAAM,CAAC,gBAAgB,CACnB,gBAAgB,EAChB,IAAI,gBAAgB,CAAC,uCAAuC,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAClF;QACI,WAAW,EAAE,+FAA+F;QAC5G,QAAQ,EAAE,kBAAkB;KAC/B,EACD,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE;QACrB,MAAM,SAAS,GAAG,SAAS,CAAC,SAAmB,CAAC;QAChD,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;YACrD,OAAO;gBACH,QAAQ,EAAE,CAAC;wBACP,GAAG,EAAE,GAAG,CAAC,IAAI;wBACb,QAAQ,EAAE,kBAAkB;wBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;qBACxC,CAAC;aACL,CAAC;QACN,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YAClB,OAAO;gBACH,QAAQ,EAAE,CAAC;wBACP,GAAG,EAAE,GAAG,CAAC,IAAI;wBACb,QAAQ,EAAE,kBAAkB;wBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;qBACjD,CAAC;aACL,CAAC;QACN,CAAC;IACL,CAAC,CACJ,CAAC;AACN,CAAC"}

package/dist/server.d.ts

@@ -1,6 +1,18 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.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 declare function createFireCMSMcpServer(): McpServer;
 //# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAUpE;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,SAAS,CA4BlD"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAapE;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,IAAI,SAAS,CAqClD"}