# Harness MCP for AI Agents AI Agent Connect > Harness MCP. Connect your Harness.io platform to your AI agent to manage CI/CD pipelines, monitor deployments, and audit secrets directly through a chat interface. Stop jumping between tabs to check build statuses or trigger releases. This Connector gives your agent the permissions to act as a dedicated DevOps coordinator for your entire software delivery lifecycle. ## Overview - **Category:** ship-it - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_FKVrjuS3OzI8VzOXfjNk3FkTG4tKnGJtdNAAcY8J/ai-agent-connect - **Tags:** ci-cd, pipeline-automation, software-delivery, feature-flags, cloud-cost-management, deployment-monitoring ## Description Imagine you're in the middle of a release and something breaks. Usually, you'd have to dive into the Harness dashboard, hunt for the right project, find the specific pipeline, and dig through the logs to see where it tripped up. With this Connector, you just ask your agent. You can pull up the YAML for a pipeline, check the status of a live deployment, or grab a list of secrets to make sure your environment variables are set correctly. It turns your AI into a Release Engineer that actually has the keys to the kingdom. Instead of copy-pasting data back and forth, you're just describing what you need to happen. It makes managing complex software delivery feel like a conversation rather than a series of clicks. You can find this inside the Vinkius catalog alongside other tools that help bridge the gap between your dev workflow and your infrastructure. No more manual navigating through complex DevOps dashboards. Your agent handles the heavy lifting of finding the right data so you can focus on shipping code. ## Tools ### execute_pipeline Trigger a new execution of a pipeline. Use this to start a deployment or a build with a simple command. ### list_projects Browse all projects within your configured Harness organization. It's the starting point for navigating your workspace. ### list_secrets View the secrets configured in a project. Use this to ensure your environment variables are correctly set. ### get_audit_logs Retrieve the platform audit logs. This is essential for monitoring changes and maintaining security standards. ### get_execution_status Check the current status and specific step details of a pipeline execution. It helps you see exactly where a deployment is stuck. ### get_pipeline Fetch the full details and YAML configuration for a specific pipeline. Use this to inspect how a workflow is structured. ### list_connectors See all infrastructure connectors like Git, Docker, and K8s. This helps you verify your platform's integrations. ### list_environments Get a list of all environments defined within a project. It's the easiest way to see your deployment targets. ### list_executions Pull a list of all executions for a specific pipeline. This is great for reviewing recent deployment history. ### list_pipelines List all pipelines inside a specific project. Use this to get an overview of your project's workflows. ### list_services See all microservices defined in a project. This gives you a clear map of your DevOps ecosystem. ## Prompt Examples **Prompt:** ``` List all pipelines in the 'E-commerce App' project. ``` **Response:** ``` I found 3 pipelines for 'E-commerce App': * **Production Deploy** * **Staging Sync** * **Security Scan** Which one do you want to look at? ``` **Prompt:** ``` Start the 'Production Deploy' for project app_502. ``` **Response:** ``` Done! I've triggered **Production Deploy** (ID: deploy_v1) for project **app_502**. You can check the progress anytime. ``` **Prompt:** ``` What's the status of the last deployment? ``` **Response:** ``` The latest execution (ID: exec_992) is currently **IN_PROGRESS**. * **Completed:** 2 out of 5 steps (Build and Unit Tests) * **Running:** Step 3 (Artifact Push) Should I keep monitoring this for you? ``` ## Capabilities ### Trigger pipeline runs Start a new execution of any pipeline with a simple natural language command. ### Check live deployment status Get real-time updates on active deployments including specific step details. ### Pull pipeline YAML files Fetch the full configuration and YAML for a specific pipeline to inspect its structure. ### Browse organizational projects List all projects within your Harness organization to navigate your workspace. ### Audit platform logs Retrieve platform audit logs to monitor changes and maintain security standards. ### List environment configurations See all environments defined in a project to verify your deployment targets. ### View microservice definitions List all services defined in a project to map out your DevOps ecosystem. ## Use Cases ### Checking a failed build An engineer asks why a deployment failed. The agent uses get_execution_status to find the error and get_audit_logs to see who changed the config. ### Starting a release A manager needs to deploy to staging. They tell the agent to execute_pipeline for the 'Staging Sync' workflow in the 'E-commerce' project. ### Config Auditing A security lead wants to check for exposed secrets. The agent uses list_secrets across multiple projects to verify compliance. ### Infrastructure Mapping A new dev wants to see the stack. The agent uses list_connectors and list_services to show all active microservices and integrations. ## Benefits - Stop tab-switching by using list_projects and list_pipelines to navigate your workspace directly in your chat. - Get instant feedback on builds with get_execution_status to see exactly which step failed. - Speed up troubleshooting by pulling YAML configs with get_pipeline instead of hunting through the web UI. - Maintain security by quickly checking your list_secrets and get_audit_logs to verify configurations. - Automate repetitive tasks like starting a deployment using the execute_pipeline tool. - Get a bird's-eye view of your infra by using list_connectors and list_services to map out your ecosystem. ## How It Works The bottom line is you get a hands-free way to manage your entire CI/CD lifecycle through a chat interface. 1. Subscribe to the Harness MCP on Vinkius. 2. Enter your Harness API Key, Account ID, and Organization ID. 3. Ask your agent to list projects, check statuses, or trigger deployments. ## Frequently Asked Questions **Can the Harness MCP trigger deployments?** Yes, you can use it to start any pipeline execution just by asking your agent. It handles the request for you so you don't have to log into the web console. **How do I check if my secrets are set up correctly?** You can ask your agent to list the secrets for a specific project. It will pull the list from Harness and show you what's configured. **Can I use the Harness MCP to see my audit logs?** Yes, it can retrieve platform audit logs. This is great for tracking changes to your infrastructure or investigating recent security events. **Does the Harness MCP work with my YAML files?** You can use it to get the full YAML configuration for any specific pipeline. This makes it easy to inspect your workflow structure directly in your chat. **Is the Harness MCP good for SREs?** It's perfect for SREs who need to monitor execution failures and check environment configurations quickly. It saves time by pulling that data into a single view. **Can I see my microservices with this Connector?** Yes, it can list the services defined in your projects. It helps you get a clear map of your entire DevOps ecosystem without manual searching. **How do I find my Harness API Key?** Log in to Harness, go to **My Profile** (bottom left), and select **API Keys**. You can generate either a Personal API Key or use a Service Account Token from there. **Where can I find my Account ID and Org ID?** The Account ID is visible in your browser's URL when logged in (e.g., `account/XYZ123`). The Organization ID is typically found in the project settings or sidebar (default is often 'default'). **Can I trigger a pipeline execution via this integration?** Yes! Use the `execute_pipeline` tool by providing the project ID and pipeline ID. Harness will initiate the workflow immediately. **Is the integration secure for managing secrets?** Absolutely. The integration only lists the metadata of your secrets (like names and identifiers) through your API key. Your credentials are encrypted and stored securely in the Vinkius Cloud.