fastmode-mcp 1.0.0

package/dist/tools/get-field-types.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Get Available Field Types Tool
+ *
+ * Returns the list of field types that can be used when CREATING new fields
+ * in collections. This is NOT the list of fields in your schema - use
+ * get_tenant_schema for that.
+ *
+ * No authentication required.
+ */
+/**
+ * Field type definition
+ */
+export interface FieldType {
+    value: string;
+    label: string;
+    description: string;
+    requiresOptions?: boolean;
+    requiresReferenceCollection?: boolean;
+}
+/**
+ * Available field types for creating custom fields
+ * This matches the API's supported field types
+ */
+export declare const AVAILABLE_FIELD_TYPES: FieldType[];
+/**
+ * Returns the list of available field types for creating fields.
+ * No authentication required.
+ */
+export declare function getFieldTypes(): Promise<string>;
+//# sourceMappingURL=get-field-types.d.ts.map

package/dist/tools/get-field-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-field-types.d.ts","sourceRoot":"","sources":["../../src/tools/get-field-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,2BAA2B,CAAC,EAAE,OAAO,CAAC;CACvC;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,SAAS,EA+E5C,CAAC;AAEF;;;GAGG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,CAqDrD"}

package/dist/tools/get-field-types.js

@@ -0,0 +1,154 @@
+"use strict";
+/**
+ * Get Available Field Types Tool
+ *
+ * Returns the list of field types that can be used when CREATING new fields
+ * in collections. This is NOT the list of fields in your schema - use
+ * get_tenant_schema for that.
+ *
+ * No authentication required.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AVAILABLE_FIELD_TYPES = void 0;
+exports.getFieldTypes = getFieldTypes;
+/**
+ * Available field types for creating custom fields
+ * This matches the API's supported field types
+ */
+exports.AVAILABLE_FIELD_TYPES = [
+    {
+        value: 'text',
+        label: 'Text',
+        description: 'Single line text field. Use for titles, names, short descriptions.'
+    },
+    {
+        value: 'textarea',
+        label: 'Textarea',
+        description: 'Multi-line plain text. No formatting or paragraphs, just more space for longer text entries like summaries or excerpts.'
+    },
+    {
+        value: 'richText',
+        label: 'Rich Text',
+        description: 'Multi-line formatted text (HTML). Use for body content, descriptions with formatting. Use {{{fieldName}}} in templates (triple braces for unescaped HTML).'
+    },
+    {
+        value: 'number',
+        label: 'Number',
+        description: 'Numeric value. Use for prices, quantities, order numbers.'
+    },
+    {
+        value: 'boolean',
+        label: 'Boolean',
+        description: 'True/False toggle. Use for featured flags, visibility toggles.'
+    },
+    {
+        value: 'date',
+        label: 'Date',
+        description: 'Date picker (date only). Use for publication dates, event dates.'
+    },
+    {
+        value: 'datetime',
+        label: 'Date & Time',
+        description: 'Date and time picker. Use when you need both date and time.'
+    },
+    {
+        value: 'image',
+        label: 'Image',
+        description: 'Image file or URL. Supports direct file uploads to storage. Use for photos, thumbnails, hero images.'
+    },
+    {
+        value: 'file',
+        label: 'File',
+        description: 'Downloadable file (PDF, DOC, DOCX, XLS, XLSX, PPT, PPTX, ZIP, MP3, MP4, etc.). Max 10MB. Use in templates as a download link: <a href="{{field}}" download>Download</a>'
+    },
+    {
+        value: 'url',
+        label: 'URL',
+        description: 'Web link. Use for external links, social media URLs.'
+    },
+    {
+        value: 'videoEmbed',
+        label: 'Video Embed',
+        description: 'YouTube, Vimeo, Wistia, or Loom URL. Use {{#videoEmbed fieldName}}{{/videoEmbed}} helper in templates for responsive iframes.'
+    },
+    {
+        value: 'email',
+        label: 'Email',
+        description: 'Email address field with validation.'
+    },
+    {
+        value: 'select',
+        label: 'Select',
+        description: 'Dropdown with predefined options. Requires "options" parameter: comma-separated string like "Option1, Option2, Option3".',
+        requiresOptions: true,
+    },
+    {
+        value: 'multiSelect',
+        label: 'Multi-Select',
+        description: 'Multiple selections from options. Requires "options" parameter: comma-separated string like "Tag1, Tag2, Tag3".',
+        requiresOptions: true,
+    },
+    {
+        value: 'relation',
+        label: 'Relation',
+        description: 'Link to another collection item. Requires "referenceCollection" parameter with the collection slug. Only for custom collections.',
+        requiresReferenceCollection: true,
+    },
+];
+/**
+ * Returns the list of available field types for creating fields.
+ * No authentication required.
+ */
+async function getFieldTypes() {
+    const typeList = exports.AVAILABLE_FIELD_TYPES.map(ft => {
+        let entry = `- **${ft.value}** (${ft.label}): ${ft.description}`;
+        if (ft.requiresOptions) {
+            entry += '\n  - ⚠️ Requires `options` parameter (comma-separated values)';
+        }
+        if (ft.requiresReferenceCollection) {
+            entry += '\n  - ⚠️ Requires `referenceCollection` parameter (collection slug)';
+        }
+        return entry;
+    }).join('\n');
+    return `# Available Field Types
+
+These are the field types you can use when CREATING new fields with the \`sync_schema\` tool.
+
+**Note:** This is NOT the list of fields in your schema. Use \`get_tenant_schema\` to see a specific project's schema.
+
+## Field Types
+
+${typeList}
+
+## Usage Example
+
+When calling \`sync_schema\` to add fields, specify the \`type\` parameter:
+
+\`\`\`json
+{
+  "fieldsToAdd": [
+    {
+      "collectionSlug": "posts",
+      "fields": [
+        { "slug": "heroImage", "name": "Hero Image", "type": "image" },
+        { "slug": "featured", "name": "Featured", "type": "boolean" },
+        { "slug": "category", "name": "Category", "type": "select", "options": "Tech, Business, Lifestyle" },
+        { "slug": "tags", "name": "Tags", "type": "multiSelect", "options": "Featured, Popular, New, Sale" },
+        { "slug": "author", "name": "Author", "type": "relation", "referenceCollection": "authors" }
+      ]
+    }
+  ]
+}
+\`\`\`
+
+## Select/MultiSelect Options Format
+
+For **select** and **multiSelect** fields, provide options as a comma-separated string:
+
+✅ CORRECT: \`"options": "Red, Green, Blue"\`
+✅ CORRECT: \`"options": "Option1,Option2,Option3"\`
+
+❌ WRONG: \`"options": ["Red", "Green", "Blue"]\`  (Don't use JSON array)
+❌ WRONG: \`"options": "\\"Red,Green,Blue\\""\`  (Don't wrap in extra quotes)
+`;
+}

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

@@ -0,0 +1,5 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,320 @@
+"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
+`;
+}

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

@@ -0,0 +1,21 @@
+/**
+ * Get Started Tool
+ *
+ * Intelligent entry point for the MCP server that performs:
+ * 1. State Detection - Understand project state automatically
+ * 2. Intent Inference - Determine what user wants to do
+ * 3. Guided Execution - Provide exact tool calls with real values
+ */
+export type Intent = 'explore' | 'add_content' | 'update_schema' | 'convert' | 'deploy';
+export interface GetStartedInput {
+    intent?: Intent;
+    projectId?: string;
+}
+/**
+ * Get Started - Intelligent entry point for the MCP server
+ *
+ * @param input.intent - What the user wants to do (explore, add_content, update_schema, convert, deploy)
+ * @param input.projectId - Specific project to get details for
+ */
+export declare function getStarted(input: GetStartedInput): Promise<string>;
+//# sourceMappingURL=get-started.d.ts.map

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

@@ -0,0 +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"}