Mailerlite Automation

---
name: MailerLite Automation
description: "Automate email marketing workflows including subscriber management, campaign analytics, group segmentation, and account monitoring through MailerLite via Composio"
requires:
  mcp:
    - rube
executor: HYBRID
skill_id: integrations.composio.mailerlite-automation
status: ADOPTED
security: {level: standard, pii: true, approval_required: false}
extends: integrations.composio.meta
toolkit: mailerlite-automation
# Phase3: This stub routes to the meta-skill. See skills/integrations/composio/SKILL.md for full protocol.
anchors:
  - automation
  - integration
  - api
  - workflow
tier: 3
input_schema:
  - name: code_or_task
    type: string
    description: "Code snippet, script, or task description to process"
    required: true
output_schema:
  - name: result
    type: object
    description: "Result from the automated action"
  - name: status
    type: string
    description: "Execution status: success | partial | failure"
what_if_fails: >
  FALLBACK: If Mailerlite cannot complete, provide partial results with
  explicit gaps noted. Never block workflow silently.
  ESCALATE: If core capability is unavailable, suggest nearest alternative skill.
  RULE: Always explain what failed and what manual steps can substitute.
---

# MailerLite Automation

Automate email marketing operations -- manage subscribers, analyze campaign performance, organize groups and segments, and monitor account health -- all orchestrated through the Composio MCP integration.

**Toolkit docs:** [composio.dev/toolkits/mailerlite](https://composio.dev/toolkits/mailerlite)

---

## Setup

1. Connect your MailerLite account through the Composio MCP server at `https://rube.app/mcp`
2. The agent will prompt you with an authentication link if no active connection exists
3. Once connected, all `MAILERLITE_*` tools become available for execution

---

## Core Workflows

### 1. Verify Account & Fetch Metadata
Retrieve account details including plan limits and timezone to ensure consistent reporting.

**Tool:** `MAILERLITE_GET_ACCOUNT_INFO`

```
No parameters required -- returns account metadata, plan details, and timezone configuration.
```

Always run this first to establish plan constraints and timezone for consistent time-windowed queries.

---

### 2. Get Account-Wide Performance Stats
Retrieve aggregate subscriber counts, sent email totals, and engagement metrics for a health snapshot.

**Tool:** `MAILERLITE_GET_ACCOUNT_STATS`

```
No parameters required -- returns overall subscriber counts, sent emails, and performance metrics.
```

---

### 3. List & Paginate Subscribers
Retrieve subscribers with optional status filtering and cursor-based pagination.

**Tool:** `MAILERLITE_GET_SUBSCRIBERS`

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `filter[status]` | string | No | Filter by: `active`, `unsubscribed`, `unconfirmed`, `bounced`, `junk` |
| `limit` | integer | No | Subscribers per page (default: 25) |
| `cursor` | string | No | Pagination cursor from previous response `meta.cursor` |
| `include` | string | No | Set to `groups` to include group memberships |

**Important:** Loop with `meta.next_cursor` until `null` to build a complete subscriber list.

---

### 4. List & Analyze Campaigns
Retrieve campaigns with optional status/type filters and page-based pagination.

**Tool:** `MAILERLITE_GET_CAMPAIGNS`

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `filter[status]` | string | No | Filter by: `sent`, `draft`, `ready` |
| `filter[type]` | string | No | Filter by: `regular`, `ab`, `resend`, `rss` |
| `limit` | integer | No | Items per page (default: 25) |
| `page` | integer | No | Page number (default: 1) |

**Important:** Paginate using `meta.last_page` to avoid omitting campaigns from historical analysis.

---

### 5. Manage Subscriber Groups
List, filter, and sort subscriber groups for audience organization.

**Tool:** `MAILERLITE_GET_GROUPS`

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `filter[name]` | string | No | Partial name match filter |
| `limit` | integer | No | Max groups to return |
| `page` | integer | No | Page number (starting from 1) |
| `sort` | string | No | Sort by: `name`, `total`, `open_rate`, `click_rate`, `created_at` (prefix `-` for descending) |

---

### 6. Retrieve Audience Segments & Custom Fields
Fetch segments and custom field definitions for advanced audience analysis.

**Tools:** `MAILERLITE_GET_SEGMENTS` and `MAILERLITE_GET_FIELDS`

**Segments:**

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Max segments to return (max 250) |
| `page` | integer | No | Page number (starting from 1) |

**Fields:** No parameters required -- returns all custom field definitions.

---

## Known Pitfalls

| Pitfall | Details |
|---------|---------|
| **Subscriber pagination is cursor-based** | `MAILERLITE_GET_SUBSCRIBERS` uses `meta.next_cursor` -- you must loop until `null` or counts will be incomplete |
| **Campaign pagination is page-based** | `MAILERLITE_GET_CAMPAIGNS` uses `page`/`limit` with `meta.last_page` -- stopping early omits campaigns and distorts trends |
| **Sampling bias** | Computing engagement metrics from only the first page introduces bias; always aggregate across all pages |
| **Nested response shape** | MailerLite payloads are nested under `results[i].response.data` with `data` and `meta` subkeys, not a flat `data` key -- parse accordingly |
| **API quotas** | Subscriber listing is limited by MailerLite Connect API quotas -- plan batch operations accordingly |

---

## Quick Reference

| Tool Slug | Purpose |
|-----------|---------|
| `MAILERLITE_GET_ACCOUNT_INFO` | Verify auth and review account metadata |
| `MAILERLITE_GET_ACCOUNT_STATS` | Get aggregate performance metrics |
| `MAILERLITE_GET_SUBSCRIBERS` | List subscribers with filtering and pagination |
| `MAILERLITE_GET_CAMPAIGNS` | List campaigns with status/type filters |
| `MAILERLITE_GET_GROUPS` | List and sort subscriber groups |
| `MAILERLITE_GET_SEGMENTS` | List audience segments |
| `MAILERLITE_GET_FIELDS` | Retrieve custom field definitions |

---

*Powered by [Composio](https://composio.dev)*

## Why This Skill Exists
Stub for the `mailerlite-automation` toolkit in the Composio integration ecosystem.
Extends `integrations.composio.meta` — see the meta-skill for full protocol.

## When to Use
Use when automating `mailerlite-automation` tasks via Rube MCP (Composio).
For generic Composio queries, use `integrations.composio.meta` directly.

## What If Fails
See `skills/integrations/composio/SKILL.md` (meta-skill) for full fallback protocol.
RULE: Never block workflow — always suggest manual alternative if automation fails.