Skip to main content
Glama

@dancumberland/kit-mcp

The most complete MCP server for Kit.com (formerly ConvertKit). 13 agent-optimized tools covering 100% of the Kit V4 API — including engagement analytics, bulk operations, and broadcast click tracking that no other Kit MCP offers.

How This Is Different

Other Kit MCP servers wrap each API endpoint as a separate tool (29+ tools). That approach breaks in practice:

@dancumberland/kit-mcp

Other Kit MCPs

Tool count

13 composite tools (45 actions)

29+ individual tools

Engagement analytics

Per-subscriber open/click rates, batch comparison across 100 subscribers, engagement-based filtering

None

Broadcast analytics

Per-broadcast stats, cross-broadcast comparison, per-link click tracking

Basic list/get only

Bulk operations

Batch create subscribers, tags, form subscriptions (up to 10k per call)

None

Response format

Formatted text summaries (agent-friendly)

Raw JSON (agent must parse)

Rate limiting

Sliding window with automatic retry + exponential backoff

None

Error recovery

Typed errors with actionable recovery hints

Generic errors

Cursor compatible

13 tools (well under 40-tool limit)

29+ tools (risks hitting limit)

Token overhead

~3,200 tokens for all tool definitions

~8,000+ tokens

Engagement Analytics (Exclusive)

This is the only Kit MCP that can answer "who are my most engaged subscribers?":

> Find my most engaged 100 subscribers who've been on my list over 6 months

Subscriber Comparison (100 of 100 loaded, sorted by open rate):

  1. Alice <alice@example.com> — Open: 82.3% | Click: 24.1% | Sent: 95 | Last open: 2026-03-15 (ID: 456)
  2. Bob <bob@example.com> — Open: 71.0% | Click: 18.5% | Sent: 102 | Last open: 2026-03-14 (ID: 789)
  ...

Other Kit MCPs can list subscribers and get basic profiles, but can't fetch engagement stats, compare across subscribers, or filter by engagement metrics.

Related MCP server: Mailchimp MCP Server

What This Does

Connects any MCP client (Claude Desktop, Claude Code, Cursor, Windsurf, etc.) to your Kit.com email marketing account. Ask questions naturally:

  • "How many subscribers do I have and how's my list growing?"

  • "Show me my broadcast stats from last week"

  • "Find my most engaged subscribers from the past 6 months"

  • "Tag everyone who signed up through my landing page"

  • "Create a draft broadcast for my newsletter"

  • "Which links got the most clicks in my last broadcast?"

No coding required — just set it up and start talking.

Prerequisites

  1. Node.js 22+ — Download from nodejs.org. Check with node --version.

  2. A Kit.com account — Free or paid, any plan.

  3. Your Kit API key — kit.com → Account Settings → Developer. Starts with kit_.

Step 1: Find your config file

Mac:

open ~/Library/Application\ Support/Claude/

Open claude_desktop_config.json in any text editor.

Windows:

%APPDATA%\Claude\claude_desktop_config.json

Step 2: Add the Kit MCP server

If the file is empty or doesn't exist, paste this (replace your-kit-api-key with your actual key):

{
  "mcpServers": {
    "kit": {
      "command": "npx",
      "args": ["-y", "@dancumberland/kit-mcp@latest"],
      "env": {
        "KIT_API_KEY": "your-kit-api-key"
      }
    }
  }
}

If you already have other MCP servers, add "kit" inside the existing "mcpServers" block with a comma after the previous entry.

Step 3: Restart Claude Desktop

Fully quit (not just close the window) and reopen.

Step 4: Verify it works

Test my Kit connection

Claude should respond with your account name, auth method, and rate limit.

Setup: Claude Desktop with Cowork

Cowork is Claude Desktop's background agent. After completing the setup above, Cowork automatically has access to your Kit tools.

Example tasks:

  • "Every morning at 8am, summarize my subscriber growth and email performance from the last 24 hours."

  • "Every Monday at 9am, compare my broadcast stats from the past week — open rates, click rates, and unsubscribes."

  • "Every Friday, list all tags with fewer than 10 subscribers (candidates for cleanup)."

Setup: Claude Code (CLI)

Add to .claude/settings.local.json or ~/.claude/settings.json:

{
  "mcpServers": {
    "kit": {
      "command": "npx",
      "args": ["-y", "@dancumberland/kit-mcp@latest"],
      "env": {
        "KIT_API_KEY": "your-kit-api-key"
      }
    }
  }
}

Setup: Cursor

  1. Open Settings (Cmd+,)

  2. Search for "MCP"

  3. Click "Add MCP Server"

  4. Add:

{
  "kit": {
    "command": "npx",
    "args": ["-y", "@dancumberland/kit-mcp@latest"],
    "env": {
      "KIT_API_KEY": "your-kit-api-key"
    }
  }
}

Tools

Tool

Actions

What You Can Do

manage_subscribers

10

Find, list, create, update, unsubscribe, view stats, compare engagement across up to 100 subscribers, find top engaged subscribers in one call, filter by status/tags, filter by engagement metrics

manage_tags

6

