# Vercel MCP for AI Agents AI Agent Connect > Vercel MCP brings your deployment infrastructure into your chat. Control project domains, trigger manual builds, and inspect deployment status natively without leaving your IDE. It connects your CI/CD pipeline to your AI client for faster hotfixes and environment management. ## Overview - **Category:** loved-by-devs - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_yXQJctv8H7iwNP2uZu0xA7lbrvgZaSLOafQd6VWy/ai-agent-connect - **Tags:** serverless, deployment, git-integration, infrastructure-as-code, web-hosting, ci-cd ## Description This Connector brings your Vercel infrastructure directly into your chat interface. Instead of jumping between browser tabs to check if a build finished or to manually trigger a deployment, you can just ask your agent to do it. It handles the heavy lifting of interacting with your CI/CD pipeline so you can stay focused on your code. If you're tired of hunting for preview URLs or manually auditing DNS records across dozens of projects, this connection gives you a conversational way to manage your entire deployment lifecycle. You'll find it easy to add to your stack via the Vinkius catalog, making it a core part of your developer toolkit for managing serverless environments and production deployments. Imagine you're in the middle of a late night hotfix. Normally, you'd have to switch to the Vercel dashboard, find the right project, and manually initiate a build from a specific tag. With this connection, you just tell your agent to do it. It handles the request and gives you the status back in the same window. You can also check the health of your custom domains, see which aliases are mapped to your subdomains, and keep an eye on your project portfolio without ever leaving your IDE. It turns a series of manual, click-heavy tasks into a simple conversation, letting you move faster from code to production. ## Tools ### delete_project Permanently removes a Vercel project. Be careful as this action is irreversible. ### get_deployment_details Retrieves details for a specific deployment execution. Use this to see exact success or failure logs. ### get_project_details Retrieves detailed configuration for a specific project. This helps you check environment variables and settings. ### list_project_aliases Lists specific subdomain routing mappings for a project. This is perfect for auditing DNS and alias health. ### list_deployments Lists recent CI/CD builds for a specific project. Use this to quickly find the most recent production URL. ### cancel_active_build Aborts an ongoing Vercel compilation pipeline. Use this to clear your queue when a build hangs. ### trigger_github_deployment Triggers a new Vercel build from a specific GitHub reference. This lets you skip the push and start a build manually. ### create_project Creates a new Vercel project with a name and framework slug. Use this to spin up new environments dynamically. ### list_account_domains Lists high-level apex domains managed by Vercel. This helps you audit your entire domain portfolio at once. ### list_projects Lists all Vercel projects in the account. Get a full overview of your infrastructure in one command. ## Prompt Examples **Prompt:** ``` List all root domains connected to my Vercel infrastructure. ``` **Response:** ``` I've queried your account and found 3 active root domains: * **production-agent.com** (SSL Valid) * **internal-tools.io** (SSL Valid) * **legacy-blog-marketing.net** (SSL Valid) All three are currently healthy and properly bound to your environment. ``` **Prompt:** ``` Create a manual deploy on the 'billing-service' project pulling directly from the 'main' branch on GitHub repo '341xyz'. ``` **Response:** ``` I've triggered a manual build for **billing-service** using the **main** branch from repository **341xyz**. Vercel has acknowledged the request. The new processing ID is `dpl_H3vM4Q...`. I can check the status for you in a few minutes if you'd like. ``` **Prompt:** ``` Check the status of deployment 'dpl_827a' and give me its exact live preview URL if ready. ``` **Response:** ``` I've checked deployment `dpl_827a` for you. **Status:** ✅ READY **Errors:** 0 You can view the live preview here: [https://billing-service-pr-12-test.vercel.app](https://billing-service-pr-12-test.vercel.app) ``` ## Capabilities ### Trigger manual builds Start a new deployment from a specific GitHub branch or tag using a simple chat command. ### Stop ongoing builds Cancel a compilation that is taking too long or blocking your deployment queue. ### Audit custom domains View your root domains and DNS routing mappings across your entire account. ### Track deployment status Get real-time updates on build progress and fetch live preview URLs instantly. ### Manage project portfolio List all active projects and their configurations in one conversational view. ## Use Cases ### Quick hotfix deployment A developer needs to push a critical fix. Instead of pushing to GitHub, they ask the agent to trigger a build from the current branch using trigger_github_deployment. ### DNS and SSL audit A DevOps lead needs to check all active domains. They ask the agent to list all root domains and subdomain mappings for the entire account. ### Stalled build recovery A build is stuck in the queue. The user asks the agent to stop the active compilation so they can restart the deployment flow. ### QA preview gathering After a team member finishes a feature, the QA lead asks the agent to find the latest preview URL from the staging deployment. ## Benefits - Get your production site live faster by triggering builds from specific tags without needing to push new commits to your repository. - Stop wasting time watching progress bars by quickly seeing the status of recent builds and finding the latest preview URLs in one go. - Manage your infrastructure more efficiently by stopping stalled compilations that are hogging your build minutes or blocking the queue. - Audit your entire portfolio in seconds to see every root domain and SSL status across your organization's projects. - Keep your environment organized by getting a high-level view of every project and its configuration without leaving your IDE. ## How It Works The bottom line is you get full control over your Vercel environment without switching tabs. 1. Provide your Vercel API token to the connector for secure access. 2. Connect the Connector to your preferred AI client like Cursor or Claude. 3. Ask your agent to check build statuses, list domains, or trigger new deployments. ## Frequently Asked Questions **Can I use the Vercel MCP to deploy my website?** Yes, you can use it to trigger builds and manage deployments. It allows your agent to start new builds from specific branches or tags and check their status as they complete. **How do I trigger a Vercel build without pushing to GitHub?** You can use the Connector to command your agent to start a manual build. This is perfect for hotfixes where you want to see a deployment immediately without making a new commit. **Can the Vercel MCP see my DNS settings?** Yes, it can audit your root domains and list subdomain routing mappings. This makes it easy to verify your DNS health across your entire project portfolio. **Is it safe to delete projects with the Vercel MCP?** The Connector does have a tool to remove projects, but it is irreversible. You should always be specific about which project you want to remove to avoid accidental deletions. **Can I find preview URLs for my staging deployments?** Yes, your agent can check the status of recent builds and provide you with the live preview URL as soon as the deployment is ready. **Does the Vercel MCP work with Cursor and Claude?** Yes, it works with any MCP-compatible client, including Claude, Cursor, Windsurf, and VS Code, allowing you to manage Vercel from your preferred editor. **Can I cancel a stuck Vercel deployment directly from my chat window?** Yes. If a build hangs, simply find its ID via `list_deployments` and tell the agent: `Abort the deployment execution 'dpl_9B...'`. The `cancelDeploymentTool` intercepts and kills the remote CI task instantly. **How do I get the Preview URL of a newly built branch?** Instruct the AI manually: `Grab the deployment details for 'dpl_xx3'`. Using the `getDeploymentTool`, the agent will output the associated generated live `url` property for you to click without going to the dashboard notifications. **Can I spin up an empty Vercel project programmatically through the agent before I even connect my repository?** Yes. Run the prompt: `Create a new Next.js project on Vercel named 'test-saas'`. The agent initiates `createProjectTool`, and Vercel will instantly return its new unique Project GUID, ready to be linked to code whenever you wish.