fastmode-mcp 1.0.1 → 1.0.2

package/bin/run.js

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+/**
+ * Entry point that tries to run the native binary first, then falls back to Node.js.
+ * This allows the MCP server to work regardless of how Node.js is installed.
+ */
+const { spawn } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+const BINARY_NAME = 'fastmode-mcp';
+
+function getNativeBinaryPath() {
+  const ext = process.platform === 'win32' ? '.exe' : '';
+  const binaryPath = path.join(__dirname, `${BINARY_NAME}${ext}`);
+
+  if (fs.existsSync(binaryPath)) {
+    return binaryPath;
+  }
+
+  return null;
+}
+
+function runNativeBinary(binaryPath) {
+  const child = spawn(binaryPath, process.argv.slice(2), {
+    stdio: 'inherit',
+    env: process.env,
+  });
+
+  child.on('error', (error) => {
+    console.error(`Failed to run native binary: ${error.message}`);
+    runNodeFallback();
+  });
+
+  child.on('exit', (code) => {
+    process.exit(code || 0);
+  });
+}
+
+function runNodeFallback() {
+  // Fall back to the Node.js version
+  require('../dist/index.js');
+}
+
+const nativeBinary = getNativeBinaryPath();
+
+if (nativeBinary) {
+  runNativeBinary(nativeBinary);
+} else {
+  runNodeFallback();
+}

package/dist/index.js

@@ -373,7 +373,7 @@ const TOOLS = [
     },
     {
         name: 'create_cms_item',
-        description: 'FIRST: Call get_started(intent: "add_content") to see collections and field types. Creates a new CMS item. For relation fields, pass the related item ID (not name). For richText fields, use HTML content. Requires authentication.',
+        description: 'FIRST: Call get_started(intent: "add_content") to see collections, field types, AND relation field options with IDs. Creates a new CMS item. For relation fields, you MUST use item IDs (not names) - the response will warn you if relation fields were left empty and show available options. For richText fields, use HTML content. Requires authentication.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -460,7 +460,7 @@ const TOOLS = [
     },
     {
         name: 'update_cms_item',
-        description: 'FIRST: Call get_started(intent: "add_content") to see collections and field types. Updates an existing CMS item. Only provided fields are changed. Requires authentication.',
+        description: 'FIRST: Call get_started(intent: "add_content") to see collections, field types, AND relation field options with IDs. Updates an existing CMS item. Only provided fields are changed. For relation fields, use item IDs from get_relation_options or list_cms_items. Requires authentication.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -518,6 +518,28 @@ const TOOLS = [
             required: ['projectId', 'collectionSlug', 'itemSlug', 'confirmDelete'],
         },
     },
+    {
+        name: 'get_relation_options',
+        description: 'Get available options (item IDs) for relation fields in a collection. Use this to see what items can be linked via relation fields. Shows item IDs, names, and slugs for easy reference when creating or updating items.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                projectId: {
+                    type: 'string',
+                    description: 'Project ID (UUID) or project name.',
+                },
+                collectionSlug: {
+                    type: 'string',
+                    description: 'The collection that has relation fields (e.g., "posts" if posts have an author field).',
+                },
+                fieldSlug: {
+                    type: 'string',
+                    description: 'Optional: Specific relation field to get options for. If not provided, shows all relation fields.',
+                },
+            },
+            required: ['projectId', 'collectionSlug'],
+        },
+    },
 ];
 // Handle list tools request
 server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
@@ -633,6 +655,13 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
                     confirmDelete: params.confirmDelete,
                 });
                 break;