List, create, update, tag/untag subscribers, list tagged

manage_broadcasts

8

List, get, create drafts, update, delete, view stats, compare stats across broadcasts, analyze per-link click data

manage_forms

3

List forms, list subscribers, add subscriber

manage_sequences

3

List sequences, add subscriber, list subscribers

manage_custom_fields

4

List, create, update, delete

manage_purchases

3

List, get, create (OAuth required)

manage_segments

1

List segments

manage_webhooks

3

List, create, delete

manage_email_templates

1

List templates

get_account

—

Full account overview with email and growth stats

test_connection

—

Verify your API key works

bulk_operations

7

Batch subscriber/tag/form/field operations (OAuth required)

Things You Can Ask

What You Say

What Happens

"How's my email list doing?"

Account stats, subscriber count, growth trends

"Find dan@example.com"

Subscriber profile with tags, custom fields, engagement stats

"Who are my most engaged subscribers?"

Engagement-filtered list ranked by open/click rates

"Show me my recent broadcasts"

Broadcasts with status (draft/scheduled/sent)

"How did my last broadcast perform?"

Open rate, click rate, unsubscribes, per-link click data

"Which links got the most clicks?"

Per-link click analytics for any broadcast

"Compare my broadcast performance"

Side-by-side stats across all broadcasts

"Create a tag called vip-customers"

Creates the tag in Kit

"Tag dan@example.com with vip-customers"

Applies the tag

"Draft a broadcast with subject 'Big News'"

