# Drone CI MCP for AI Agents AI Agent Connect

> Drone CI MCP for AI agents. Automate your CI/CD workflows by letting your agent manage repositories, monitor builds, and handle secrets directly from your chat interface. It gives your agent direct control over Drone CI pipelines so you can manage your DevOps lifecycle through simple natural language commands.

## Overview
- **Category:** ship-it
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_dx9mCOQyav7cFI5Xqg1vPEMDEWxlvhlxX5uPGcg6/ai-agent-connect
- **Tags:** ci-cd, build-automation, repository-management, pipeline-monitoring, secrets-management, deployment

## Description

Drone CI MCP lets you manage your entire CI/CD lifecycle through a simple chat interface. Instead of jumping between browser tabs and terminal windows, you can ask your agent to handle build management, repository configuration, and secret rotation directly from your workspace. You can pull logs for a failing pipeline, restart a stuck build, or check the status of all your repositories in one go. It removes the manual friction of DevOps by turning complex infrastructure tasks into a conversation. Whether you need to create cron jobs, manage organization templates, or handle user administration, this Connector puts those controls in your hands. You can quickly repair webhooks, promote builds to target environments, and manage repository secrets without ever leaving your primary chat window. This makes it much easier to keep your deployments organized and your team's access secure. By connecting Drone CI through the Vinkius catalog, you get a direct line to your deployment pipeline without the need for custom scripts. It's about making your workflow feel natural while keeping your deployment process fast and organized. You get to spend less time hunting for logs and more time actually shipping code.

## Tools

### update_cron_job
Update an existing cron job. Use this to change the timing or configuration of a task.

### approve_build
Approve a build that is currently blocked by a manual gate. This helps move pipelines forward without manual intervention.

### chown_repo
Change the ownership of a repository to the current user. Use this to fix permission issues quickly.

### create_build
Start a custom build for a specific branch. This is useful for running one-off tasks or tests.

### create_cron_job
Create a new cron job in your CI environment. Use this to schedule recurring tasks.

### create_secret
Add a new secret to a repository. This helps you keep environment variables secure and accessible.

### create_template
Create a new project template. Use this to standardize how new projects are set up in your organization.

### create_user
Create a new user account with administrative rights. Use this to onboard new team members.

### decline_build
Decline a build that is currently blocked. Use this to stop a pipeline from proceeding.

### delete_cron_job
Delete an existing cron job. Use this to clean up old scheduled tasks.

### delete_secret
Delete a repository secret. Use this to remove sensitive data when it is no longer needed.

### delete_template
Delete a project template. Use this to remove outdated project configurations.

### delete_user
Delete a user account from the system. Use this to offboard users who no longer need access.

### disable_repo
Disable or delete a repository in Drone. Use this to decommission old projects.

### get_build_logs
Fetch logs for a specific step in a build stage. This helps you see exactly where a pipeline failed.

### get_build
Get specific build details including stages and steps. Use this to see the full history of a run.

### get_cron_job
Get the details of a specific cron job. Use this to check the configuration of a scheduled task.

### get_repo
Get information about a specific repository. Use this to see the status of a project.

### get_secret
Get the details of a repository secret. Use this to verify that a secret is correctly set.

### get_template
Get the details of a project template. Use this to view organization standards.

### get_user
Get user info by login name. Use this for administrative lookups of team members.

### list_builds
List recent builds for a repository. Use this to see the latest activity on a project.

### list_users
List all registered users. Use this to see a full list of people with system access.

### promote_build
Promote a build to a target environment. Use this to move successful code into production.

### stop_build
Stop a running build. Use this to immediately halt a pipeline that is behaving unexpectedly.

### sync_user_repos
Synchronize user repositories. Use this to keep your local view of projects up to date.

### trigger_cron_job
Manually trigger an existing cron task. Use this to run a scheduled job on demand.

### update_repo
Update repository configuration. Use this to modify project settings in your CI environment.

### update_template
Update a project template. Use this to modify the blueprints for new projects.

### update_user
Update a user account profile. Use this to modify the details of an existing user.

### enable_repo
Enable or register a new repository. Use this to bring new projects into your CI/CD flow.

### get_current_user_repos
Get all repositories for the current user. Use this to see which projects you have access to.

### get_current_user
Get the info for the currently authenticated user. Use this to verify your current session details.

### list_cron_jobs
List all cron jobs for a repository. Use this to see what tasks are scheduled to run.

### list_secrets
List all secrets for a repository. Use this to audit the environment variables in use.

### list_templates
List all organization templates. Use this to see available project blueprints.

### repair_repo
Repair repository webhooks. Use this to fix broken connections between your source control and Drone.

