# Codefresh MCP for AI Agents AI Agent Connect > Codefresh MCP lets you manage CI/CD pipelines, trigger builds, and monitor Kubernetes clusters directly from your AI agent. It connects your Codefresh account to tools like Claude or Cursor so you can handle deployments, check build statuses, and audit environment variables without switching tabs. ## Overview - **Category:** ship-it - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_PdvyiuNy98nJgJhF2rWbswmgtQCEOaod7r7AsNCv/ai-agent-connect - **Tags:** kubernetes, continuous-delivery, pipeline-automation, gitops, container-orchestration, deployment-management ## Description Codefresh lets you connect your account to any AI agent and take full control of your CI/CD and cloud-native delivery through natural conversation. This lets you automate how you monitor software deployments without leaving your workspace. You can ask your agent to check on a deployment, kick off a new build, or see what's happening in your clusters while you stay focused on your work. It turns your agent into a teammate that understands your infrastructure. You can ask about pipeline configs, see what's happening in your Kubernetes clusters, or grab the status of a specific build while you're still in your IDE. It handles the heavy lifting of navigating complex CI/CD environments by pulling the data you actually need into your chat. Being part of the Vinkius catalog makes it easy to plug into your existing setup, whether you're using Cursor or Claude. It's about getting answers faster and making sure your deployments are actually moving without having to hunt down specific URLs or copy-paste API keys every time you need a status update. You can get a clear picture of your deployment targets and environment variables with a simple question, making it much easier to keep your production environment stable and your team informed. ## Tools ### get_build_execution_details Get the specific status and execution info for a single build. This helps you see exactly where a workflow stalled. ### get_my_codefresh_profile Pull your account and user details. Use this to confirm which account your agent is currently authenticated with. ### get_pipeline_configuration View the full configuration of a specific pipeline. It's the best way to check your current CI/CD rules without leaving your chat. ### list_codefresh_pipelines List every CI/CD pipeline in your account. Use this to find the right pipeline name before triggering a build. ### list_codefresh_builds See a list of all recent builds in your account. This gives you a quick overview of your recent deployment activity. ### trigger_codefresh_build Start a new build for a specific pipeline. You can specify branches or variables to run a specific test or deployment. ### list_delivery_clusters See all connected Kubernetes and delivery clusters. This keeps your infrastructure targets visible to your agent. ### list_shared_contexts View shared environment contexts like secrets and variables. This is essential for auditing what's available in your workflows. ## Prompt Examples **Prompt:** ``` List all my Codefresh pipelines. ``` **Response:** ``` Checking your account... I found 4 active pipelines: **web-app-prod**, **auth-service-staging**, **worker-node-ci**, and **data-pipeline-dev**. Which one would you like to manage? ``` **Prompt:** ``` Trigger the 'web-app-prod' pipeline on the 'hotfix-login' branch. ``` **Response:** ``` Starting build for **web-app-prod** on branch **hotfix-login**... The build has been successfully initiated. I'll keep an eye on it for you. ``` **Prompt:** ``` What's the status of the last build for the auth-service? ``` **Response:** ``` Checking the latest build for **auth-service**... It finished successfully about 5 minutes ago. The build ID is `cf-99283` and it's currently showing as **SUCCESS**. ``` ## Capabilities ### Trigger new builds Start a build for a specific pipeline with custom branches or variables. ### Monitor cluster health See all connected Kubernetes and delivery clusters in one list. ### Audit environment secrets List shared contexts like variables and secrets used in workflows. ### Track build progress Get status and execution details for recent workflows. ### Manage pipeline configs Retrieve full details and configurations for any CI/CD pipeline. ### View user profiles Get authenticated user and account information. ## Use Cases ### Failed production build A developer sees a red light and asks their agent to check the status of the last api-service build using get_build_execution_details. ### Quick branch deploy A dev wants to test a feature and asks the agent to trigger a build for the frontend pipeline on the 'feature-x' branch. ### Infrastructure audit A manager needs to know where things are deployed and asks the agent to list all connected Kubernetes clusters. ### Context verification An engineer wants to see what secrets are available for a specific environment and uses list_shared_contexts. ## Benefits - Stop tab-switching by using list_codefresh_pipelines and trigger_codefresh_build directly in your IDE. - Audit your environment security by checking shared secrets and variables with list_shared_contexts instantly. - Get faster status updates on failed deployments by pulling specific data with get_build_execution_details. - Keep your infrastructure visible by listing all active delivery targets using list_delivery_clusters. - Verify your deployment rules on the fly by checking any pipeline's setup with get_pipeline_configuration. ## How It Works The bottom line is you get a direct command line for your CI/CD operations inside your AI chat. 1. Subscribe to the Codefresh MCP on Vinkius. 2. Add your Codefresh API Key from your user settings. 3. Start asking your agent to manage builds or check cluster status. ## Frequently Asked Questions **Can I use the Codefresh MCP to start new builds?** Yes, you can trigger new builds for any of your pipelines by simply asking your agent to do so. You can even specify which branch to use or provide custom variables for the build. **Does the Codefresh MCP show me my Kubernetes clusters?** It does. You can ask your agent to list all connected delivery clusters to see exactly where your deployments are landing. **Can I check my pipeline configurations using this?** Yes, you can retrieve detailed information for any specific pipeline. This is great for verifying your CI/CD rules without having to open the Codefresh dashboard. **How do I see the status of a failed build?** You can ask your agent to get the execution details for a specific build. It will pull the status and execution info so you can see what went wrong. **Can this Connector access my secrets?** It can list your shared context, which includes the secrets and variables used in your workflows. This helps you audit what's available for your deployments. **What happens when I connect Codefresh to my AI agent?** It gives your agent the ability to interact with your CI/CD workflows. You can then manage builds, check cluster health, and audit your environment directly through your chat interface. **Can I trigger a pipeline run for a specific branch?** Yes! Use the `trigger_codefresh_build` tool. You can provide the pipeline ID and specify the branch name in the payload. The agent will instruct Codefresh to start the build immediately. **How do I see the status of all my Kubernetes clusters in Codefresh?** Use the `list_delivery_clusters` tool. Your agent will fetch all connected clusters, showing you which targets are available for deployment and their current health status. **Where do I find my Codefresh API Key?** Log in to Codefresh, click on your profile icon, go to **User Settings**, and select **API Keys**. You can generate and copy a new token from that section.