Creates a draft (doesn't send)

Authentication

API Key (covers most features): Get at kit.com → Developer. Set as KIT_API_KEY.

OAuth Token (optional, for purchases and bulk operations): Set KIT_OAUTH_TOKEN alongside your API key.

{
  "env": {
    "KIT_API_KEY": "your-api-key",
    "KIT_OAUTH_TOKEN": "your-oauth-token"
  }
}

Rate limits enforced automatically: 120 req/min (API key) or 600 req/min (OAuth), with retry + backoff on 429s.

Architecture: Why 13 Tools Instead of 29+

Most MCP servers create one tool per API endpoint. For Kit's API, that means 29+ tools — which causes real problems:

  • Context bloat — 8,000+ tokens just for tool definitions, leaving less room for your actual conversation

  • Poor accuracy — AI tool selection degrades measurably beyond 20 tools (research)

  • Compatibility — Cursor has a hard limit of 40 tools across all servers; 29 tools from one server leaves almost no room for others

This server uses 13 composite tools with a discriminated action parameter. Same API coverage, 60% fewer tokens, better accuracy. Each tool groups related operations (e.g., all subscriber actions under manage_subscribers) so the AI picks the right tool on the first try.

Error Handling

Errors include recovery hints that Claude can act on:

Error 401: Invalid API key
Recovery: Check your KIT_API_KEY. Find your key at kit.com → Account Settings → Developer.
  • 429 (rate limit): Automatic retry with exponential backoff, up to 3 attempts

  • 5xx (server error): Automatic retry once

  • 422 (validation): No retry — returns the error immediately with a fix suggestion

Troubleshooting

Problem

Solution

"Cannot find module" or npx errors

Make sure Node.js 22+ is installed: node --version

"Invalid API key"

Double-check your key at kit.com → Developer

Tools don't appear in Claude

Fully quit and restart Claude Desktop (not just close the window)

"requires OAuth authentication"

manage_purchases and bulk_operations need KIT_OAUTH_TOKEN

Rate limit errors

Automatic — the server retries with backoff. If persistent, wait 60 seconds

Development

npm install
npm run dev          # Watch mode
npm run build        # Production build
npm test             # Unit tests (179 tests)
npm run test:int     # Integration tests (requires KIT_API_KEY)
npm run lint         # Biome check
npm run typecheck    # TypeScript check

License

MIT

Available Tools

13 tools
bulk_operationsA

Batch operations for large-scale subscriber management. Requires OAuth authentication. Actions: create_subscribers, create_tags, tag_subscribers, untag_subscribers, add_to_forms, create_custom_fields, update_custom_fields

Inputs: no named parameters.

get_accountB

Get a comprehensive overview of your Kit account including creator profile, email stats, and subscriber growth.

Inputs: no named parameters.

manage_broadcastsC

Manage Kit email broadcasts — list with status filter, get details, create drafts or scheduled sends, update, delete, view performance stats, compare stats across all broadcasts, or analyze per-link click data. Actions: list, get, create, update, delete, stats, list_stats, get_clicks

Inputs: no named parameters.

manage_custom_fieldsB

Manage Kit custom subscriber fields — list all fields, create, rename, or delete (destructive). Actions: list, create, update, delete

Inputs: no named parameters.

manage_email_templatesA

List Kit email templates — returns template IDs and names needed for creating broadcasts. Actions: list

Inputs: no named parameters.

manage_formsB

Manage Kit forms — list all forms, list subscribers who opted in through a form, or add a subscriber to a form (triggers double opt-in if enabled). Actions: list, list_subscribers, add_subscriber

Inputs: no named parameters.

manage_purchasesC

Manage Kit purchases — list, get details, or record a new purchase. Requires OAuth authentication. Actions: list, get, create

Inputs: no named parameters.

manage_segmentsA

List Kit subscriber segments (read-only — segments are created in the Kit UI). Actions: list

Inputs: no named parameters.

manage_sequencesB

Manage Kit email sequences — list all sequences, enroll a subscriber, or list subscribers in a sequence. Actions: list, add_subscriber, list_subscribers

Inputs: no named parameters.

manage_subscribersA

Manage Kit subscribers. To find most engaged subscribers, use 'top_engaged' — returns subscribers ranked by open rate in one call. For individual stats use 'stats'. 'list' and 'filter' return profiles only, NOT engagement data. Actions: find, list, create, update, unsubscribe, stats, compare_stats, top_engaged, filter, engagement_filter

Inputs: no named parameters.

manage_tagsA

Manage Kit tags — list all tags, create, rename, apply/remove tags on subscribers, or list subscribers with a specific tag. Actions: list, create, update, tag_subscriber, untag_subscriber, list_subscribers

Inputs: no named parameters.

manage_webhooksB

Manage Kit webhooks — list registered webhooks, create new webhook subscriptions for Kit events, or delete webhooks. Actions: list, create, delete

Inputs: no named parameters.

test_connectionA

Verify your Kit API key is valid and check connection status. Use this as the first tool call to confirm setup.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 13 tools

    Disambiguation5/5

    Every tool has a clearly distinct purpose targeting specific Kit resources like subscribers, broadcasts, tags, or webhooks, with no overlap in functionality. The descriptions explicitly differentiate actions, such as manage_subscribers for profiles vs. bulk_operations for batch tasks, preventing agent misselection.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern (e.g., manage_subscribers, get_account, test_connection), with no deviations in style or casing. This predictability makes the tool set easy to navigate and understand at a glance.

    Tool Count5/5

    With 13 tools, the server is well-scoped for comprehensive Kit platform management, covering account info, subscribers, broadcasts, tags, forms, and more. Each tool earns its place by addressing distinct aspects of the domain without being overly broad or sparse.

    Completeness5/5

    The tool set provides complete CRUD/lifecycle coverage for Kit's domain, including creation, retrieval, updating, deletion, and analytics across all key resources like subscribers, broadcasts, tags, and webhooks. There are no obvious gaps, ensuring agents can handle end-to-end workflows without dead ends.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    • Connect AI agents to Emitd email sending, message tracking, templates, and automations. Emitd hosts a Model Context Protocol server for integrating supported email operations into AI-agent workflows. Connect a compatible client to the hosted endpoint (https://mcp.emitd.com/mcp) and authenticate with an Emitd API key. Available tools depend on the key's permissions and enabled features. Emitd's capability areas include sending email, message activity, templates, contacts, audiences, segments, domains, analytics, inbound email, broadcasts, automations, webhooks, and suppressions. Use restricted keys, sending guardrails, and approval settings appropriate to each workflow. For more information check https://emitd.com

      https://mcp.emitd.com/mcp
    • AgentiSend is a transactional email API: send through verified domains with a message log, budgets, a preflight and refusals that name the fix; built so AI agents can send on your behalf. The hosted MCP server at https://api.agentisend.com/mcp exposes 82 tools (44 on tools/list; the rest via list_more_tools). A send is one message or a batch of up to 500 items with per-item results. preflight_email runs every gate a real send runs, sends nothing, and costs nothing. Every 4xx returns code, message, and fix. There is no tool for unsolicited mail. Auth is a bearer API key or OAuth 2.1 with dynamic client registration. Starter prompts: "Send this receipt to the customer." "Preflight this send and tell me what would stop it." "What can I spend today?"

      https://api.agentisend.com/mcp
    • MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows

      https://mcp.flowra.dev/mcp
    • Agent-first social media publishing, scheduling, analytics, and unified inbox API + 16-tool MCP server across 18 social platforms (X, LinkedIn, Instagram, YouTube, TikTok, Threads, Bluesky, Reddit, Telegram, Discord, Mastodon, Facebook, Pinterest).

      https://mcp.nuntior.com/mcp

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      An MCP server that interfaces with the Mailchimp Marketing API to manage audiences, email campaigns, and subscribers. It enables users to create and schedule campaigns, handle member lists, and send test or live emails through natural language commands.
      13
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      A production-grade MCP server that integrates with the Mailchimp Marketing API to manage campaigns, audiences, members, and reports. It provides 28 specialized tools for automating marketing tasks such as sending emails, managing subscriber tags, and analyzing performance data.
      71
      1
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      An MCP server for the PostStack email API that enables AI assistants to send transactional emails, manage contacts, handle inbound email threads, and perform deliverability checks through 84 curated tools.
      84
      18 npm
      1
      MIT
    • A
      license
      B
      quality
      F
      maintenance
      Connects AI assistants to the Kit.com (formerly ConvertKit) email marketing platform, enabling management of subscribers, tags, sequences, broadcasts, and more through natural language.
      29
      51 npm
      4
      MIT