# Vercel MCP for AI Agents AI Agent Connect > Vercel MCP lets you manage your cloud infrastructure and frontend deployments through your AI agent. It handles project lists, build statuses, domain configurations, and environment variables without you having to toggle between tabs. It's built for teams moving fast on Next.js or serverless projects who want to keep their hosting in sync with their code. ## Overview - **Category:** loved-by-devs - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_6ib8D7M3Uv2ypYkXcj4cl2khzaGrEpt6ZJbcaHvI/ai-agent-connect - **Tags:** frontend-deployment, serverless-functions, edge-computing, build-status, deployment-pipeline, web-hosting ## Description This Connector connects your Vercel account to your AI agent so you can handle cloud infrastructure through natural conversation. Instead of digging through the Vercel dashboard to find a specific build status or hunting for a missing environment variable, you just ask your agent to do it. You can pull up project details, see which deployments are currently building, or link new domains to your apps in seconds. It puts your entire deployment pipeline inside your workspace. If you're tired of the context switching between your code editor and the hosting dashboard, this is the fix. It's one of the core tools available in the Vinkius catalog for anyone who needs to keep their production environment in sync with their development cycle. You get a bird's-eye view of your teams and projects without the manual clicking. It turns your AI into a DevOps partner that knows your project history and can execute configuration changes on the fly. ## Tools ### get_vercel_project_details Get the specific configuration and metadata for a single project. This helps you see project-specific settings quickly. ### get_vercel_user_profile Pull your current user profile to see your account permissions. Use this to verify your access levels. ### list_vercel_deployments See a list of your most recent deployments. This is great for checking the health of your recent pushes. ### list_vercel_account_domains View all domains currently registered in your account. Use this to see which URLs are already linked. ### list_vercel_project_env_vars Look up the environment variables for a specific project. This helps you audit your current secrets. ### list_vercel_projects Fetch a list of all projects in your Vercel account. Use this to get a bird's-eye view of your work. ### list_vercel_teams See which teams you have access to in your account. This helps you navigate large organization permissions. ### add_vercel_environment_variable Create a new environment variable for your project. This lets you update secrets without opening a browser. ### create_vercel_deployment Trigger a new deployment for your project. Use this to kick off a build manually through your agent. ### delete_vercel_deployment Remove a specific deployment from your history. This helps you keep your deployment logs clean. ### get_vercel_deployment_info Get deep details on a specific deployment record. Use this to troubleshoot failed builds. ## Prompt Examples **Prompt:** ``` Check the status of my last deployment for the 'marketing-site' project. ``` **Response:** ``` ### Deployment Status: marketing-site | Deployment ID | Status | URL | Time | | :--- | :--- | :--- | :--- | | `dpl_8823...` | **READY** ✅ | `marketing-site.vercel.app` | 2 mins ago | The latest build was successful and is now live. ``` **Prompt:** ``` I need to add a new production database URL to my 'api-gateway' project. ``` **Response:** ``` **Success!** I've added `DATABASE_URL` to the `api-gateway` project. This change is now active across all environments: * **Production** * **Preview** * **Development** ``` **Prompt:** ``` What projects do I have access to in my Vercel account? ``` **Response:** ``` You have access to the following projects in your Vercel account: * `vinkius-app` * `marketing-blog` * `api-gateway` * `staging-env` Which one would you like to inspect? ``` ## Capabilities ### List all account projects Get a full overview of every project associated with your Vercel account. ### Check build statuses See if your latest deployments are ready, building, or failed in real time. ### Manage environment variables Add or view secrets and configuration keys for your projects via chat. ### Link custom domains Connect and manage registered domains for your specific projects instantly. ### Retrieve user permissions Check your current access levels and profile details across teams. ### Delete old deployment records Clean up your deployment history by removing specific old records. ## Use Cases ### Troubleshooting a failed production build A build fails and you need to see why. Ask your agent to check the status of the latest deployment using list_vercel_deployments. ### Updating secrets for a new API key You need to add a new production database URL to your 'api-gateway' project. Tell your agent to use add_vercel_environment_variable for the specific project. ### Onboarding to a new team domain You're moving to a new domain and need to see what's available. Use list_vercel_account_domains to see what is already registered. ### Auditing project permissions A new dev joins and you need to verify access. Use list_vercel_teams to see which organizations and teams are visible to your account. ## Benefits - Stop hunting for build statuses by using list_vercel_deployments to see what is live instantly. - Manage secrets safely and quickly by using add_vercel_environment_variable directly from your chat. - Connect your frontend to new URLs faster using list_vercel_account_domains and linking tools. - Avoid permission confusion by checking your access levels with get_vercel_user_profile. - Keep your project list organized by using list_vercel_projects to see every app you manage. - Verify your project metadata on demand with get_vercel_project_details to ensure correct configurations. ## How It Works The bottom line is you stop leaving your IDE to manage your hosting. 1. Subscribe to the Vercel MCP on the Vinkius Marketplace. 2. Provide your Vercel Access Token from your account settings to your AI client. 3. Ask your agent to check a build status, add a variable, or list your projects. ## Frequently Asked Questions **Does the Vercel MCP let me see my build history?** Yes, you can ask your agent to list recent deployments to see a history of your builds, including their success status and deployment URLs. **Can I use the Vercel MCP to update environment variables?** Absolutely. You can tell your agent to add or list environment variables for any project in your account without leaving your current workspace. **Is the Vercel MCP safe for managing secrets?** Yes, it uses your Vercel Access Token to perform actions securely. It allows you to manage secrets through your AI client just as you would in the dashboard. **How do I connect my Vercel account to my AI client?** You just need to subscribe to the Connector and provide your Vercel Access Token. Once connected, your AI client can manage your projects and deployments automatically. **Can the Vercel MCP help me manage custom domains?** Yes, the Connector can list all registered domains in your account and help you link them to specific projects through simple chat commands. **Does the Vercel MCP work with my team's projects?** Yes, it can list accessible teams and projects, allowing you to manage infrastructure across your entire organization from one place. **Can I see if a specific deployment failed using the AI?** Yes! Use the `get_deployment_info` tool with the Deployment ID. Your agent will retrieve the current state, and if it's 'ERROR', it will show you the deployment details. **How do I add a new API Key to a project via AI?** Use the `add_environment_variable` action. Provide the project name/ID, the key name, and the value. You can also specify the type as 'secret' or 'sensitive'. **Is it possible to list all domains linked to my account?** Absolutely. Use the `list_account_domains` query to retrieve a complete list of all domains registered or configured within your Vercel account.