How to Use the Woodpecker CI MCP in Windsurf

Q: How do I check the health of Woodpecker CI when using Windsurf?

Just call gethealthz. That single tool tells you if the MCP Server is running smoothly and ready to accept commands. It’s a simple ping that gives you immediate status confirmation.

Q: Can Woodpecker CI's agent list be managed by Windsurf?

Yeah, absolutely. You can see all active agents using listagents and if something needs updating or retiring, you can use updateagent or deleteagent. It keeps your worker pool clean.

Q: Where can I find information about Woodpecker CI permissions using Windsurf?

You check user access rights by calling getorgpermissions. This tool retrieves the current user's specific permission set within any given organization, keeping things locked down.

Manage Woodpecker CI with Windsurf's Cascade agent.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Woodpecker CI MCP to Windsurf

Create your Vinkius account to connect Woodpecker CI to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Woodpecker CI with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automating Pipelines in Woodpecker CI with Windsurf

You can trigger a manual pipeline immediately using the `trigger_pipeline` tool. Windsurf reads the required parameters and executes the full workflow, checking on its status via `get_pipeline`. If something goes wrong, you don't need to manually step through it; simply tell Cascade your goal—like 'fix this build.' It figures out if it needs to `cancel_pipeline` or maybe even `restart_pipeline` and handles the sequence for you.

Managing Repositories via Woodpecker CI

Need to know what's going on with a repo? Use `get_repo` to pull all the current settings, or use `list_repos` to see everything on the server. You can even repair webhooks using `repair_repo` if things look stale. If you need deep control, Windsurf lets you change ownership via `chown_repo` or delete an entire repo structure with `delete_repo`. It handles all these state changes without you prompting for each one.

Monitoring Agents and Secrets on the MCP Server

Keep tabs on your workers. You can list every agent using `list_agents` or get specific details with `get_agent`. Need to know what they're doing? Just call `list_agent_tasks`. For sensitive data, Windsurf handles secrets too. It lets you view organization-level secrets with `list_org_secrets` and even create new ones using `create_global_secret`.

Setup guide

Set up Woodpecker CI MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Woodpecker CI MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Woodpecker CI payment history." If connected, Cascade will call the Woodpecker CI tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "woodpecker-ci-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Woodpecker CI. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Woodpecker CI now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Woodpecker CI MCP in Windsurf

Just call `get_healthz`. That single tool tells you if the MCP Server is running smoothly and ready to accept commands. It’s a simple ping that gives you immediate status confirmation.

Yeah, absolutely. You can see all active agents using `list_agents` and if something needs updating or retiring, you can use `update_agent` or `delete_agent`. It keeps your worker pool clean.

This server manages all types of secrets: organization-level secrets (listed by `list_org_secrets`) and repository-specific secrets (listed by `list_repo_secrets`). These are sensitive credentials.

Windsurf lets you get the full configuration for any pipeline using `get_pipeline_config`. You can review the exact files that define the build process before trying to restart it with `restart_pipeline`.

You check user access rights by calling `get_org_permissions`. This tool retrieves the current user's specific permission set within any given organization, keeping things locked down.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript