How to Use the Woodpecker MCP in Mastra AI

Q: Can I list prospects with Woodpecker using Mastra AI?

Absolutely. The listprospects tool is available for your agent framework. You can build a sequence where, first, you pull the contact list, and then pass those records to another step for processing.

Q: What data does Woodpecker touch when connected to Mastra AI?

The server handles prospect information (listprospects), campaign status (e.g., getcampaign), and webhook configuration details. All of this is managed within your robust workflow engine.

Q: Does Woodpecker support tracking webhook data with Mastra AI?

Yes. You can use the listwebhooks tool to monitor which webhooks are active. This is crucial for validating that your automated marketing sequences have successfully connected their necessary endpoints.

Build resilient workflows: Woodpecker data management with Mastra AI.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Woodpecker MCP to Mastra AI

Create your Vinkius account to connect Woodpecker to Mastra AI 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 with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Orchestrate prospect list updates

Use the `add_prospect` tool to programmatically add new contacts into your sequences. If a step fails, Mastra AI handles retries automatically, ensuring data integrity. This is critical when building complex workflows that depend on clean input lists. Additionally, you can retrieve and process contact information by calling `list_prospects`. The platform manages the entire sequence—from initial listing to final record creation—with built-in failure handling.

Control campaign state reliably

Mastra AI allows you to build workflows that manage marketing campaigns with failover logic. You can set up a step: check the status using `get_campaign` and, if it's running too fast, pause it via `pause_campaign`. If the pause fails, the workflow automatically notifies an admin. This level of conditional branching means your multi-step process doesn't break on simple API hiccups. You get reliable state control over campaign lifecycles.

Automate performance checks and listing

Building a complete monitoring loop? Start by calling `list_webhooks` to see what tracking points are active. Then, you can check the overall health using `get_campaign_stats`. If the stats look bad, the workflow triggers an alert. Mastra AI ensures that every step—from listing webhooks to checking performance—is executed with exponential backoff and automatic retries if a connection briefly drops.

Setup guide

Set up Woodpecker MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All Woodpecker tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "woodpecker-mcp-client",
  servers: {
    "woodpecker-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "Woodpecker Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to Woodpecker tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent Woodpecker transactions"
);
console.log(result.text);

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. 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 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 MCP in Mastra AI

You pass the MCP Server URL to your Mastra AI client. This lets you incorporate Woodpecker’s tools directly into complex, multi-step workflows. For example, checking campaign stats and then pausing it if metrics drop below a threshold.

Absolutely. The `list_prospects` tool is available for your agent framework. You can build a sequence where, first, you pull the contact list, and then pass those records to another step for processing.

The server handles prospect information (`list_prospects`), campaign status (e.g., `get_campaign`), and webhook configuration details. All of this is managed within your robust workflow engine.

Yes, because of the built-in retry logic. You can design a workflow that attempts to `resume_campaign`, and if the API call temporarily fails, Mastra AI will automatically back off and try again until it succeeds.

Yes. You can use the `list_webhooks` tool to monitor which webhooks are active. This is crucial for validating that your automated marketing sequences have successfully connected their necessary endpoints.

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