# Woodpecker MCP MCP > Woodpecker lets your AI agent manage B2B cold email outreach directly without opening the platform. You can automate campaign launches, track prospect status, and pull detailed analytics on open rates or replies—all conversational commands sent to your preferred client. ## Overview - **Category:** growth-engine - **Price:** Free - **Tags:** cold-email, email-sequences, deliverability, prospecting, b2b-sales, follow-up-automation ## Description Manage complex sales sequences entirely through conversation. This MCP connects your AI agent straight into Woodpecker, letting you handle everything from initial outreach to deep reporting without ever needing to log into the platform interface. You can tell it to create a multi-step follow-up campaign or check if a specific prospect bounced and needs removal. Need to know how well an entire sequence is performing? Your agent pulls open rates, click metrics, and bounce data for any active campaign. The real power kicks in when you combine this with other MCPs; your agent can take the list of prospects from here, send them through a CRM MCP, and then schedule follow-ups using a messaging MCP, building an automation that spans multiple platforms all through one AI agent. This setup is managed safely on Vinkius, where credentials pass through a zero-trust proxy, meaning your keys are only used in transit and never stored locally. ## Tools ### add_prospect Adds a new contact into your Woodpecker database. ### get_campaign Retrieves the full details for a specific, existing email campaign. ### get_campaign_stats Pulls detailed metrics (opens, clicks, replies) for a given campaign. ### list_campaigns Lists all campaigns you have access to in Woodpecker. ### list_prospects Shows an overview of your current prospect list, allowing filtering and review. ### list_webhooks Lists the webhooks set up for Woodpecker to trigger external actions. ### pause_campaign Temporarily halts an active email campaign from sending emails. ### resume_campaign Reactivates a paused email campaign, allowing it to resume its sequence. ## Prompt Examples **Prompt:** ``` Show campaign stats for 'VP Engineering Outreach'. ``` **Response:** ``` Campaign 'VP Engineering Outreach': 320 prospects, 58% open rate, 11% reply rate, 2% bounce rate. Step 2 (follow-up) has the highest reply rate at 15%. 35 positive replies total. ``` **Prompt:** ``` Add 20 new prospects to my active campaign. ``` **Response:** ``` 20 prospects added to 'VP Engineering Outreach'. 19 accepted, 1 skipped (email already in blacklist). First emails will be sent based on your daily sending schedule. ``` **Prompt:** ``` Who replied to my campaigns this week? ``` **Response:** ``` 18 replies this week across 3 campaigns. 12 positive (67%), 4 not interested, 2 auto-replies. Notable: CTO at DataFlow requested a demo. ``` ## Capabilities ### Add Contacts Adds new potential leads to the system for outreach. ### Manage Campaign Status Turns email campaigns on or pauses them when needed. ### Check Prospect Data Retrieves specific information about individual leads and their engagement history. ### Retrieve Campaign Metrics Pulls detailed statistics like open rates, click rates, or reply counts for a campaign. ### List Available Campaigns Shows all current and past email campaigns you've set up in Woodpecker. ## Use Cases ### Mid-Campaign Course Correction You notice open rates dropped significantly for a key campaign. You ask your agent to 'get campaign stats' for that sequence, identify the drop, and then use `pause_campaign` while you update the messaging. ### Onboarding New Clients A new client account needs outreach. Instead of logging in, you ask your agent to 'add prospects' for all 50 key names and then use `get_campaign` on a template sequence to verify setup. ### Post-Meeting Follow-Up After a demo, you need to follow up with three specific contacts. You ask your agent to 'add prospects' for the names and then trigger the first step of an existing sequence using `get_campaign`. ### Auditing Leads You suspect some leads are stale or have bad emails. You ask your agent to run a check via 'list prospects' to filter out bounced contacts before the next wave of automation runs. ## Benefits - Instantly check campaign stats. Instead of navigating multiple dashboards, your agent calls `get_campaign_stats` to pull all open rates, click metrics, and bounce numbers for a quick performance review. - Maintain control over outreach flow. If a sequence needs a break or modification, the agent can use `pause_campaign` or `resume_campaign`, saving you time from manual status updates. - Build your list faster. Use `add_prospect` to feed new contacts into the system and then have your agent process them through an entire outreach workflow in minutes. - Keep data clean. The agent can use `list_prospects` to audit who bounced or opted out, ensuring you only send emails to active, qualified leads. - Consolidate visibility. By calling `list_campaigns`, your agent gives you a single view of every outreach sequence running for multiple clients. - Audit everything. Use the MCP's connection through Vinkius, which provides full visibility into what data flows and exactly which tools are called. ## How It Works The bottom line is, you tell your agent what needs doing, and it executes the necessary steps using Woodpecker's backend tools. 1. Subscribe to this Woodpecker MCP on the Vinkius Marketplace. 2. Generate an API key from your Woodpecker account and connect it via your AI client. 3. Tell your agent what you need: 'List all active campaigns' or 'Add these prospects to the outreach list'. ## Frequently Asked Questions **How do I get my Woodpecker API key?** Log in to your Woodpecker account at **app.woodpecker.co**. Navigate to **Settings** (gear icon). Click on **API keys** in the left menu. Click **Create new key**, give it a descriptive name, and copy the generated key. Paste it below. API access is available on all Woodpecker plans. **Can I automate multi-step follow-up sequences?** Yes. Woodpecker specializes in automated follow-up sequences. Your AI agent can create campaigns with up to 7 follow-up steps, each with customizable delays and personalization variables. **Does it protect my sender reputation?** Yes. Woodpecker includes built-in bounce detection, auto-blacklisting, and sending throttling. Your AI agent can monitor these safety metrics and alert you if deliverability drops below healthy thresholds. **Can I use it for agency clients?** Yes. Woodpecker offers an Agency plan with multi-client management. Each API key is scoped to your account, and you can manage campaigns for all clients from your AI agent. **When I use `add_prospect`, does the MCP check if an email address already exists in Woodpecker?** Yes, it prevents duplicate entries. The system checks for existing records before adding a new prospect, ensuring your list stays clean and avoiding redundant outreach. **How do I use `pause_campaign` if I need to temporarily stop an active sequence?** You just invoke the `pause_campaign` tool with the campaign ID. This immediately halts all sending without deleting the campaign or losing its current step progress. **What detailed information can I retrieve when calling `get_campaign_stats`?** You get a full breakdown of performance metrics, including open rates, click rates, and reply rates for specific follow-up steps. This helps you pinpoint exactly where your sequence needs adjustment. **If I need to verify my automated connections, how do I use `list_webhooks`?** The MCP lists all configured webhooks associated with your account. Reviewing this output lets you confirm which external services are receiving updates and if they're functioning as expected.