# Webflow MCP Server

Model Context Protocol (MCP) server for Webflow CMS and website builder platform.

## Features

Complete coverage of Webflow API for AI agents to manage sites, CMS content, pages, assets, and integrations.

### Tools Implemented (25 total)

#### Sites Management (3 tools)
- ✅ `list_sites` - List all Webflow sites
- ✅ `get_site` - Get site details and configuration
- ✅ `publish_site` - Publish site to domains

#### Collections (2 tools)
- ✅ `list_collections` - List CMS collections in a site
- ✅ `get_collection` - Get collection schema and field definitions

#### Collection Items / CMS Content (6 tools)
- ✅ `list_collection_items` - List items in a collection with pagination
- ✅ `get_collection_item` - Get single CMS item
- ✅ `create_collection_item` - Create new CMS item (blog post, product, etc.)
- ✅ `update_collection_item` - Update CMS item field data
- ✅ `delete_collection_item` - Delete CMS item
- ✅ `publish_collection_item` - Publish draft item

#### Pages (3 tools)
- ✅ `list_pages` - List all pages in site
- ✅ `get_page` - Get page details and metadata
- ✅ `update_page` - Update page title, slug, SEO, and Open Graph

#### Domains (1 tool)
- ✅ `list_domains` - List site domains and SSL status

#### Assets (3 tools)
- ✅ `list_assets` - List uploaded media files
- ✅ `get_asset` - Get asset details and URLs
- ✅ `delete_asset` - Delete uploaded asset

#### Webhooks (4 tools)
- ✅ `list_webhooks` - List site webhooks
- ✅ `get_webhook` - Get webhook configuration
- ✅ `create_webhook` - Create webhook for events
- ✅ `delete_webhook` - Delete webhook

#### Forms (3 tools)
- ✅ `list_forms` - List forms on site
- ✅ `get_form` - Get form details
- ✅ `list_form_submissions` - Retrieve form submissions

## Installation

```bash
npm install
npm run build
```

## Configuration

Set your Webflow API token as an environment variable:

```bash
export WEBFLOW_API_TOKEN="your_token_here"
```

Get your API token from [Webflow Account Settings](https://webflow.com/dashboard/account/integrations).

## Usage

### As MCP Server

Add to your MCP client configuration:

```json
{
  "mcpServers": {
    "webflow": {
      "command": "node",
      "args": ["/path/to/webflow/dist/index.js"],
      "env": {
        "WEBFLOW_API_TOKEN": "your_token_here"
      }
    }
  }
}
```

### Standalone

```bash
node dist/index.js
```

## API Coverage

Covers major Webflow API endpoints:
- Sites API - Site management and publishing
- Collections API - CMS schema and structure
- Collection Items API - CMS content CRUD operations
- Pages API - Page metadata and SEO
- Domains API - Custom domain configuration
- Assets API - Media file management
- Webhooks API - Event notifications
- Forms API - Form submissions retrieval

## Examples

### Create Blog Post

```typescript
{
  "name": "create_collection_item",
  "arguments": {
    "collection_id": "abc123",
    "field_data": {
      "name": "My First Blog Post",
      "slug": "my-first-blog-post",
      "post-body": "<p>This is the content...</p>",
      "author": "John Doe",
      "featured-image": "image_id_here"
    },
    "draft": false
  }
}
```

### Update Page SEO

```typescript
{
  "name": "update_page",
  "arguments": {
    "page_id": "page123",
    "seo_title": "Best Products - Company Name",
    "seo_description": "Discover our amazing products...",
    "og_title": "Check Out Our Products!",
    "og_description": "You'll love what we have to offer"
  }
}
```

### Setup Webhook for Form Submissions

```typescript
{
  "name": "create_webhook",
  "arguments": {
    "site_id": "site123",
    "trigger_type": "form_submission",
    "url": "https://your-app.com/webhooks/webflow"
  }
}
```

## Development

```bash
# Build
npm run build

# Watch mode
npm run dev
```

## License

MIT