How to Use the Webflow MCP in Mastra AI

Q: Can Mastra AI update Webflow CMS items?

Yes, the tool includes updatecollectionitem. You can build workflows that detect when content changes and then automatically push those updates to the live site.

Q: How do I list all Webflow pages with Mastra AI?

Use the dedicated listpages tool. Because this runs in a robust workflow, it ensures that even if there are many pages, they are gathered reliably and sequentially for your process.

Build Fail-Safe Webflow Workflows with Mastra AI.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Webflow MCP to Mastra AI

Create your Vinkius account to connect Webflow to Mastra AI and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Webflow with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Robust Publishing and Site Management

When a workflow requires the site to be live, you use `publish_site`. This tool handles the deployment step reliably. If an attempt fails, your Mastra AI agent can automatically retry or notify an admin for manual intervention. This is crucial when managing multiple sites across different domains. Use `list_domains` first so your workflow knows exactly which property to push live.

Transactional CMS Data Operations

Don't let a bad data write break your process. Your agent can use `create_collection_item` or `update_collection_item`. These actions are treated as transactional steps in the workflow, supporting automatic retries with exponential backoff if the API hiccups. The system handles failure gracefully, which is necessary when modifying complex content structures via `list_collections`.

Complex Webflow Site Auditing

Build a full audit workflow using this MCP Server. The agent can sequentially call `get_site`, then `list_pages`, and finally `get_user`. If any step fails, the entire process doesn't crash; it branches to an error handling routine. This level of conditional branching makes automating Webflow management simple and dependable.

Setup guide

Set up Webflow MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All Webflow tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "webflow-mcp-client",
  servers: {
    "webflow-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "Webflow Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to Webflow tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent Webflow transactions"
);
console.log(result.text);

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Webflow. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Webflow now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Webflow MCP in Mastra AI

You connect the MCP Server to your workflow engine. The agent can run multi-step processes, like first calling `list_sites` and then using `publish_site` on a specific domain.

Yes, the tool includes `update_collection_item`. You can build workflows that detect when content changes and then automatically push those updates to the live site.

It touches web properties information, specifically handling `site details`, `user info` (via `get_user`), and collection content via `collection items`. All access is managed within the workflow engine.

Use the dedicated `list_pages` tool. Because this runs in a robust workflow, it ensures that even if there are many pages, they are gathered reliably and sequentially for your process.

Yep. Since the framework handles failures and retries, you get reliable access to tools like `list_collections` and `get_site`. It makes automating Webflow management highly dependable.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript