Woodpecker CI MCP Server for WindsurfGive Windsurf instant access to 34 tools to Activate Repo, Cancel Pipeline, Chown Repo, and more
Windsurf brings agentic AI coding to a purpose-built IDE. Connect Woodpecker CI through Vinkius and Cascade will auto-discover every tool. ask questions, generate code, and act on live data without leaving your editor.
Ask AI about this MCP Server for Windsurf
The Woodpecker CI MCP Server for Windsurf is a standout in the Ship It category — giving your AI agent 34 tools to work with, ready to go from day one.
Vinkius delivers Streamable HTTP and SSE to any MCP client
{
"mcpServers": {
"woodpecker-ci": {
"url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
}
}
}Vinkius Desktop App
The modern way to manage MCP Servers — no config files, no terminal commands. Install Woodpecker CI and 4,000+ MCP Servers from a single visual interface.





* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
About Woodpecker CI MCP Server
Connect your Woodpecker CI server to any AI agent to automate your continuous integration and deployment workflows through natural language.
Windsurf's Cascade agent chains multiple Woodpecker CI tool calls autonomously. query data, analyze results, and generate code in a single agentic session. Paste Vinkius Edge URL, reload, and all 34 tools are immediately available. Real-time tool feedback appears inline, so you see API responses directly in your editor.
What you can do
- Pipeline Control — List, trigger, restart, or cancel pipelines for any repository to keep your builds moving.
- Agent Monitoring — View all connected agents, check their health metrics, and manage task assignments in real-time.
- Repository Management — Activate new repositories, update settings, and repair webhooks without leaving your chat interface.
- Secret & Config Management — Securely handle global, organization, or repository-level secrets and inspect pipeline configurations.
- System Insights — Retrieve server version, health status, and performance metrics to ensure your CI infrastructure is running smoothly.
The Woodpecker CI MCP Server exposes 34 tools through the Vinkius. Connect it to Windsurf in under two minutes — credentials fully managed, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
All 34 Woodpecker CI tools available for Windsurf
When Windsurf connects to Woodpecker CI through Vinkius, your AI agent gets direct access to every tool listed below — spanning ci-cd, pipelines, automation, and more. Every call runs in a secure, isolated environment with full audit visibility. Beyond a simple connection, you get real-time monitoring of agent activity, enterprise governance, and optimized token usage.
Activate repo on Woodpecker CI
Activate a repository
Cancel pipeline on Woodpecker CI
Cancel a running pipeline
Chown repo on Woodpecker CI
Change repository owner to the current user
Create agent on Woodpecker CI
Create a new Woodpecker agent
Create global secret on Woodpecker CI
Create a global secret
Create repo secret on Woodpecker CI
Create a repository secret
Delete agent on Woodpecker CI
Delete an agent
Delete pipeline on Woodpecker CI
Delete a pipeline
Delete repo on Woodpecker CI
Deactivate/delete a repository
Get agent on Woodpecker CI
Get details of a specific agent
Get healthz on Woodpecker CI
Server health check
Get metrics on Woodpecker CI
Prometheus metrics (requires WOODPECKER_PROMETHEUS_AUTH_TOKEN if configured)
Get org permissions on Woodpecker CI
Get user permissions for an organization
Get pipeline on Woodpecker CI
Get details of a specific pipeline
Get pipeline config on Woodpecker CI
Get the configuration files used for a pipeline
Get repo on Woodpecker CI
Get repository details
Get user on Woodpecker CI
Get the currently authenticated user
Get version on Woodpecker CI
Get server version information
List agent tasks on Woodpecker CI
List tasks currently assigned to an agent
List agents on Woodpecker CI
List all Woodpecker agents
List global secrets on Woodpecker CI
List global secrets (Admin only)
List org agents on Woodpecker CI
List agents scoped to an organization
List org secrets on Woodpecker CI
List organization-level secrets
List orgs on Woodpecker CI
List all organizations
List pipelines on Woodpecker CI
List pipelines for a repository
List repo secrets on Woodpecker CI
List repository-level secrets
List repos on Woodpecker CI
List all repositories on the server
List users on Woodpecker CI
List all users (Admin only)
Lookup repo on Woodpecker CI
Lookup a repository by its full name (slug)
Repair repo on Woodpecker CI
Repair repository webhooks
Restart pipeline on Woodpecker CI
Restart a pipeline
Trigger pipeline on Woodpecker CI
Trigger a manual pipeline
Update agent on Woodpecker CI
Update an existing agent
Update repo on Woodpecker CI
Update repository settings
Connect Woodpecker CI to Windsurf via MCP
Follow these steps to wire Woodpecker CI into Windsurf. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.
Open MCP Settings
Cmd+Shift+P and search "MCP"Add the server
mcp_config.jsonSave and reload
Start using Woodpecker CI
Why Use Windsurf with the Woodpecker CI MCP Server
Windsurf provides unique advantages when paired with Woodpecker CI through the Model Context Protocol.
Windsurf's Cascade agent autonomously chains multiple tool calls in sequence, solving complex multi-step tasks without manual intervention
Purpose-built for agentic workflows. Cascade understands context across your entire codebase and integrates MCP tools natively
JSON-based configuration means zero code changes: paste a URL, reload, and all 34 tools are immediately available
Real-time tool feedback is displayed inline, so you see API responses directly in your editor without switching contexts
Woodpecker CI + Windsurf Use Cases
Practical scenarios where Windsurf combined with the Woodpecker CI MCP Server delivers measurable value.
Automated code generation: ask Cascade to fetch data from Woodpecker CI and generate models, types, or handlers based on real API responses
Live debugging: query Woodpecker CI tools mid-session to inspect production data while debugging without leaving the editor
Documentation generation: pull schema information from Woodpecker CI and have Cascade generate comprehensive API docs automatically
Rapid prototyping: combine Woodpecker CI data with Cascade's code generation to scaffold entire features in minutes
Example Prompts for Woodpecker CI in Windsurf
Ready-to-use prompts you can give your Windsurf agent to start working with Woodpecker CI immediately.
"List all Woodpecker agents and show their current status."
"Find the repository 'vinkius/mcp-server' and trigger a new pipeline."
"Show me the last 5 pipelines for repository ID 42."
Troubleshooting Woodpecker CI MCP Server with Windsurf
Common issues when connecting Woodpecker CI to Windsurf through Vinkius, and how to resolve them.
Server not connecting
Woodpecker CI + Windsurf FAQ
Common questions about integrating Woodpecker CI MCP Server with Windsurf.
How does Windsurf discover MCP tools?
mcp_config.json file on startup and connects to each configured server via Streamable HTTP. Tools are listed in the MCP panel and available to Cascade automatically.Can Cascade chain multiple MCP tool calls?
Does Windsurf support multiple MCP servers?
mcp_config.json. Each server's tools appear in the MCP panel and Cascade can use tools from different servers in a single flow.Explore More MCP Servers
View all →
Jebbit
10 toolsAccess interactive experiences and zero-party data via Jebbit API.

Quentn
11 toolsBuild email marketing funnels with visual automation workflows designed for German-speaking markets and GDPR compliance.

JobProgress (Leap)
10 toolsManage contractors, customers, and jobs via JobProgress API.

HQBeds
10 toolsManage hostel and accommodation bookings with channel distribution, guest communication, and occupancy tracking in one system.