+            case 'get_relation_options':
+                result = await (0, cms_items_1.getRelationOptions)({
+                    projectId: params.projectId,
+                    collectionSlug: params.collectionSlug,
+                    fieldSlug: params.fieldSlug,
+                });
+                break;
             default:
                 return {
                     content: [{ type: 'text', text: `Unknown tool: ${name}` }],

package/dist/lib/credentials.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"credentials.d.ts","sourceRoot":"","sources":["../../src/lib/credentials.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAG3C;AAYD;;GAEG;AACH,wBAAgB,eAAe,IAAI,iBAAiB,GAAG,IAAI,CAoB1D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,iBAAiB,GAAG,IAAI,CAUpE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAUxC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,iBAAiB,EAAE,aAAa,GAAE,MAAU,GAAG,OAAO,CAIjG;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAyC1G;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAoB7E;AAED;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAG3D"}
+{"version":3,"file":"credentials.d.ts","sourceRoot":"","sources":["../../src/lib/credentials.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAG3C;AAYD;;GAEG;AACH,wBAAgB,eAAe,IAAI,iBAAiB,GAAG,IAAI,CAoB1D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,iBAAiB,GAAG,IAAI,CAUpE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAUxC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,iBAAiB,EAAE,aAAa,GAAE,MAAU,GAAG,OAAO,CAIjG;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAkD1G;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAoB7E;AAED;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAG3D"}

package/dist/lib/device-flow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"device-flow.d.ts","sourceRoot":"","sources":["../../src/lib/device-flow.ts"],"names":[],"mappings":"AA0DA;;;GAGG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,CAqGvD;AA0ED;;;GAGG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC;IAAE,aAAa,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CA2BhG"}
+{"version":3,"file":"device-flow.d.ts","sourceRoot":"","sources":["../../src/lib/device-flow.ts"],"names":[],"mappings":"AA0DA;;;GAGG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,CAqGvD;AA8ED;;;GAGG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC;IAAE,aAAa,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CA2BhG"}

package/dist/tools/cms-items.d.ts

@@ -53,4 +53,13 @@ export declare function deleteCmsItem(params: {
     itemSlug: string;
     confirmDelete: boolean;
 }): Promise<string>;
+/**
+ * Get relation field options for a collection
+ * Shows all relation fields and their available values
+ */
+export declare function getRelationOptions(params: {
+    projectId: string;
+    collectionSlug: string;
+    fieldSlug?: string;
+}): Promise<string>;
 //# sourceMappingURL=cms-items.d.ts.map

package/dist/tools/cms-items.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cms-items.d.ts","sourceRoot":"","sources":["../../src/tools/cms-items.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAqFH;;GAEG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,OAAO,CAAC,MAAM,CAAC,CAuDlB;AAkBD;;GAEG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CACxB,GAAG,OAAO,CAAC,MAAM,CAAC,CA6ClB;AA4CD;;GAEG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,MAAM,CAAC,CA6ClB;AAoBD;;GAEG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B,GAAG,OAAO,CAAC,MAAM,CAAC,CA6ElB;AAkBD;;;GAGG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,OAAO,CAAC;CACxB,GAAG,OAAO,CAAC,MAAM,CAAC,CAwElB"}
+{"version":3,"file":"cms-items.d.ts","sourceRoot":"","sources":["../../src/tools/cms-items.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA4NH;;GAEG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,OAAO,CAAC,MAAM,CAAC,CA2DlB;AA+DD;;GAEG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CACxB,GAAG,OAAO,CAAC,MAAM,CAAC,CA6ClB;AA4CD;;GAEG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,MAAM,CAAC,CA6ClB;AAoBD;;GAEG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B,GAAG,OAAO,CAAC,MAAM,CAAC,CA6ElB;AAkBD;;;GAGG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,OAAO,CAAC;CACxB,GAAG,OAAO,CAAC,MAAM,CAAC,CAwElB;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,MAAM,CAAC,CA0FlB"}

package/dist/tools/cms-items.js

@@ -10,8 +10,15 @@ exports.listCmsItems = listCmsItems;
 exports.getCmsItem = getCmsItem;
 exports.updateCmsItem = updateCmsItem;
 exports.deleteCmsItem = deleteCmsItem;
+exports.getRelationOptions = getRelationOptions;
 const api_client_1 = require("../lib/api-client");
 const device_flow_1 = require("../lib/device-flow");
+/**
+ * Type guard to check if prepare result failed
+ */
+function prepFailed(prep) {
+    return !prep.success;
+}
 /**
  * Helper to ensure authentication and resolve project ID
  */
@@ -48,12 +55,77 @@ async function getCollectionId(tenantId, collectionSlug) {
     }
     return { collectionId: collection.id };
 }
+/**
+ * Get collection with full field details
+ */
+async function getCollectionWithFields(tenantId, collectionSlug) {
+    const response = await (0, api_client_1.apiRequest)('/api/collections', { tenantId });
+    if ((0, api_client_1.isApiError)(response)) {
+        return { error: `Failed to fetch collections: ${response.error}` };
+    }
+    const collection = response.data.find(c => c.slug === collectionSlug);
+    if (!collection) {
+        return { error: `Collection "${collectionSlug}" not found.` };
+    }
+    // The collections endpoint returns fields, cast to proper type
+    return { collection: collection };
+}
+/**
+ * Get items from a collection (for relation options)
+ */
+async function getCollectionItems(tenantId, collectionSlug, limit = 10) {
+    // First get collection ID
+    const collResult = await getCollectionId(tenantId, collectionSlug);
+    if ('error' in collResult) {
+        return [];
+    }
+    const response = await (0, api_client_1.apiRequest)(`/api/collections/${collResult.collectionId}/items?limit=${limit}`, { tenantId, method: 'GET' });
+    if ((0, api_client_1.isApiError)(response)) {
+        return [];
+    }
+    return response.data.map(item => ({
+        id: item.id,
+        name: item.name,
+        slug: item.slug,
+    }));
+}
+/**
+ * Check for empty relation fields and get their options
+ */
+async function checkEmptyRelations(tenantId, collectionSlug, itemData) {
+    const collResult = await getCollectionWithFields(tenantId, collectionSlug);
+    if ('error' in collResult) {
+        return [];
+    }
+    const { collection } = collResult;
+    const emptyRelations = [];
+    // Check each relation field
+    for (const field of collection.fields || []) {
+        if (field.type === 'relation' && field.referenceCollection) {
+            const value = itemData[field.slug];
+            // Check if the field is empty (null, undefined, or empty string)
+            if (value === null || value === undefined || value === '') {
+                // Get options from the referenced collection
+                const options = await getCollectionItems(tenantId, field.referenceCollection, 10);
+                if (options.length > 0) {
+                    emptyRelations.push({
+                        fieldSlug: field.slug,
+                        fieldName: field.name,
+                        referenceCollection: field.referenceCollection,
+                        options,
+                    });
+                }
+            }
+        }
+    }
+    return emptyRelations;
+}
 /**
  * Create a new item in a CMS collection
  */
 async function createCmsItem(params) {
     const prep = await prepareRequest(params.projectId);
-    if (!prep.success)
+    if (prepFailed(prep))
         return prep.message;
     // Get collection ID from slug
     const collectionResult = await getCollectionId(prep.tenantId, params.collectionSlug);
@@ -89,14 +161,18 @@ async function createCmsItem(params) {
             if ((0, api_client_1.isApiError)(retry)) {
                 return `# Error Creating Item\n\n${retry.error}\n\n**Status:** ${retry.statusCode}`;
             }
-            return formatCreatedItem(retry.data, params.collectionSlug);
+            // Check for empty relation fields
+            const emptyRelations = await checkEmptyRelations(prep.tenantId, params.collectionSlug, retry.data.data);
+            return formatCreatedItem(retry.data, params.collectionSlug, params.projectId, emptyRelations);
         }
         return `# Error Creating Item\n\n${response.error}\n\n**Status:** ${response.statusCode}`;
     }
-    return formatCreatedItem(response.data, params.collectionSlug);
+    // Check for empty relation fields
+    const emptyRelations = await checkEmptyRelations(prep.tenantId, params.collectionSlug, response.data.data);
+    return formatCreatedItem(response.data, params.collectionSlug, params.projectId, emptyRelations);
 }
