How to Use the Copy.ai MCP in Windsurf

Q: Can Windsurf Cascade run a Copy.ai workflow autonomously?

Yes, Cascade chains the execution steps. It uses runworkflow to start the process and loops getrunstatus until the Copy.ai output is ready, then writes the result to your file.

Q: Does Windsurf support the Copy.ai MCP Server brand voice profiles?

It does. Cascade calls listbrandassets to pull your Copy.ai brand voice profiles and info base items, ensuring any generated content matches your brand style.

Q: How do I check the schema of a specific Copy.ai workflow in this editor?

Cascade uses getworkflowdetails to inspect the exact input fields and data types required. It then builds the payload and runs the workflow without errors.

Cascade runs your Copy.ai marketing and sales workflows directly inside Windsurf without you touching a browser.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Copy.ai MCP to Windsurf

Create your Vinkius account to connect Copy.ai to Windsurf 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 Copy.ai with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Run Copy.ai Workflows via this MCP Server in Windsurf

The `run_workflow` and `get_run_status` tools let Cascade kick off background content runs and monitor their progress while you code. You tell Cascade to draft release notes, and it fires up the Copy.ai engine, checks the status, and drops the finished text right into your workspace. Cascade doesn't stop to ask for permission at each step. It grabs your input parameters, validates them against the workflow schema, and executes the job in the background.

Map brand assets inside your Windsurf workspace

The `list_brand_assets` tool exposes your saved brand voice guidelines and info base items to Cascade. This means Cascade can write code or documentation that matches your company's tone without you copy-pasting guidelines from a web app. It reads your specific Copy.ai assets and applies them to your local project files. You get perfectly on-brand docs generated right in your editor.

Browse and search workflows using this MCP Server

The `list_workflows` and `search_workflows_by_name` tools allow Cascade to scan your entire Copy.ai library to find the exact automation you need. Instead of hunting through browser tabs, you ask Cascade to find your translation or SEO workflows. Once Cascade finds the matching ID, it pulls the structure so you can run it instantly. It makes your external automations feel like local scripts.

Setup guide

Set up Copy.ai MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Copy.ai MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Copy.ai payment history." If connected, Cascade will call the Copy.ai tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "copyai-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

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 Copy.ai. 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 Copy.ai 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 Copy.ai MCP in Windsurf

Open Windsurf settings and head to Cascade MCP Servers, or edit your `~/.codeium/windsurf/mcp_config.json` file. Add the server under the mcpServers key, and Cascade instantly discovers the tools.

Yes, Cascade chains the execution steps. It uses `run_workflow` to start the process and loops `get_run_status` until the Copy.ai output is ready, then writes the result to your file.

It does. Cascade calls `list_brand_assets` to pull your Copy.ai brand voice profiles and info base items, ensuring any generated content matches your brand style.

Cascade uses `get_workflow_details` to inspect the exact input fields and data types required. It then builds the payload and runs the workflow without errors.

Your Copy.ai API keys and workflow input data are processed in an isolated Vinkius sandbox. No workspace folders or brand voice assets are stored or shared with external parties.

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