How do I install Kit.com MCP Server?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Kit.com MCP Server need an API key?

The publisher lists these environment variables: KIT_API_KEY, KIT_OAUTH_TOKEN.

What transport does Kit.com MCP Server use?

Kit.com MCP Server runs locally over stdio.

When was Kit.com MCP Server last checked?

Last checked 2026-11-09. Agent-optimized MCP server for Kit.com email marketing. 13 composite tools, 100% V4 API.

Kit.com MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y @dancumberland/[email protected]

Credentials from the publisher

KIT_API_KEY — Your Kit.com API key (find at kit.com → Account Settings → Developer)
KIT_OAUTH_TOKEN — OAuth token for bulk operations and purchases (optional)

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1KIT_API_KEY=<value> KIT_OAUTH_TOKEN=<value> claude mcp add io.github.dancumberland-kit-mcp -- npx -y @dancumberland/kit-mcp@1.0.1

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.dancumberland-kit-mcp": {4      "command": "npx",5      "args": [6        "-y",7        "@dancumberland/[email protected]"8      ],9      "env": {10        "KIT_API_KEY": "<value>",11        "KIT_OAUTH_TOKEN": "<value>"12      }13    }14  }15}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 1.0.1
API key

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

@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 <[email protected]> — Open: 82.3% | Click: 24.1% | Sent: 95 | Last open: 2026-03-15 (ID: 456)
  2. Bob <[email protected]> — 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.

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

Node.js 22+ — Download from nodejs.org. Check with node --version.
A Kit.com account — Free or paid, any plan.
Your Kit API key — kit.com → Account Settings → Developer. Starts with kit_.

Setup: Claude Desktop App (Recommended)

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

Open Settings (Cmd+,)
Search for "MCP"
Click "Add MCP Server"
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 [email protected]"	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 [email protected] 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

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Kit.com MCP Server?

Does Kit.com MCP Server need an API key?

What transport does Kit.com MCP Server use?

When was Kit.com MCP Server last checked?

Documentation

@dancumberland/kit-mcp

How This Is Different

Engagement Analytics (Exclusive)

What This Does

Prerequisites

Setup: Claude Desktop App (Recommended)

Step 1: Find your config file

Step 2: Add the Kit MCP server

Step 3: Restart Claude Desktop

Step 4: Verify it works

Setup: Claude Desktop with Cowork

Setup: Claude Code (CLI)

Setup: Cursor

Tools

Things You Can Ask

Authentication

Architecture: Why 13 Tools Instead of 29+

Error Handling

Troubleshooting

Development

License