-function formatCreatedItem(item, collectionSlug) {
-    return `# Item Created Successfully
+function formatCreatedItem(item, collectionSlug, projectId, emptyRelations) {
+    let output = `# Item Created Successfully
 
 **Collection:** ${collectionSlug}
 **Name:** ${item.name}
@@ -109,13 +185,49 @@ function formatCreatedItem(item, collectionSlug) {
 ${JSON.stringify(item.data, null, 2)}
 \`\`\`
 `;
+    // Add warning about empty relation fields
+    if (emptyRelations && emptyRelations.length > 0) {
+        output += `
+---
+
+## ⚠️ Empty Relation Fields
+
+The following relation fields were not set. You may want to update them:
+
+`;
+        for (const rel of emptyRelations) {
+            output += `### ${rel.fieldName} (\`${rel.fieldSlug}\`)
+References: **${rel.referenceCollection}**
+
+Available options:
+`;
+            for (const opt of rel.options.slice(0, 5)) {
+                output += `- \`"${opt.id}"\` → ${opt.name}${opt.slug ? ` (${opt.slug})` : ''}\n`;
+            }
+            if (rel.options.length > 5) {
+                output += `- ... and ${rel.options.length - 5} more\n`;
+            }
+            output += '\n';
+        }
+        output += `**To update**, use:
+\`\`\`
+update_cms_item(
+  projectId: "${projectId || '...'}",
+  collectionSlug: "${collectionSlug}",
+  itemSlug: "${item.slug || '...'}",
+  data: { ${emptyRelations.map(r => `${r.fieldSlug}: "${r.options[0]?.id || 'ITEM_ID'}"`).join(', ')} }
+)
+\`\`\`
+`;
+    }
+    return output;
 }
 /**
  * List items in a CMS collection
  */
 async function listCmsItems(params) {
     const prep = await prepareRequest(params.projectId);
-    if (!prep.success)
+    if (prepFailed(prep))
         return prep.message;
     // Get collection ID from slug
     const collectionResult = await getCollectionId(prep.tenantId, params.collectionSlug);
@@ -189,7 +301,7 @@ Found ${items.length} item${items.length !== 1 ? 's' : ''}:
  */
 async function getCmsItem(params) {
     const prep = await prepareRequest(params.projectId);
-    if (!prep.success)
+    if (prepFailed(prep))
         return prep.message;
     // Get collection ID from slug
     const collectionResult = await getCollectionId(prep.tenantId, params.collectionSlug);
@@ -243,7 +355,7 @@ ${JSON.stringify(item.data, null, 2)}
  */
 async function updateCmsItem(params) {
     const prep = await prepareRequest(params.projectId);
-    if (!prep.success)
+    if (prepFailed(prep))
         return prep.message;
     // Get collection ID from slug
     const collectionResult = await getCollectionId(prep.tenantId, params.collectionSlug);
@@ -336,7 +448,7 @@ To delete the item "${params.itemSlug}" from collection "${params.collectionSlug
 `;
     }
     const prep = await prepareRequest(params.projectId);
-    if (!prep.success)
+    if (prepFailed(prep))
         return prep.message;
     // Get collection ID from slug
     const collectionResult = await getCollectionId(prep.tenantId, params.collectionSlug);
@@ -374,3 +486,86 @@ Successfully deleted item "${params.itemSlug}" from collection "${params.collect
 Successfully deleted item "${params.itemSlug}" from collection "${params.collectionSlug}".
 `;
 }
+/**
+ * Get relation field options for a collection
+ * Shows all relation fields and their available values
+ */
+async function getRelationOptions(params) {
+    const prep = await prepareRequest(params.projectId);
+    if (prepFailed(prep))
+        return prep.message;
+    // Get collection with fields
+    const collResult = await getCollectionWithFields(prep.tenantId, params.collectionSlug);
+    if ('error' in collResult) {
+        return `# Error\n\n${collResult.error}`;
+    }
+    const { collection } = collResult;
+    // Find relation fields
+    const relationFields = (collection.fields || []).filter(f => f.type === 'relation' && f.referenceCollection);
+    if (relationFields.length === 0) {
+        return `# No Relation Fields
+
+Collection **${params.collectionSlug}** has no relation fields.
+
+Relation fields link items to other collections. To create one, use:
+\`\`\`
+sync_schema(
+  projectId: "${params.projectId}",
+  fieldsToAdd: [{
+    collectionSlug: "${params.collectionSlug}",
+    fields: [{ slug: "category", name: "Category", type: "relation", referenceCollection: "categories" }]
+  }]
+)
+\`\`\`
+`;
+    }
+    // If a specific field is requested, filter to just that one
+    const fieldsToShow = params.fieldSlug
+        ? relationFields.filter(f => f.slug === params.fieldSlug)
+        : relationFields;
+    if (params.fieldSlug && fieldsToShow.length === 0) {
+        const availableFields = relationFields.map(f => f.slug).join(', ');
+        return `# Field Not Found
+
+Field "${params.fieldSlug}" is not a relation field in collection "${params.collectionSlug}".
+
+Available relation fields: ${availableFields || 'none'}
+`;
+    }
+    let output = `# Relation Field Options for ${collection.name}
+
+`;
+    for (const field of fieldsToShow) {
+        const options = await getCollectionItems(prep.tenantId, field.referenceCollection, 20);
+        output += `## ${field.name} (\`${field.slug}\`)
+**References:** ${field.referenceCollection}
+
+`;
+        if (options.length === 0) {
+            output += `*No items in ${field.referenceCollection} yet.*
+
+To create items, use:
+\`\`\`
+create_cms_item(projectId: "${params.projectId}", collectionSlug: "${field.referenceCollection}", name: "Item Name", data: {...})
+\`\`\`
+
+`;
+        }
+        else {
+            output += `| ID | Name | Slug |
+|----|------|------|
+`;
+            for (const opt of options) {
+                output += `| \`${opt.id}\` | ${opt.name} | ${opt.slug || '-'} |\n`;
+            }
+            output += `
+**Usage:** When creating/updating items in \`${params.collectionSlug}\`, use the ID:
+\`\`\`
+data: { ${field.slug}: "${options[0].id}" }
+\`\`\`
+
+`;
+        }
+    }
+    return output;
+}

package/dist/tools/get-started.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-started.d.ts","sourceRoot":"","sources":["../../src/tools/get-started.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,MAAM,MAAM,MAAM,GAAG,SAAS,GAAG,aAAa,GAAG,eAAe,GAAG,SAAS,GAAG,QAAQ,CAAC;AAExF,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAmjBD;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CA4FxE"}
+{"version":3,"file":"get-started.d.ts","sourceRoot":"","sources":["../../src/tools/get-started.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA8CH,MAAM,MAAM,MAAM,GAAG,SAAS,GAAG,aAAa,GAAG,eAAe,GAAG,SAAS,GAAG,QAAQ,CAAC;AAExF,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAgnBD;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CA4FxE"}

package/dist/tools/get-started.js

@@ -12,6 +12,27 @@ exports.getStarted = getStarted;
 const context_fetcher_1 = require("../lib/context-fetcher");
 const device_flow_1 = require("../lib/device-flow");
 const api_client_1 = require("../lib/api-client");
+/**
+ * Fetch items from a collection for relation field options
+ */
+async function fetchRelationOptions(tenantId, collectionSlug, limit = 5) {
+    // First get collection ID
+    const collectionsResponse = await (0, api_client_1.apiRequest)('/api/collections', { tenantId });
+    if ((0, api_client_1.isApiError)(collectionsResponse))
+        return [];
+    const collection = collectionsResponse.data.find(c => c.slug === collectionSlug);
+    if (!collection)
+        return [];
+    // Then get items
+    const itemsResponse = await (0, api_client_1.apiRequest)(`/api/collections/${collection.id}/items?limit=${limit}`, { tenantId, method: 'GET' });
+    if ((0, api_client_1.isApiError)(itemsResponse))
+        return [];
+    return itemsResponse.data.map(item => ({
+        id: item.id,
+        name: item.name,
+        slug: item.slug,
+    }));
+}
 // ============ Response Builders ============
 /**
  * Build the explore response - overview of all projects
@@ -95,7 +116,7 @@ get_started(intent: "convert")
 /**
  * Build the add_content response with schema details
  */
-function buildAddContentResponse(project) {
+async function buildAddContentResponse(project) {
     let output = `# Fast Mode MCP - Add Content
 
 ## Project: ${project.name}
@@ -116,8 +137,61 @@ get_started(intent: "update_schema", projectId: "${project.id}")
     output += `## Collections
 
 `;
+    // Collect all relation fields across collections
+    const allRelationFields = [];
     for (const collection of project.collections) {
         output += buildCollectionTable(collection);
+        // Track relation fields
+        for (const field of collection.fields) {
+            if (field.type === 'relation' && field.referenceCollection) {
+                allRelationFields.push({ collection: collection.slug, field });
+            }
+        }
+    }
+    // If there are relation fields, show their options
+    if (allRelationFields.length > 0) {
+        output += `---
+
+## 📋 Relation Field Options
+
+**Important:** Relation fields require item IDs, not names. Here are the available options:
+
+`;
+        // Group by referenced collection to avoid duplicate fetches
+        const byRefCollection = new Map();
+        for (const rf of allRelationFields) {
+            const key = rf.field.referenceCollection;
+            if (!byRefCollection.has(key)) {
+                byRefCollection.set(key, []);
+            }
+            byRefCollection.get(key).push(rf);
+        }
+        // Fetch options for each referenced collection
+        for (const [refCollection, fields] of byRefCollection) {
+            const options = await fetchRelationOptions(project.id, refCollection, 5);
+            const fieldNames = fields.map(f => `\`${f.field.slug}\` in ${f.collection}`).join(', ');
+            output += `### ${refCollection}
+Used by: ${fieldNames}
+
+`;
+            if (options.length === 0) {
+                output += `*No items yet.* Create some first:
+\`\`\`
+create_cms_item(projectId: "${project.id}", collectionSlug: "${refCollection}", name: "Item Name", data: {...})
+\`\`\`
+
+`;
+            }
+            else {
+                for (const opt of options) {
+                    output += `- \`"${opt.id}"\` → **${opt.name}**${opt.slug ? ` (${opt.slug})` : ''}\n`;
+                }
+                if (options.length === 5) {
+                    output += `- *... more available via* \`list_cms_items(projectId: "${project.id}", collectionSlug: "${refCollection}")\`\n`;
+                }
+                output += '\n';
+            }
+        }
     }
     output += `---
 
@@ -169,12 +243,14 @@ data: { author: "John Smith" }
 // CORRECT:
 data: { author: "abc-123-uuid-of-john" }
 \`\`\`
-
+${allRelationFields.length > 0 ? `
+**See "Relation Field Options" above for available IDs.**
+` : `
 To get the ID, first list items in the related collection:
 \`\`\`
 list_cms_items(projectId: "${project.id}", collectionSlug: "authors")
 \`\`\`
-
+`}
 ### Delete requires confirmation
 Always ask the user before deleting:
 \`\`\`
@@ -572,7 +648,7 @@ Could not find project: "${projectId}"
 
 Use \`list_projects\` to see available projects.`;
             }
-            return buildAddContentResponse(context.selectedProject);
+            return await buildAddContentResponse(context.selectedProject);
         case 'update_schema':
             if (!context.selectedProject) {
                 if (!projectId) {
@@ -617,7 +693,7 @@ Use \`list_projects\` to see available projects.`;
         default:
             // If projectId provided, show detailed project info
             if (context.selectedProject) {
-                return buildAddContentResponse(context.selectedProject);
+                return await buildAddContentResponse(context.selectedProject);
             }
             return buildExploreResponse(context);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fastmode-mcp",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "MCP server for FastMode CMS. Convert websites, validate packages, and deploy directly to FastMode. Includes authentication, project creation, schema sync, and one-click deployment.",
   "main": "dist/index.js",
   "bin": {
@@ -10,7 +10,8 @@
   "scripts": {
     "build": "NODE_OPTIONS='--max-old-space-size=4096' tsc --skipLibCheck && chmod +x dist/index.js",
     "dev": "ts-node src/index.ts",
-    "start": "node dist/index.js"
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build"
   },
   "keywords": [
     "mcp",
@@ -47,7 +48,7 @@
   "devDependencies": {
     "@types/adm-zip": "^0.5.7",
     "@types/node": "^20.11.0",
-    "ts-node": "^10.9.2",
-    "typescript": "^5.3.3"
+    "typescript": "^5.3.3",
+    "ts-node": "^10.9.2"
   }
 }

package/scripts/postinstall.js

@@ -0,0 +1,129 @@
+#!/usr/bin/env node
+/**
+ * Postinstall script that downloads the correct prebuilt binary for the current platform.
+ * This allows the MCP server to run without Node.js in the PATH.
+ */
+const https = require('https');
+const fs = require('fs');
+const path = require('path');
+
+const PACKAGE_NAME = 'fastmode-mcp';
+const BINARY_NAME = 'fastmode-mcp';
+
+// Get package version from package.json
+const packageJson = require('../package.json');
+const VERSION = packageJson.version;
+
+// Platform/arch mapping
+const PLATFORM_MAP = {
+  'darwin-arm64': 'macos-arm64',
+  'darwin-x64': 'macos-x64',
+  'linux-arm64': 'linux-arm64',
+  'linux-x64': 'linux-x64',
+  'win32-x64': 'win-x64',
+  'win32-arm64': 'win-arm64',
+};
+
+function getPlatformKey() {
+  const platform = process.platform;
+  const arch = process.arch;
+  return `${platform}-${arch}`;
+}
+
+function getBinaryUrl(version, platformKey) {
+  const platformSuffix = PLATFORM_MAP[platformKey];
+  if (!platformSuffix) {
+    return null;
+  }
+
+  const ext = process.platform === 'win32' ? '.exe' : '';
+  const filename = `${BINARY_NAME}-${platformSuffix}${ext}`;
+
+  // Download from GitHub Releases (public repo for binaries)
+  return `https://github.com/arihgoldstein/fastmode-mcp/releases/download/v${version}/${filename}`;
+}
+
+function downloadFile(url, destPath) {
+  return new Promise((resolve, reject) => {
+    const file = fs.createWriteStream(destPath);
+
+    const request = (url) => {
+      https.get(url, (response) => {
+        // Handle redirects
+        if (response.statusCode === 301 || response.statusCode === 302) {
+          request(response.headers.location);
+          return;
+        }
+
+        if (response.statusCode === 404) {
+          file.close();
+          fs.unlinkSync(destPath);
+          reject(new Error(`Binary not found at ${url}`));
+          return;
+        }
+
+        if (response.statusCode !== 200) {
+          file.close();
+          fs.unlinkSync(destPath);
+          reject(new Error(`Failed to download: ${response.statusCode}`));
+          return;
+        }
+
+        response.pipe(file);
+        file.on('finish', () => {
+          file.close();
+          resolve();
+        });
+      }).on('error', (err) => {
+        file.close();
+        fs.unlinkSync(destPath);
+        reject(err);
+      });
+    };
+
+    request(url);
+  });
+}
+
+async function main() {
+  const platformKey = getPlatformKey();
+  const binaryUrl = getBinaryUrl(VERSION, platformKey);
+
+  if (!binaryUrl) {
+    console.log(`No prebuilt binary available for ${platformKey}`);
+    console.log('Falling back to Node.js execution');
+    return;
+  }
+
+  const binDir = path.join(__dirname, '..', 'bin');
+  const ext = process.platform === 'win32' ? '.exe' : '';
+  const binaryPath = path.join(binDir, `${BINARY_NAME}${ext}`);
+
+  // Create bin directory if it doesn't exist
+  if (!fs.existsSync(binDir)) {
+    fs.mkdirSync(binDir, { recursive: true });
+  }
+
+  console.log(`Downloading ${PACKAGE_NAME} binary for ${platformKey}...`);
+
+  try {
+    await downloadFile(binaryUrl, binaryPath);
+
+    // Make executable on Unix
+    if (process.platform !== 'win32') {
+      fs.chmodSync(binaryPath, 0o755);
+    }
+
+    console.log(`Successfully installed ${BINARY_NAME} binary`);
+  } catch (error) {
+    // Binary download failed - this is OK, we'll fall back to Node.js
+    console.log(`Binary download failed: ${error.message}`);
+    console.log('Falling back to Node.js execution');
+  }
+}
+
+main().catch((error) => {
+  // Don't fail the install if binary download fails
+  console.error('Postinstall warning:', error.message);
+  process.exit(0);
+});

package/dist/tools/get-schema.d.ts

@@ -1,5 +0,0 @@
-/**
- * Returns the complete CMS schema reference for custom collections
- */
-export declare function getSchema(): Promise<string>;
-//# sourceMappingURL=get-schema.d.ts.map

package/dist/tools/get-schema.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"get-schema.d.ts","sourceRoot":"","sources":["../../src/tools/get-schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAyTjD"}

package/dist/tools/get-schema.js

@@ -1,320 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getSchema = getSchema;
-/**
- * Returns the complete CMS schema reference for custom collections
- */
-async function getSchema() {
-    return `# CMS Schema Reference
-
-## Collections Overview
-
-All CMS content is managed through **custom collections**. Collections are content types you define (e.g., Blog Posts, Team Members, Services, Products) with custom fields.
-
-**To see the exact collections and fields for a specific project, use the \`get_tenant_schema\` tool.**
-
----
-
-## Collection Templates
-
-When creating a new collection, you can start from a **template** that pre-configures common field sets:
-
-- **Blog Posts** - Articles with images, summary, body, author reference
-- **Authors** - Content creators with bio, photo, social links
-- **Team Members** - Staff profiles with role, photo, bio
-- **Downloads** - Downloadable files with description and category
-- **FAQs** - Question and answer pairs
-- **Products** - Items with price, description, images
-
-Templates are just starting points - you can customize fields after creation.
-
----
-
-## Token Syntax
-
-### Basic Tokens
-\`\`\`html
-{{fieldSlug}}      <!-- For text, number, boolean, image, url, date, select -->
-{{{fieldSlug}}}    <!-- For richText fields (MUST use triple braces) -->
-\`\`\`
-
-### Built-in Tokens (Available on ALL items)
-- \`{{name}}\` - Item name/title (REQUIRED - every item has a name)
-- \`{{slug}}\` - Item URL slug (if collection has detail pages)
-- \`{{url}}\` - Full item URL (e.g., /services/my-service)
-
-### Date Tokens (Automatically tracked)
-- \`{{createdAt}}\` - When the item was first created
-- \`{{publishedAt}}\` - When the item was published (empty for drafts)
-- \`{{updatedAt}}\` - When the item was last updated
-
----
-
-## Loop Syntax
-
-### Basic Loop
-\`\`\`html
-{{#each collectionSlug}}
-  <article>
-    <h2>{{name}}</h2>
-  </article>
-{{/each}}
-\`\`\`
-
-### Loop Modifiers
-- \`limit=N\` - Limit to N items
-- \`featured=true\` - Only featured items (if collection has a boolean "featured" field)
-- \`sort="fieldName"\` - Sort by field
-- \`order="asc|desc"\` - Sort direction
-
-\`\`\`html
-{{#each posts limit=6 sort="publishedAt" order="desc"}}
-  <article>{{name}}</article>
-{{/each}}
-\`\`\`
-
-### Loop Variables
-Inside \`{{#each}}\` blocks:
-- \`{{@first}}\` - true for first item
-- \`{{@last}}\` - true for last item
-- \`{{@index}}\` - zero-based index
-
-\`\`\`html
-{{#each services limit=3}}
-  <div class="{{#if @first}}featured{{/if}}">
-    {{name}}
-  </div>
-{{/each}}
-\`\`\`
-
----
-
-## Conditionals
-
-### Check if field has value
-\`\`\`html
-{{#if image}}
-  <img src="{{image}}" alt="{{name}}">
-{{else}}
-  <div class="placeholder"></div>
-{{/if}}
-
-{{#unless featured}}
-  <span>Regular item</span>
-{{/unless}}
-\`\`\`
-
-### Collection Empty Checks
-\`\`\`html
-{{#each posts}}
-  <article>{{name}}</article>
-{{/each}}
-
-{{#unless posts}}
-  <p>No posts yet. Check back soon!</p>
-{{/unless}}
-\`\`\`
-
----
-
-## Equality Comparisons
-
-Compare field values using the \`(eq field1 field2)\` helper:
-
-\`\`\`html
-<!-- Show content when fields ARE equal -->
-{{#if (eq category.slug ../slug)}}
-  <span>Current category</span>
-{{/if}}
-
-<!-- Show content when fields are NOT equal (exclude current) -->
-{{#unless (eq slug ../slug)}}
-  <a href="{{url}}">{{name}}</a>
-{{/unless}}
-\`\`\`
-
-### Related Items Pattern (Exclude Current)
-\`\`\`html
-<h3>Other Posts</h3>
-{{#each posts limit=3}}
-  {{#unless (eq slug ../slug)}}
-    <article>
-      <a href="{{url}}">{{name}}</a>
-    </article>
-  {{/unless}}
-{{/each}}
-\`\`\`
-
----
-
-## Parent Context References
-
-Inside loops, access the parent scope using \`../\`:
-
-\`\`\`html
-<!-- On author detail page, show only posts by THIS author -->
-{{#each posts}}
-  {{#if (eq author.name ../name)}}
-    <h3>{{name}}</h3>
-  {{/if}}
-{{/each}}
-\`\`\`
-
-- \`../name\` - Parent item's name field
-- \`../slug\` - Parent item's slug
-- \`../fieldName\` - Any field from the parent scope
-
----
-
-## Relation Fields
-
-Link items from one collection to another. Access related item data using dot notation:
-
-\`\`\`html
-{{#each projects}}
-<article>
-  <h2>{{name}}</h2>
-  {{#if category}}
-    <span class="tag">{{category.name}}</span>
-    <a href="{{category.url}}">View all {{category.name}}</a>
-  {{/if}}
-</article>
-{{/each}}
-\`\`\`
-
-**Available tokens for related items:**
-- \`{{relationField.name}}\` - Related item's name
-- \`{{relationField.slug}}\` - Related item's slug
-- \`{{relationField.url}}\` - Related item's full URL
-- \`{{relationField.anyField}}\` - Any field from the related collection
-
----
-
-## Rich Text (Triple Braces)
-
-For HTML content that should NOT be escaped:
-\`\`\`html
-{{{description}}}   ✓ Correct - renders HTML
-{{description}}     ✗ Wrong - escapes HTML as text
-\`\`\`
-
----
-
-## Important Rules
-
-1. **Triple braces for richText fields** - \`{{{body}}}\`, \`{{{bio}}}\`
-2. **Double braces for everything else** - \`{{name}}\`, \`{{image}}\`
-3. **Always wrap optional fields in {{#if}}** - Check before rendering
-4. **Use {{url}} for links** - Generates correct path based on manifest
-5. **Match field slugs exactly** - Case-sensitive
-
----
-
-## Image Handling
-
-### Static UI Images (logos, icons)
-\`\`\`html
-<img src="/public/images/logo.png" alt="Logo">
-\`\`\`
-
-### CMS Content Images
-\`\`\`html
-{{#if heroImage}}
-  <img src="{{heroImage}}" alt="{{name}}">
-{{/if}}
-\`\`\`
-
----
-
-## CMS Template Configuration
-
-Configure templates in manifest.json:
-
-\`\`\`json
-{
-  "cmsTemplates": {
-    "postsIndex": "pages/blog.html",
-    "postsIndexPath": "/blog",
-    "postsDetail": "templates/blog-post.html",
-    "postsDetailPath": "/blog",
-    
-    "servicesIndex": "pages/services.html",
-    "servicesIndexPath": "/services",
-    "servicesDetail": "templates/service-detail.html",
-    "servicesDetailPath": "/services"
-  }
-}
-\`\`\`
-
-### Template Keys Pattern
-- **{collectionSlug}Index** - Template file for listing page
-- **{collectionSlug}IndexPath** - URL path for listing page
-- **{collectionSlug}Detail** - Template file for detail page
-- **{collectionSlug}DetailPath** - URL base for detail pages
-
----
-
-## Form Handling
-
-Forms are automatically captured and stored in the CMS.
-
-\`\`\`html
-<form data-form-name="contact">
-  <input type="text" name="firstName" required>
-  <input type="email" name="email" required>
-  <textarea name="message"></textarea>
-  <button type="submit">Send</button>
-</form>
-\`\`\`
-
-### Form Handler Script
-\`\`\`javascript
-document.querySelectorAll('form[data-form-name]').forEach(form => {
-  form.addEventListener('submit', async (e) => {
-    e.preventDefault();
-    const formName = form.dataset.formName || 'general';
-    const formData = new FormData(form);
-    const data = Object.fromEntries(formData);
-    
-    const response = await fetch('/_forms/' + formName, {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify(data)
-    });
-    
-    if (response.ok) {
-      form.reset();
-      alert(form.dataset.successMessage || 'Thank you!');
-    }
-  });
-});
-\`\`\`
-
-**CRITICAL:** Endpoint is \`/_forms/{formName}\` - NOT \`/api/forms/submit\`
-
----
-
-## SEO Template Tokens
-
-For CMS detail pages, use tokens in SEO templates:
-- \`{{name}}\` - Item name for title
-- \`{{description}}\` or summary field - For meta description
-- \`{{image}}\` field - For OG image
-
-SEO templates are configured in the Fast Mode Editor.
-
----
-
-## Next Steps
-
-**To see exact collections and fields for a specific project, use:**
-\`\`\`
-get_tenant_schema(projectId: "your-project-name-or-id")
-\`\`\`
-
-This will show you:
-- All collections with their slugs
-- All fields with their tokens, types, and descriptions
-- Relation field targets
-`;
-}