Woodpecker CI MCP Server for Mastra AIGive Mastra AI instant access to 34 tools to Activate Repo, Cancel Pipeline, Chown Repo, and more
GDPR Free for SubscribersMastra AI is a TypeScript-native agent framework built for modern web stacks. Connect Woodpecker CI through Vinkius and Mastra agents discover all tools automatically. type-safe, streaming-ready, and deployable anywhere Node.js runs.
Ask AI about this MCP Server for Mastra AI
The Woodpecker CI MCP Server for Mastra AI 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
Geminiimport { Agent } from "@mastra/core/agent";
import { createMCPClient } from "@mastra/mcp";
import { openai } from "@ai-sdk/openai";
async function main() {
// Your Vinkius token. get it at cloud.vinkius.com
const mcpClient = await createMCPClient({
servers: {
"woodpecker-ci": {
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
},
});
const tools = await mcpClient.getTools();
const agent = new Agent({
name: "Woodpecker CI Agent",
instructions:
"You help users interact with Woodpecker CI " +
"using 34 tools.",
model: openai("gpt-4o"),
tools,
});
const result = await agent.generate(
"What can I do with Woodpecker CI?"
);
console.log(result.text);
}
main();
* 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.
Mastra's agent abstraction provides a clean separation between LLM logic and Woodpecker CI tool infrastructure. Connect 34 tools through Vinkius and use Mastra's built-in workflow engine to chain tool calls with conditional logic, retries, and parallel execution. deployable to any Node.js host in one command.
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 Mastra AI 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 Mastra AI
When Mastra AI 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 Mastra AI via MCP
Follow these steps to wire Woodpecker CI into Mastra AI. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.
Install dependencies
npm install @mastra/core @mastra/mcp @ai-sdk/openaiReplace the token
[YOUR_TOKEN_HERE] with your Vinkius tokenRun the agent
agent.ts and run with npx tsx agent.tsExplore tools
Why Use Mastra AI with the Woodpecker CI MCP Server
Mastra AI provides unique advantages when paired with Woodpecker CI through the Model Context Protocol.
Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure. add Woodpecker CI without touching business code
Built-in workflow engine chains MCP tool calls with conditional logic, retries, and parallel execution for complex automation
TypeScript-native: full type inference for every Woodpecker CI tool response with IDE autocomplete and compile-time checks
One-command deployment to any Node.js host. Vercel, Railway, Fly.io, or your own infrastructure
Woodpecker CI + Mastra AI Use Cases
Practical scenarios where Mastra AI combined with the Woodpecker CI MCP Server delivers measurable value.
Automated workflows: build multi-step agents that query Woodpecker CI, process results, and trigger downstream actions in a typed pipeline
SaaS integrations: embed Woodpecker CI as a first-class tool in your product's AI features with Mastra's clean agent API
Background jobs: schedule Mastra agents to query Woodpecker CI on a cron and store results in your database automatically
Multi-agent systems: create specialist agents that collaborate using Woodpecker CI tools alongside other MCP servers
Example Prompts for Woodpecker CI in Mastra AI
Ready-to-use prompts you can give your Mastra AI 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 Mastra AI
Common issues when connecting Woodpecker CI to Mastra AI through Vinkius, and how to resolve them.
createMCPClient not exported
npm install @mastra/mcpWoodpecker CI + Mastra AI FAQ
Common questions about integrating Woodpecker CI MCP Server with Mastra AI.
How does Mastra AI connect to MCP servers?
MCPClient with the server URL and pass it to your agent. Mastra discovers all tools and makes them available with full TypeScript types.Can Mastra agents use tools from multiple servers?
Does Mastra support workflow orchestration?
Explore More MCP Servers
View all →
U.S. Census Housing — Home Values, Rent & Real Estate Data
5 toolsAccess the definitive source for U.S. residential real estate data. Extract median home values, median gross rent, ownership vs. renting rates, and vacancy data at the state and county level. Create full socioeconomic profiles.
Browserbear
10 toolsAutomate browser tasks via Browserbear — take screenshots, scrape data, and run multi-step automations directly from any AI agent.
Teamwork Projects
17 toolsManage projects, tasks, milestones, time entries, and messages via Teamwork API.
Argo CD (GitOps)
13 toolsManage Kubernetes deployments via Argo CD — sync applications, check logs, and manage clusters/repositories directly from your AI agent.