MCP Server Reference

MCP Server Tools Reference

This is the technical reference for all tools available in the Fast Mode MCP Server. For setup instructions, see MCP Server Setup. For usage examples, see Using the MCP Server.

Project Management Tools

list_projects

List all Fast Mode projects you have access to.

Triggers authentication if needed.

Returns: Project names, IDs, subdomains, and your role in each.

get_tenant_schema

Get the complete schema for a specific project including all collections and fields.

Parameters:

• projectId (required) - Project ID or name

Returns: All collections, fields, field types, and token syntax.

get_started

Intelligent entry point that checks auth and returns the workflow for your task.

Parameters:

• intent - One of: explore, add_content, update_schema, convert, deploy
• projectId (optional) - Project to get details for

Content Management Tools

list_cms_items

List items in a collection.

Parameters:

• projectId (required) - Project ID or name
• collectionSlug (required) - Collection slug (e.g., "blog", "team")
• limit (optional) - Max items to return
• sort (optional) - Field to sort by
• order (optional) - asc or desc

get_cms_item

Get a single item by slug.

Parameters:

• projectId (required)
• collectionSlug (required)
• itemSlug (required)

create_cms_item

Create a new item in a collection.

Parameters:

• projectId (required)
• collectionSlug (required)
• name (required) - Item title
• slug (optional) - Auto-generated if not provided
• data (required) - Object with field values
• publishedAt (optional) - ISO date or null for draft

update_cms_item

Update an existing item.

Parameters:

• projectId (required)
• collectionSlug (required)
• itemSlug (required)
• name (optional)
• data (optional) - Only provided fields are updated
• publishedAt (optional)

delete_cms_item

Delete an item. Requires explicit confirmation.

Parameters:

• projectId (required)
• collectionSlug (required)
• itemSlug (required)
• confirmDelete (required) - Must be true

Schema Management Tools

sync_schema

Create collections and fields in a project.

Parameters:

• projectId (required)
• collections (optional) - Array of new collections to create
• fieldsToAdd (optional) - Array of fields to add to existing collections

get_field_types

List available field types for creating fields.

Returns: All field types with descriptions (text, richText, image, relation, etc.)

generate_sample_items

Create sample content for collections.

Parameters:

• projectId (required)
• collectionSlugs (optional) - Specific collections, or all empty collections

Deployment Tools

create_site

Create a new Fast Mode project.

Parameters:

• name (required) - Project name
• subdomain (optional) - Auto-generated from name if not provided

deploy_package

Deploy a website package ZIP to a project.

Parameters:

• projectId (required)
• packagePath (required) - Path to the .zip file
• force (optional) - Skip GitHub check

Validation Tools

validate_manifest

Check a manifest.json for errors.

Parameters:

• manifest (required) - The manifest.json content as string

validate_template

Check an HTML template for correct token usage.

Parameters:

• html (required) - Template content
• templateType (required) - custom_index, custom_detail, or static_page
• collectionSlug (optional) - For collection templates
• projectId (optional) - Validate against actual schema

validate_package

Validate complete website package structure.

Parameters:

• fileList (required) - Array of file paths
• manifestContent (required) - manifest.json content
• templateContentsJson (optional) - Map of template paths to contents

Documentation Tools

get_example

Get code examples for specific patterns.

Parameters:

• exampleType (required) - One of: manifest_basic, blog_index_template, blog_post_template, form_handling, each_loop, conditional_if, and more

get_conversion_guide

Get the website conversion guide.

Parameters:

• section (optional) - full, analysis, structure, manifest, templates, etc.

Environment Variables

Variable	Required	Default	Description
FASTMODE_API_URL	No	https://api.fastmode.ai	API base URL
FASTMODE_AUTH_TOKEN	No	-	Manual auth token (device flow preferred)

Credential Storage

Credentials are stored at: ~/.fastmode/credentials.json

Access tokens auto-refresh (90-day refresh tokens).

Related Docs

• MCP Server Setup — Installation and authentication
• Using the MCP Server — Prompting examples and workflows
• MCP Troubleshooting — Common issues and solutions