# Woodpecker Co — how to use (mcp.ai)

Connect your Woodpecker Co account and use 8 tools for drip emails straight from your AI agent. Connect with your own API key. Woodpecker.co is a cold email tool that automates personalized email outreach and follow-ups for sales teams and agencies.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_woodpecker_co?ms=1787291400000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `woodpecker_co_add_prospects_to_campaign_v1`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/woodpecker_co`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/woodpecker_co/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/woodpecker_co/add/prospects/to/campaign/v1` — Tool to add one or multiple prospects to a campaign. Use when you need to import prospects into a campaign's contact list.
  - body: { force?: boolean, campaign: object, file_name?: string, prospects: object[] }
- `POST https://api.mcp.ai/api/woodpecker_co/delete/campaign/step` — Tool to delete a non-initial campaign step that hasn't processed any prospects. Use when the campaign is in DRAFT or EDITED status and the step is unused.
  - body: { step_id: string, campaign_id: integer }
- `POST https://api.mcp.ai/api/woodpecker_co/get/prospects/in/campaigns/v1` — Tool to retrieve prospects enrolled in specified campaigns. Use when you need to list prospects for given campaign IDs.
  - body: { id?: integer[], diff?: string, page?: integer, sort?: string, status?: string, activity?: string, per_page?: integer, contacted?: boolean, interested?: string, campaigns_id: integer[] }
- `POST https://api.mcp.ai/api/woodpecker_co/list/available/webhook/events` — Tool to list all webhook event names supported by Woodpecker. Use before subscribing to ensure valid 'event' values (static catalog from docs).
- `POST https://api.mcp.ai/api/woodpecker_co/list/campaigns/v1` — Tool to list campaigns. Use when you need to fetch campaigns with optional status or ID filters.
  - body: { id?: integer[], status?: string[], company_id?: integer }
- `POST https://api.mcp.ai/api/woodpecker_co/pause/campaign` — Tool to pause a campaign. Use when you need to temporarily stop sending prospects until resumed.
  - body: { campaign_id: integer }
- `POST https://api.mcp.ai/api/woodpecker_co/run/campaign` — Tool to run a campaign and set its status to RUNNING. Use when you want to activate a configured campaign after final review.
  - body: { campaign_id: integer }
- `POST https://api.mcp.ai/api/woodpecker_co/stop/campaign` — Tool to stop a campaign. Use when you need to halt prospect contacts by setting campaign status to STOPPED.
  - body: { campaign_id: string }

## Example prompts
- "What can I do in Woodpecker Co?"
- "Show me a summary of my Woodpecker Co account"

## More
- Page: https://mcp.ai/woodpecker_co
- Agent spec (llms.txt): https://mcp.ai/woodpecker_co/llms.txt
- Postman collection: https://mcp.ai/woodpecker_co/postman.json