webflow-agent-kit

AI agent tools for Webflow
_{TypeScript-first · Zod-validated · Multi-framework · Public Beta}

---

What is webflow-agent-kit?

Exposes Webflow's Data API as 62 typed, Zod-validated AI agent tools. Use them with Vercel AI SDK, LangChain, or the MCP server to control Webflow sites from any AI client.

npm install @webflow-agent-kit/core@beta @webflow-agent-kit/vercel-ai@beta

Connect Your AI Client

Add this config to any MCP-compatible client and get instant access to all 62 Webflow tools:

{
  "mcpServers": {
    "webflow-agent-kit": {
      "command": "npx",
      "args": ["-y", "@webflow-agent-kit/mcp@beta"],
      "env": { "WEBFLOW_TOKEN": "<YOUR_WEBFLOW_SITE_TOKEN>" }
    }
  }
}

Verified Clients

Client	Status	Setup Guide
Claude Code	✅ Verified	Setup
Codex CLI	✅ Verified	Setup
Gemini CLI	✅ Verified	Setup
Cursor	🔶 Beta — test required	Setup
Claude Desktop	🔶 Beta — test required	Setup
Windsurf	🔶 Beta — test required	Setup
Kiro CLI	🔶 Experimental	Setup
Generic stdio MCP	✅ Beta	Setup

Features

• 62 tools across 15 API groups — Sites, Pages, CMS, Ecommerce, Assets, Forms, Webhooks, SEO, Redirects, Custom Code, Components, Audit Logs, Collections + Fields
• Zod validation on every tool input
• Rate limiting — built-in token bucket with exponential backoff
• Bulk auto-batching — splits >100 CMS items into API-safe chunks
• 3 auth modes — site tokens, OAuth, environment variables
• MCP server — connects to Claude Code, Codex, Cursor, Claude Desktop, and any stdio MCP client
• Skill packs — documented recipes for SEO audit, content migration, publish workflow, ecommerce sync

Packages

All packages are published as 0.1.0-beta.1. Install with the @beta tag:

Package	Description	npm
@webflow-agent-kit/core	62 tools, auth, rate limiting, mutation policy
@webflow-agent-kit/vercel-ai	Vercel AI SDK adapter
@webflow-agent-kit/mcp	MCP server (62 tools via stdio)
@webflow-agent-kit/skills	Manifest-backed safe workflow packs
@webflow-agent-kit/langchain	LangChain adapter (beta)
@webflow-agent-kit/cli	CLI runner (wfak)
@webflow-agent-kit/google-adk	Google ADK adapter (experimental)

Support Status

Package	Status	Notes
@webflow-agent-kit/core	Beta (most mature)	62 tools, 71 tests, verified against live Webflow API
@webflow-agent-kit/vercel-ai	Beta	Vercel AI SDK adapter with group filtering
@webflow-agent-kit/mcp	Beta	MCP server — 62 tools via stdio. Parameter schemas simplified (P0 fix pending). Protocol smoke test passes.
@webflow-agent-kit/skills	Beta	SkillExecutor with dry-run defaults, confirmation gating
@webflow-agent-kit/langchain	Beta	Shape-compatible; no integration tests
@webflow-agent-kit/cli	Beta	auth and sites commands functional; run is a prototype
@webflow-agent-kit/google-adk	Experimental	Shape-compatible adapter; no Google ADK SDK dependency validated
webflow-agent-kit-python (in-repo)	Experimental / Pre-alpha	All adapters return NotImplementedError. Not published.

Tool Safety

Most tools are read-only. Mutation tools (create, update, delete, publish, fulfill) write real data to your Webflow account. These actions cannot be automatically reversed.

• Default policy: read_only for agent-facing APIs
• Write operations require explicit { mode: 'allow_writes' } opt-in
• Approval gates: tools can be gated behind approvalHandler callbacks
• Audit hooks: every mutation decision fires an audit event

Always test with a staging site or a non-production collection before using mutation tools in automation. See Safety and Mutations.

Quick Start

npm install @webflow-agent-kit/core@beta @webflow-agent-kit/vercel-ai@beta

export WEBFLOW_TOKEN=your_token_here

import { createWebflowAgentKit } from '@webflow-agent-kit/core';
import { toVercelAITools } from '@webflow-agent-kit/vercel-ai';
import { generateText } from 'ai';
import { anthropic } from '@ai-sdk/anthropic';

const kit = createWebflowAgentKit({ type: 'env' });
const tools = toVercelAITools(kit);

const { text } = await generateText({
  model: anthropic('claude-sonnet-4-5'),
  tools,
  maxSteps: 10,
  prompt: 'List all my Webflow sites and their published status.',
});

Tool Groups

Group	Tools
Sites	4	list, get, publish, custom domains
Pages	4	list, get/update metadata, update static content
CMS Items	7	full CRUD + publish + live listing (auto-batched)
Collections + Fields	5	list/get collections, CRUD for fields
Assets	5	list, create (S3 upload), get, delete, folders
Forms	5	list, get, list/get/update submissions
Ecommerce	12	Products (4), Orders (5), Inventory (3)
Custom Code	3	get, upsert header/footer scripts, delete
Redirects	3	list, create, delete (Enterprise only)
SEO	4	robots.txt get/update, well-known files (Enterprise only)
Webhooks	4	list, create, get, delete
Components	5	list, get/update content, get/update properties
Audit Logs	1	list workspace audit logs

Skill Packs

Documented multi-step recipes included in the repo — see skill-packs/:

Skill	Tool Groups	Mutation Risk
SEO Audit	pages, seo, sites	Low (metadata updates)
Content Migration	cms, collections	High (creates items)
Publish Workflow	cms	Medium (publishes staged items)
Ecommerce Sync	inventory, products, orders	High (modifies inventory)

Warning: Skill packs with High mutation risk create, update, or delete real data. Test on a staging site first. Skills default to dry_run mode — explicit confirmation is required for mutations.

Links

• npm: @webflow-agent-kit
• GitHub: anilandcode/webflow-agent-kit
• Docs: docs/ — Getting Started, Auth, Tool Reference, Client Setup Guides, Safety, Rate Limiting

MIT © Anil Pervaiz — Flowmarc Creative