Convertkit Automation

# ConvertKit (Kit) Automation via Rube MCP

Automate ConvertKit (now known as Kit) email marketing operations through Composio's Kit toolkit via Rube MCP.

Prerequisites

- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)

- Active Kit connection via `RUBE_MANAGE_CONNECTIONS` with toolkit `kit`

- Always call `RUBE_SEARCH_TOOLS` first to get current tool schemas

Setup

**Get Rube MCP**: Add `https://rube.app/mcp` as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.

1. Verify Rube MCP is available by confirming `RUBE_SEARCH_TOOLS` responds

2. Call `RUBE_MANAGE_CONNECTIONS` with toolkit `kit`

3. If connection is not ACTIVE, follow the returned auth link to complete Kit authentication

4. Confirm connection status shows ACTIVE before running any workflows

Core Workflows

1. List and Search Subscribers

**When to use**: User wants to browse, search, or filter email subscribers

**Tool sequence**:

1. `KIT_LIST_SUBSCRIBERS` - List subscribers with filters and pagination [Required]

**Key parameters**:

- `status`: Filter by status ('active' or 'inactive')

- `email_address`: Exact email to search for

- `created_after`/`created_before`: Date range filter (YYYY-MM-DD)

- `updated_after`/`updated_before`: Date range filter (YYYY-MM-DD)

- `sort_field`: Sort by 'id', 'cancelled_at', or 'updated_at'

- `sort_order`: 'asc' or 'desc'

- `per_page`: Results per page (min 1)

- `after`/`before`: Cursor strings for pagination

- `include_total_count`: Set to 'true' to get total subscriber count

**Pitfalls**:

- If `sort_field` is 'cancelled_at', the `status` must be set to 'cancelled'

- Date filters use YYYY-MM-DD format (no time component)

- `email_address` is an exact match; partial email search is not supported

- Pagination uses cursor-based approach with `after`/`before` cursor strings

- `include_total_count` is a string 'true', not a boolean

2. Manage Subscriber Tags

**When to use**: User wants to tag subscribers for segmentation

**Tool sequence**:

1. `KIT_LIST_SUBSCRIBERS` - Find subscriber ID by email [Prerequisite]

2. `KIT_TAG_SUBSCRIBER` - Associate a subscriber with a tag [Required]

3. `KIT_LIST_TAG_SUBSCRIBERS` - List subscribers for a specific tag [Optional]

**Key parameters for tagging**:

- `tag_id`: Numeric tag ID (required)

- `subscriber_id`: Numeric subscriber ID (required)

**Pitfalls**:

- Both `tag_id` and `subscriber_id` must be positive integers

- Tag IDs must reference existing tags; tags are created via the Kit web UI

- Tagging an already-tagged subscriber is idempotent (no error)

- Subscriber IDs are returned from LIST_SUBSCRIBERS; use `email_address` filter to find specific subscribers

3. Unsubscribe a Subscriber

**When to use**: User wants to unsubscribe a subscriber from all communications

**Tool sequence**:

1. `KIT_LIST_SUBSCRIBERS` - Find subscriber ID [Prerequisite]

2. `KIT_DELETE_SUBSCRIBER` - Unsubscribe the subscriber [Required]

**Key parameters**:

- `id`: Subscriber ID (required, positive integer)

**Pitfalls**:

- This permanently unsubscribes the subscriber from ALL email communications

- The subscriber's historical data is retained but they will no longer receive emails

- Operation is idempotent; unsubscribing an already-unsubscribed subscriber succeeds without error

- Returns empty response (HTTP 204 No Content) on success

- Subscriber ID must exist; non-existent IDs return 404

4. List and View Broadcasts

**When to use**: User wants to browse email broadcasts or get details of a specific one

**Tool sequence**:

1. `KIT_LIST_BROADCASTS` - List all broadcasts with pagination [Required]

2. `KIT_GET_BROADCAST` - Get detailed information for a specific broadcast [Optional]

3. `KIT_GET_BROADCAST_STATS` - Get performance statistics for a broadcast [Optional]

**Key parameters for listing**:

- `per_page`: Results per page (1-500)

- `after`/`before`: Cursor strings for pagination

- `include_total_count`: Set to 'true' for total co