How to Use the Vercel MCP in Windsurf

Q: How do I check my current Vercel deployments using Windsurf?

Windsurf runs listverceldeployments to pull a list of your recent builds. This shows the status and URLs for all active releases, letting you see what's currently live.

Q: Can Windsurf help me with Vercel account domains?

Yes. The agent uses listvercelaccountdomains to list every domain attached to your main Vercel account, making it easy to verify which custom names are active.

Deploy and manage your full stack with Windsurf, built for autonomous workflow chains.

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

Manage deployments across multiple Vercel projects

You can tell Cascade to deploy a new version without worrying about the steps. It handles everything from listing available apps with `list_vercel_projects` to initiating a full build using `create_vercel_deployment`. You just set the goal, and Windsurf figures out the deployment sequence. Need to roll back or check status? Cascade grabs the details for any specific release via `get_vercel_deployment_info`, or you can even clean up old builds with `delete_vercel_deployment`.

Check and configure project environment variables

The tool lets your agent see exactly what environment variables are set for any given app. Use `list_vercel_project_env_vars` to get a manifest of current keys, or add new ones with `add_vercel_environment_variable`. It's crucial when setting up services that rely on specific API endpoints. If you need to see everything under your account, the agent can list all associated domains using `list_vercel_account_domains`.

Discover and manage Vercel team structures

Windsurf knows how complex large organizations are. It lets you list every single accessible team with `list_vercel_teams`, so your agent can figure out which deployment scope to use. You can also get general details about the whole account using `get_vercel_project_details`. Want to know who's logged in? The agent runs `get_vercel_user_profile` right away, giving you an immediate view of the connected credentials.

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-extended-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

Windsurf runs `list_vercel_deployments` to pull a list of your recent builds. This shows the status and URLs for all active releases, letting you see what's currently live.

You can read and write Environment Variables at the project level using `list_vercel_project_env_vars` and `add_vercel_environment_variable`. This keeps your backend keys secure and configured correctly.

Yes. The agent uses `list_vercel_account_domains` to list every domain attached to your main Vercel account, making it easy to verify which custom names are active.

It supports managing resources across different projects and teams within a single connected scope. You can list all accessible teams via `list_vercel_teams` to see your organizational boundaries.

It primarily touches account metadata, including project details, user profiles, and environment variables. The specific data type managed is the Project Environment Variables.

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