How to Use the Vercel MCP in Windsurf

Q: What kind of configuration data can I retrieve with Vercel and Windsurf?

You can get detailed project configurations using getprojectdetails. This covers everything from framework slugs to aliases. It’s all available for your agent to read.

Q: Can Windsurf help me manage Vercel domains on Vercel?

Yes, it can list high-level apex domains using listaccountdomains. This gives you a clear view of every domain managed under your account.

Q: What happens if I try to delete a project with Vercel and Windsurf?

The deleteproject tool permanently removes the service. It's irreversible, so make sure you know what you're deleting first.

Manage your Vercel deployments and infrastructure using Windsurf's autonomous agent.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Vercel MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Discovering and Checking Project Configurations

Use `list_projects` to pull a full roster of every project in the account. This gives you an overview before diving deeper into specific settings. You can then drill down with `get_project_details`. It pulls all the configuration data for a single project, letting Cascade read exactly what's needed for the next steps.

Controlling Build Pipelines

Need an update? Running `trigger_github_deployment` kicks off a new build instantly using a specific Git ref and project name. This is how you tell Vercel to redeploy. If the build goes sideways, Cascade can use `list_deployments` to see recent runs. It also lets you halt a bad run immediately by invoking `cancel_active_build`.

Managing Domains and Project Lifecycles

`list_account_domains` shows every high-level apex domain Vercel manages for your account. This is crucial context when setting up new services. For setup, Cascade can `create_project` using a name and framework slug. When you're done with an old service, `delete_project` removes it permanently.

Setup guide

Set up Vercel 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 Vercel 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 Vercel payment history." If connected, Cascade will call the Vercel tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "vercel-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 Vercel. 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 Vercel 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 Vercel MCP in Windsurf

Just ask Windsurf to list the builds for a project. It uses `list_deployments` to pull recent CI/CD history, letting you see if your last push actually went live.

You can get detailed project configurations using `get_project_details`. This covers everything from framework slugs to aliases. It’s all available for your agent to read.

Yes, it can list high-level apex domains using `list_account_domains`. This gives you a clear view of every domain managed under your account.

The `delete_project` tool permanently removes the service. It's irreversible, so make sure you know what you're deleting first.

This server touches project configuration data. This includes names, framework slugs, and domain mappings. All operations happen via your AI client's secure token.

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