multisite-cms-mcp 1.1.0 → 1.1.1

package/README.md

@@ -0,0 +1,183 @@
+# Fast Mode MCP Server
+
+An MCP (Model Context Protocol) server that enables AI assistants to convert, validate, and deploy websites to [Fast Mode](https://fastmode.ai).
+
+## What is Fast Mode?
+
+Fast Mode is a modern CMS platform that turns static HTML websites into fully editable, content-managed sites. Unlike traditional CMSs that force you into their templates, Fast Mode works with **your existing design** — just add simple template tokens and your site becomes editable.
+
+### Key Features
+
+- **Keep Your Design** — Use any HTML/CSS. No themes, no page builders, no compromises.
+- **Built-in Collections** — Blog posts, team members, authors, downloads — all ready to use.
+- **Custom Collections** — Create any content type you need with custom fields.
+- **Visual Editor** — Edit content directly on your live site.
+- **Instant Deploy** — Push from GitHub or upload directly. Sites go live in seconds.
+- **Forms & Submissions** — Collect form data without any backend code.
+- **Custom Domains** — Use your own domain with automatic SSL.
+
+### Links
+
+- **Website:** [fastmode.ai](https://fastmode.ai)
+- **Dashboard:** [app.fastmode.ai](https://app.fastmode.ai)
+- **Documentation:** [docs.fastmode.ai](https://docs.fastmode.ai)
+
+---
+
+## MCP Server Tools
+
+This MCP server provides tools for AI assistants (Claude, Cursor, etc.) to help you convert websites to Fast Mode format and deploy them.
+
+### Validation Tools (No Auth Required)
+
+These tools work without authentication — perfect for converting and validating websites before deploying:
+
+| Tool | Description |
+|------|-------------|
+| `get_schema` | Get the complete CMS schema with all collections and fields |
+| `validate_manifest` | Validate your manifest.json file |
+| `validate_template` | Check HTML templates for correct token usage |
+| `validate_package` | Validate complete package structure |
+| `get_example` | Get example code for common patterns |
+| `get_conversion_guide` | Step-by-step website conversion guide |
+
+### Authenticated Tools
+
+These tools require a Fast Mode account. The MCP server will automatically open your browser for login when needed:
+
+| Tool | Description |
+|------|-------------|
+| `list_projects` | List all your Fast Mode projects |
+| `get_tenant_schema` | Get schema for a specific project (including custom fields) |
+| `create_site` | Create a new Fast Mode project |
+| `deploy_package` | Deploy a website package to Fast Mode |
+
+---
+
+## Installation
+
+### For Cursor
+
+Add to your Cursor MCP settings (`~/.cursor/mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "fastmode": {
+      "command": "npx",
+      "args": ["-y", "multisite-cms-mcp"]
+    }
+  }
+}
+```
+
+### For Claude Desktop
+
+Add to your Claude config:
+
+```json
+{
+  "mcpServers": {
+    "fastmode": {
+      "command": "npx",
+      "args": ["-y", "multisite-cms-mcp"]
+    }
+  }
+}
+```
+
+---
+
+## Quick Start
+
+### 1. Convert a Website
+
+Ask your AI assistant:
+
+> "Convert this website to Fast Mode format. Use the get_schema tool to understand the CMS structure."
+
+The AI will use validation tools to create a proper package structure.
+
+### 2. Deploy to Fast Mode
+
+Once your package is ready:
+
+> "Deploy this to Fast Mode"
+
+The AI will:
+1. Open your browser for login (if needed)
+2. Show your existing projects or create a new one
+3. Upload and deploy your site
+
+### 3. Your Site is Live!
+
+Your site will be available at `https://your-site.fastmode.ai` and you can manage content at [app.fastmode.ai](https://app.fastmode.ai).
+
+---
+
+## Example Usage
+
+```
+# Convert a website (no auth needed)
+"Use get_conversion_guide to help me convert my website to Fast Mode"
+
+# Validate a package
+"Validate my manifest.json using validate_manifest"
+
+# Deploy to existing project
+"Deploy ./my-site.zip to my Fast Mode project"
+
+# Create new project and deploy
+"Create a new Fast Mode site called 'My Portfolio' and deploy ./portfolio.zip to it"
+```
+
+---
+
+## Authentication
+
+The MCP server uses browser-based authentication (OAuth device flow). When you run a tool that requires auth:
+
+1. Your browser opens automatically
+2. Log in or create a Fast Mode account
+3. The MCP server receives your credentials
+4. Credentials are stored locally at `~/.fastmode/credentials.json`
+
+You can also set the `FASTMODE_AUTH_TOKEN` environment variable if you prefer.
+
+---
+
+## Package Structure
+
+Fast Mode websites follow this structure:
+
+```
+my-site/
+├── manifest.json      # Site configuration
+├── pages/             # HTML pages
+│   ├── index.html
+│   ├── about.html
+│   └── contact.html
+├── public/            # Static assets
+│   ├── css/
+│   ├── js/
+│   └── images/
+└── templates/         # CMS templates (optional)
+    ├── blog_index.html
+    ├── blog_post.html
+    └── team.html
+```
+
+Use the `get_conversion_guide` tool for detailed instructions.
+
+---
+
+## Support
+
+- **Issues:** [GitHub Issues](https://github.com/arihgoldstein/multisite-cms/issues)
+- **Email:** support@fastmode.ai
+
+---
+
+## License
+
+MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "multisite-cms-mcp",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "MCP server for Fast Mode CMS. Convert websites, validate packages, and deploy directly to Fast Mode. Includes authentication, project creation, and one-click deployment.",
   "main": "dist/index.js",
   "bin": {