Use Woodpecker CI with your AI.
Connect your account once and let the AI you already use work with it, without building another integration. Manage your Woodpecker CI instance. control pipelines, monitor agents, and configure repositories directly from your AI agent.
Developed, maintained, and hosted by Vinkius.
MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED
Waiting for input…
Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.
Complete set · 34 capabilities
The complete Woodpecker CI capability set.
These are the exact actions your AI can choose when you ask it to work with Woodpecker CI.
01-04
4 capabilities in this set.
Part of 34 available through Woodpecker CI.
- 01
Create agent
Create a new Woodpecker agent
- 02
Get agent
Get details of a specific agent
- 03
Get org permissions
Get user permissions for an organization
- 04
Get pipeline config
Get the configuration files used for a pipeline
05-08
4 capabilities in this set.
Part of 34 available through Woodpecker CI.
- 05
List agents
List all Woodpecker agents
- 06
List org agents
List agents scoped to an organization
- 07
List orgs
List all organizations
- 08
List org secrets
List organization-level secrets
09-12
4 capabilities in this set.
Part of 34 available through Woodpecker CI.
- 09
List repos
List all repositories on the server
- 10
List repo secrets
List repository-level secrets
- 11
Restart pipeline
Restart a pipeline
- 12
Delete agent
Delete an agent
13-16
4 capabilities in this set.
Part of 34 available through Woodpecker CI.
- 13
Get repo
Get repository details
- 14
Cancel pipeline
Cancel a running pipeline
- 15
Chown repo
Change repository owner to the current user
- 16
Create global secret
Create a globalThis secret
17-20
4 capabilities in this set.
Part of 34 available through Woodpecker CI.
- 17
Create repo secret
Create a repository secret
- 18
Delete pipeline
Delete a pipeline
- 19
Delete repo
Deactivate/delete a repository
- 20
Get healthz
Server health check
21-24
4 capabilities in this set.
Part of 34 available through Woodpecker CI.
- 21
Get metrics
Prometheus metrics (requires WOODPECKER_PROMETHEUS_AUTH_TOKEN if configured)
- 22
Get pipeline
Get details of a specific pipeline
- 23
Get user
Get the currently authenticated user
- 24
Get version
Get server version information
25-28
4 capabilities in this set.
Part of 34 available through Woodpecker CI.
- 25
List agent tasks
List tasks currently assigned to an agent
- 26
List global secrets
List globalThis secrets (Admin only)
- 27
List pipelines
List pipelines for a repository
- 28
List users
List all users (Admin only)
29-31
3 capabilities in this set.
Part of 34 available through Woodpecker CI.
- 29
Lookup repo
Lookup a repository by its full name (slug)
- 30
Repair repo
Repair repository webhooks
- 31
Trigger pipeline
Trigger a manual pipeline
32-34
3 capabilities in this set.
Part of 34 available through Woodpecker CI.
- 32
Update agent
Update an existing agent
- 33
Update repo
Update repository settings
- 34
Activate repo
Activate a repository
Observed, not estimated
1018ms average. Fast in production.
Woodpecker CI is checked daily against the live service.
- Fastest day
- 868ms
- Slowest day
- 1268ms
- 14-day trend
- Slowing+9%
Connect your client
One URL. Every client.
Activate the Connector, copy your link, and paste it into the client you already use. 34 capabilities arrive ready to run.
Preview access · not provider authentication
The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of Woodpecker CI, so you can see the experience inside your AI.
It does not authenticate your account with Woodpecker CI. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.
Woodpecker CI Connector
You're all set. Choose your MCP client and follow the setup instructions.
https://edge.vinkius.com/vk_preview_FerYBzPY1px1PeVxdzIkY0bEgd6qWRE3xebiZbq6/mcpClaude Desktop
Follow the steps below to connect in seconds.
- 1In Claude Desktop, open Settings → Connectors.
- 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
- 3Click Add and start a new chat — Woodpecker CI capabilities are ready to use.
{
"mcpServers": {
"woodpecker-ci-mcp": {
"url": "https://edge.vinkius.com/vk_preview_FerYBzPY1px1PeVxdzIkY0bEgd6qWRE3xebiZbq6/mcp"
}
}
}
Claude
ChatGPT
Cursor
VS Code
Windsurf
Claude Code
JetBrains
Cline
Step-by-step instructions for each client are in the guide. How to connect
FAQ
Questions Woodpecker CI owners ask.
- 01
Can I trigger a new pipeline build for a specific repository?
Yes. Use the trigger_pipeline capability by providing the repository ID. You can also specify a branch or commit if needed to start a new execution immediately.
- 02
How do I check if my build agents are online and healthy?
You can use list_agents to see all connected agents and their status. For more detail on a specific agent, use get_agent or list_agent_tasks to see what it's currently working on.
- 03
Is it possible to manage environment secrets through this agent?
Yes, the server includes capabilities like create_repo_secret and list_repo_secrets to manage sensitive variables at the repository level, as well as global and organization-level secret capabilities.
Explore
More in Ship It
Codefresh AI Connector
Manage CI/CD and GitOps via Codefresh — track pipelines, trigger builds, and monitor delivery clusters directl
ViewBuildkite AI Connector
Automate CI/CD pipelines via Buildkite — manage builds, agents, and deployments directly from any AI agent.
ViewHarness AI Connector
Automate CI/CD and DevOps workflows via Harness — manage pipelines, executions, and secrets directly from any
ViewDagger (Programmable CI) AI Connector
Build, test, and deploy using Dagger's programmable CI engine. Execute GraphQL queries, manage containers, and
View
Suggestions
Pipefy AI Connector
Manage workflows via Pipefy — list pipes, create cards, move phases, update fields, and track processes direct
ViewCI/CD Pipeline Config Validator AI Connector
Deterministic validator for GitHub Actions and GitLab CI configuration files.
ViewFlightcontrol (AWS PaaS Deployments) AI Connector
Deploy and manage AWS infrastructure via Flightcontrol — list projects, manage environments, and scale service
ViewWazuh (SIEM) AI Connector
Manage your Wazuh SIEM infrastructure—monitor agents, inspect security events, and manage manager configuratio
View