### restart_build
Restart a specific build. Use this to retry a build that failed due to a transient error.

### update_secret
Update a repository secret. Use this to rotate keys or update environment variables.

## Prompt Examples

**Prompt:** 
```
I need to see why my last build failed for the web-app repo.
```

**Response:** 
```
I've pulled the logs for the latest failed build on **web-app**. 

**Build #42 - Failed**
- **Stage**: Test
- **Step**: Unit Tests
- **Error**: `ConnectionTimeout: Could not connect to database at 10.0.0.5`

It looks like the test suite couldn't reach the database. Would you like me to restart this build or check the secrets for this repo?
```

**Prompt:** 
```
Can you restart the build for the api project?
```

**Response:** 
```
Done! I've initiated a restart for the latest build on the **api** project. 

**New Build ID**: #55
**Status**: Queued

I'll keep an eye on it. Let me know if you need anything else.
```

**Prompt:** 
```
Create a new secret for the staging repo called 'API_KEY'.
```

**Response:** 
```
I can certainly help with that. Please provide the value you'd like to assign to the **API_KEY** secret for the **staging** repository.

Once you provide the value, I'll update it in Drone for you.
```

## Capabilities

### Restart stuck builds
You can trigger a restart on any specific build that has hung or failed.

### Fetch specific step logs
Pull the exact logs for a failing step in your pipeline to see the error message.

### Manage repository secrets
Create or update environment secrets for your repositories using simple chat commands.

### Control repository settings
Enable, update, or repair repository configurations and webhooks instantly.

### Administer user accounts
Manage organizational access by creating, updating, or deleting user accounts.

### Create cron jobs
Set up and trigger scheduled cron tasks for your CI pipelines.

## Use Cases

### Debugging a failing build
A developer sees a red X in their IDE, asks the agent to fetch logs for the failing step, and identifies a database timeout instantly using `get_build_logs`.

### Rotating production secrets
An SRE asks the agent to update the DB password secret for the production repo, and it completes the task via `update_secret` without a browser.

### Managing repository sprawl
A DevOps lead asks the agent to list all active repos and then enable three new ones, using `list_builds` and `enable_repo` to organize the workspace.

### Manual build triggers
A QA engineer asks the agent to trigger a specific cron job to run a nightly smoke test, and the agent executes it via `trigger_cron_job`.

## Benefits

- Stop context-switching by checking build logs and statuses without leaving your IDE using `get_build_logs`.
- Manage secrets across multiple projects in one place using `create_secret` and `update_secret` commands.
- Speed up troubleshooting with `get_build_logs` to see exactly where a pipeline failed without hunting through menus.
- Handle repository maintenance like `repair_repo` and `enable_repo` via simple chat prompts instead of manual configuration.
- Control your infrastructure more easily with `create_cron_job` and `trigger_cron_job` commands for scheduled tasks.
- Manage team access and organization templates using `list_users` and `create_template` for faster onboarding.

## How It Works

The bottom line is you get a chat-based interface for your entire Drone CI lifecycle.

1. Subscribe to the Drone CI MCP on the Vinkius marketplace.
2. Provide your Drone URL and Personal Access Token in the connection settings.
3. Start managing your builds, secrets, and repositories through natural language.

## Frequently Asked Questions

**Can the Drone CI MCP help me debug my pipelines?**
Yes, it lets your agent pull logs for specific steps so you can see errors immediately without leaving your chat or IDE.

**How do I manage repo secrets with Drone CI?**
You can ask your agent to create, update, or list secrets for any repository using simple natural language.

**Can I use this to manage my team's access?**
Yes, it includes tools to list, create, and update user accounts, making it easy to manage organizational access.

**Can the Drone CI MCP restart a stuck build?**
It can. Just ask your agent to restart a specific build ID, and it will handle the request for you.

**Does this work with my current Drone setup?**
It works with any standard Drone CI server. You just need to provide your Drone URL and a Personal Access Token.

**How do I automate my cron jobs?**
You can use your agent to create, update, or trigger cron jobs via natural language commands.

**Can I use this to manage project templates?**
Yes, you can list, create, and update organization templates to standardize your project setups.

**Can I view the logs of a specific build to debug an error?**
Yes, use the `get_build_logs` tool by providing the owner, repo name, and build number. Your agent will retrieve the full output from the pipeline steps.

**How do I trigger a new build for a repository?**
You can use the `create_build` tool to trigger a new build or `restart_build` to re-run an existing build number for a specific repository.

**Is it possible to manage environment secrets through this agent?**
Absolutely. You can use `list_secrets`, `create_secret`, and `update_secret` to manage your repository's sensitive data securely from the conversation.