{"_id":"@dancumberland/kit-mcp","_rev":"6-08c7258708bc1e9ec17a148b3ead975f","name":"@dancumberland/kit-mcp","dist-tags":{"latest":"1.4.0"},"versions":{"0.1.0":{"name":"@dancumberland/kit-mcp","version":"0.1.0","keywords":["mcp","kit","convertkit","email-marketing","ai-agent","model-context-protocol"],"author":{"name":"Dan Cumberland"},"license":"MIT","_id":"@dancumberland/kit-mcp@0.1.0","maintainers":[{"name":"dancumberland","email":"dc@dancumberlandlabs.com"}],"homepage":"https://github.com/dancumberland/kit-mcp#readme","bugs":{"url":"https://github.com/dancumberland/kit-mcp/issues"},"bin":{"kit-mcp":"dist/index.js"},"dist":{"shasum":"fd33cc05b9444eaddbe4bc28fa0457381e5efbd6","tarball":"https://registry.npmjs.org/@dancumberland/kit-mcp/-/kit-mcp-0.1.0.tgz","fileCount":6,"integrity":"sha512-h63NJVBcomaKUuWt8CsMmmtZ1RsojZ+soMdWUKUt0Y6Kg+FYGtdc2Nkl+R2Jtfq8+ahndVnLFrOFwVyX7dJnvA==","signatures":[{"sig":"MEUCIQDpteah6pdifmZUy1tgka45QEhSVOmxEWTre+nTxKOw+wIgDdbSfwKLbjHqmGUKa8tSm2lf7Qp8V5VI4q34/mcd8w4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":42424},"type":"module","engines":{"node":">=22"},"gitHead":"a4237d177c18f8b8648af73a583b5c8c4ac81048","scripts":{"dev":"tsup --watch","lint":"biome check .","test":"vitest run","build":"tsup","lint:fix":"biome check --fix .","test:int":"vitest run tests/integration","typecheck":"tsc --noEmit","test:watch":"vitest","prepublishOnly":"npm run build"},"_npmUser":{"name":"dancumberland","email":"dc@dancumberlandlabs.com"},"repository":{"url":"git+https://github.com/dancumberland/kit-mcp.git","type":"git"},"_npmVersion":"11.6.2","description":"Agent-optimized MCP server for Kit.com email marketing. 13 composite tools covering 100% of the Kit V4 API.","directories":{},"_nodeVersion":"25.2.1","dependencies":{"zod":"^3.23.0","@modelcontextprotocol/sdk":"^1.25.0"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.3.0","vitest":"^2.1.0","typescript":"^5.6.0","@types/node":"^25.5.0","@biomejs/biome":"^1.9.0"},"_npmOperationalInternal":{"tmp":"tmp/kit-mcp_0.1.0_1773623079430_0.4653686714261642","host":"s3://npm-registry-packages-npm-production"}},"1.0.0":{"name":"@dancumberland/kit-mcp","version":"1.0.0","keywords":["mcp","kit","convertkit","email-marketing","ai-agent","model-context-protocol"],"author":{"name":"Dan Cumberland"},"license":"MIT","_id":"@dancumberland/kit-mcp@1.0.0","maintainers":[{"name":"dancumberland","email":"dc@dancumberlandlabs.com"}],"homepage":"https://github.com/dancumberland/kit-mcp#readme","bugs":{"url":"https://github.com/dancumberland/kit-mcp/issues"},"bin":{"kit-mcp":"dist/index.js"},"dist":{"shasum":"26eae48a9c52fe225b3c09037dd1082b530170b5","tarball":"https://registry.npmjs.org/@dancumberland/kit-mcp/-/kit-mcp-1.0.0.tgz","fileCount":6,"integrity":"sha512-vj776Akxg9zq0nYqpG8vvb2wo5jYOrz1zW/HOlyUyaWvKzijPDr0kRIELttlzpA6M27YnW9xxrZS6Fe/UrUWfw==","signatures":[{"sig":"MEUCIEKkXyvYiOfpAmpcqWGeAeeoIqBTflvveeEl6L6py6JTAiEAqvp1ioI5zV/B1ibPsb5WiWUUuLyJtNkpjbKpdTUhk70=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":200276},"type":"module","engines":{"node":">=22"},"gitHead":"df3d4c2d0a75b18dd5909fa5f1b4c51b111f4d47","scripts":{"dev":"tsup --watch","lint":"biome check .","test":"vitest run --exclude 'tests/integration/**'","build":"tsup","lint:fix":"biome check --fix .","test:int":"vitest run tests/integration","typecheck":"tsc --noEmit","test:watch":"vitest --exclude 'tests/integration/**'","prepublishOnly":"npm run build"},"_npmUser":{"name":"dancumberland","email":"dc@dancumberlandlabs.com"},"repository":{"url":"git+https://github.com/dancumberland/kit-mcp.git","type":"git"},"_npmVersion":"11.6.2","description":"Agent-optimized MCP server for Kit.com email marketing. 13 composite tools covering 100% of the Kit V4 API.","directories":{},"_nodeVersion":"25.2.1","dependencies":{"zod":"^3.23.0","@modelcontextprotocol/sdk":"^1.25.0"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.3.0","vitest":"^2.1.0","typescript":"^5.6.0","@types/node":"^25.5.0","@biomejs/biome":"^1.9.0"},"_npmOperationalInternal":{"tmp":"tmp/kit-mcp_1.0.0_1773630604508_0.30334614426978024","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@dancumberland/kit-mcp","version":"1.0.1","keywords":["mcp","kit","convertkit","email-marketing","ai-agent","model-context-protocol"],"author":{"name":"Dan Cumberland"},"license":"MIT","_id":"@dancumberland/kit-mcp@1.0.1","maintainers":[{"name":"dancumberland","email":"dc@dancumberlandlabs.com"}],"homepage":"https://github.com/dancumberland/kit-mcp#readme","bugs":{"url":"https://github.com/dancumberland/kit-mcp/issues"},"bin":{"kit-mcp":"dist/index.js"},"dist":{"shasum":"a9fd0788e085a3b6629b40415dc852fa5d901e9f","tarball":"https://registry.npmjs.org/@dancumberland/kit-mcp/-/kit-mcp-1.0.1.tgz","fileCount":6,"integrity":"sha512-uMaHjBbPZSBoZERxbfp+XME92xqVjtrLoP35kwOVEdNtpqSbERFu4WeCDan5e6DJ5Cvk+biByyLuONsslJKl6Q==","signatures":[{"sig":"MEQCIGoVxA7K8asKYeUuHp8ZXY3RFYQcnlwnswORBLVY1eXaAiA894FjeMqh/a6F0Cgbd1SSdvv8rwKdQYv/+c6DpsMgMQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":200324},"type":"module","engines":{"node":">=22"},"gitHead":"df3d4c2d0a75b18dd5909fa5f1b4c51b111f4d47","mcpName":"io.github.dancumberland/kit-mcp","scripts":{"dev":"tsup --watch","lint":"biome check .","test":"vitest run --exclude 'tests/integration/**'","build":"tsup","lint:fix":"biome check --fix .","test:int":"vitest run tests/integration","typecheck":"tsc --noEmit","test:watch":"vitest --exclude 'tests/integration/**'","prepublishOnly":"npm run build"},"_npmUser":{"name":"dancumberland","email":"dc@dancumberlandlabs.com"},"repository":{"url":"git+https://github.com/dancumberland/kit-mcp.git","type":"git"},"_npmVersion":"11.6.2","description":"Agent-optimized MCP server for Kit.com email marketing. 13 composite tools covering 100% of the Kit V4 API.","directories":{},"_nodeVersion":"25.2.1","dependencies":{"zod":"^3.23.0","@modelcontextprotocol/sdk":"^1.25.0"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.3.0","vitest":"^2.1.0","typescript":"^5.6.0","@types/node":"^25.5.0","@biomejs/biome":"^1.9.0"},"_npmOperationalInternal":{"tmp":"tmp/kit-mcp_1.0.1_1773630715618_0.14079041455405972","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@dancumberland/kit-mcp","version":"1.0.2","keywords":["mcp","kit","convertkit","email-marketing","ai-agent","model-context-protocol"],"author":{"name":"Dan Cumberland"},"license":"MIT","_id":"@dancumberland/kit-mcp@1.0.2","maintainers":[{"name":"dancumberland","email":"dc@dancumberlandlabs.com"}],"homepage":"https://github.com/dancumberland/kit-mcp#readme","bugs":{"url":"https://github.com/dancumberland/kit-mcp/issues"},"bin":{"kit-mcp":"dist/index.js"},"dist":{"shasum":"3bef3fb471f0671fc7148744aa3d2c3683f2a922","tarball":"https://registry.npmjs.org/@dancumberland/kit-mcp/-/kit-mcp-1.0.2.tgz","fileCount":6,"integrity":"sha512-t4BcqYgHum/yAKFetGFZfm2yuDj58GOOR6U1HrSO7eK7lYtqbNPydw7CpyGi7kOA5lYxhkp9bg1rNs36m4Cn9A==","signatures":[{"sig":"MEUCIQD0Z/eLPxxYCCD1nfZ+2HOD8u01BVu+sQQrfhgnOSEdJgIgGxq2IU4JUVulz5ABYiFf3OpJ/hs4OZuvdF1X9U7oZgE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":204725},"type":"module","engines":{"node":">=22"},"gitHead":"640814c19d2674f77d19a960831d1def2be08c13","mcpName":"io.github.dancumberland/kit-mcp","scripts":{"dev":"tsup --watch","lint":"biome check .","test":"vitest run --exclude 'tests/integration/**'","build":"tsup","lint:fix":"biome check --fix .","test:int":"vitest run tests/integration","typecheck":"tsc --noEmit","test:watch":"vitest --exclude 'tests/integration/**'","prepublishOnly":"npm run build"},"_npmUser":{"name":"dancumberland","email":"dc@dancumberlandlabs.com"},"repository":{"url":"git+https://github.com/dancumberland/kit-mcp.git","type":"git"},"_npmVersion":"11.6.2","description":"Agent-optimized MCP server for Kit.com email marketing. 13 composite tools covering 100% of the Kit V4 API.","directories":{},"_nodeVersion":"25.2.1","dependencies":{"zod":"^3.23.0","@modelcontextprotocol/sdk":"^1.25.0"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.3.0","vitest":"^2.1.0","typescript":"^5.6.0","@types/node":"^25.5.0","@biomejs/biome":"^1.9.0"},"_npmOperationalInternal":{"tmp":"tmp/kit-mcp_1.0.2_1773664805371_0.057676101113552924","host":"s3://npm-registry-packages-npm-production"}},"1.3.1":{"name":"@dancumberland/kit-mcp","version":"1.3.1","keywords":["mcp","kit","convertkit","email-marketing","ai-agent","model-context-protocol"],"author":{"name":"Dan Cumberland"},"license":"MIT","_id":"@dancumberland/kit-mcp@1.3.1","maintainers":[{"name":"dancumberland","email":"dc@dancumberlandlabs.com"}],"homepage":"https://github.com/dancumberland/kit-mcp#readme","bugs":{"url":"https://github.com/dancumberland/kit-mcp/issues"},"bin":{"kit-mcp":"dist/index.js"},"dist":{"shasum":"8332afa99597e80d955ec60cd9cf9a5037e6a594","tarball":"https://registry.npmjs.org/@dancumberland/kit-mcp/-/kit-mcp-1.3.1.tgz","fileCount":6,"integrity":"sha512-Bg8Hd6fsPqE5j0rcCqcCL8GVNgMB5eATiKUBUo3zsZ63qh8mHhSitTRQ/xoVxCXS3HhBDZFRcTdmBf7ckWGfsg==","signatures":[{"sig":"MEUCIA2oTW5wj8M1RbFN1GhaweByDLeTf6oJTGs1LJeSwdU/AiEAizUa/0RgbZOcrvS4ci9cMONxkJjksgwsEtLieu7JV7U=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":231430},"type":"module","engines":{"node":">=22"},"gitHead":"043ce073c2daae4d91ae89d8b65ce3ad5eb7f9df","mcpName":"io.github.dancumberland/kit-mcp","scripts":{"dev":"tsup --watch","lint":"biome check .","test":"vitest run --exclude 'tests/integration/**'","build":"tsup","lint:fix":"biome check --fix .","test:int":"vitest run tests/integration","typecheck":"tsc --noEmit","test:watch":"vitest --exclude 'tests/integration/**'","prepublishOnly":"npm run build"},"_npmUser":{"name":"dancumberland","email":"dc@dancumberlandlabs.com"},"repository":{"url":"git+https://github.com/dancumberland/kit-mcp.git","type":"git"},"_npmVersion":"11.6.2","description":"Agent-optimized MCP server for Kit.com email marketing. 13 composite tools covering 100% of the Kit V4 API.","directories":{},"_nodeVersion":"25.2.1","dependencies":{"zod":"^3.23.0","@modelcontextprotocol/sdk":"^1.25.0"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.3.0","vitest":"^2.1.0","typescript":"^5.6.0","@types/node":"^25.5.0","@biomejs/biome":"^1.9.0"},"_npmOperationalInternal":{"tmp":"tmp/kit-mcp_1.3.1_1773756277499_0.867465292991596","host":"s3://npm-registry-packages-npm-production"}},"1.4.0":{"name":"@dancumberland/kit-mcp","version":"1.4.0","mcpName":"io.github.dancumberland/kit-mcp","description":"Agent-optimized MCP server for Kit.com email marketing. 13 composite tools covering 100% of the Kit V4 API.","type":"module","bin":{"kit-mcp":"dist/index.js"},"engines":{"node":">=22"},"scripts":{"dev":"tsup --watch","build":"tsup","test":"vitest run --exclude 'tests/integration/**'","test:watch":"vitest --exclude 'tests/integration/**'","test:int":"vitest run tests/integration","lint":"biome check .","lint:fix":"biome check --fix .","typecheck":"tsc --noEmit","prepublishOnly":"npm run build"},"keywords":["mcp","kit","convertkit","email-marketing","ai-agent","model-context-protocol"],"author":{"name":"Dan Cumberland"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/dancumberland/kit-mcp.git"},"dependencies":{"@modelcontextprotocol/sdk":"^1.25.0","zod":"^3.23.0"},"devDependencies":{"@biomejs/biome":"^1.9.0","@types/node":"^25.5.0","tsup":"^8.3.0","typescript":"^5.6.0","vitest":"^2.1.0"},"gitHead":"043ce073c2daae4d91ae89d8b65ce3ad5eb7f9df","_id":"@dancumberland/kit-mcp@1.4.0","bugs":{"url":"https://github.com/dancumberland/kit-mcp/issues"},"homepage":"https://github.com/dancumberland/kit-mcp#readme","_nodeVersion":"25.2.1","_npmVersion":"11.6.2","dist":{"integrity":"sha512-7vdXLwR7vJnpvdSXh1I5EZPFgrCFU+L7/AD9stqdFsbfoiKifKUlYNAAVi3ePUqDuA3nRSf69Wd42cNfMf5xyA==","shasum":"57d8306711aff03ad8a4b6c906775d6ea3f896cd","tarball":"https://registry.npmjs.org/@dancumberland/kit-mcp/-/kit-mcp-1.4.0.tgz","fileCount":6,"unpackedSize":237350,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIBrwOPISDkO3Hu29bo7lzB77s7i8/GVHbxMocqsr2vuEAiEAnznIGMwwZsrndQ++Vt11QRHUQrqQkn2UfWQwFmWkHc8="}]},"_npmUser":{"name":"dancumberland","email":"dc@dancumberlandlabs.com"},"directories":{},"maintainers":[{"name":"dancumberland","email":"dc@dancumberlandlabs.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/kit-mcp_1.4.0_1773773647154_0.28568079807908653"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-16T01:04:39.313Z","modified":"2026-03-17T18:54:07.413Z","0.1.0":"2026-03-16T01:04:39.575Z","1.0.0":"2026-03-16T03:10:04.705Z","1.0.1":"2026-03-16T03:11:55.772Z","1.0.2":"2026-03-16T12:40:05.533Z","1.3.1":"2026-03-17T14:04:37.670Z","1.4.0":"2026-03-17T18:54:07.305Z"},"bugs":{"url":"https://github.com/dancumberland/kit-mcp/issues"},"author":{"name":"Dan Cumberland"},"license":"MIT","homepage":"https://github.com/dancumberland/kit-mcp#readme","keywords":["mcp","kit","convertkit","email-marketing","ai-agent","model-context-protocol"],"repository":{"type":"git","url":"git+https://github.com/dancumberland/kit-mcp.git"},"description":"Agent-optimized MCP server for Kit.com email marketing. 13 composite tools covering 100% of the Kit V4 API.","maintainers":[{"name":"dancumberland","email":"dc@dancumberlandlabs.com"}],"readme":"# @dancumberland/kit-mcp\n\nThe most complete MCP server for [Kit.com](https://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.\n\n## How This Is Different\n\nOther Kit MCP servers wrap each API endpoint as a separate tool (29+ tools). That approach breaks in practice:\n\n| | **@dancumberland/kit-mcp** | **Other Kit MCPs** |\n|---|---|---|\n| **Tool count** | 13 composite tools (45 actions) | 29+ individual tools |\n| **Engagement analytics** | Per-subscriber open/click rates, batch comparison across 100 subscribers, engagement-based filtering | None |\n| **Broadcast analytics** | Per-broadcast stats, cross-broadcast comparison, per-link click tracking | Basic list/get only |\n| **Bulk operations** | Batch create subscribers, tags, form subscriptions (up to 10k per call) | None |\n| **Response format** | Formatted text summaries (agent-friendly) | Raw JSON (agent must parse) |\n| **Rate limiting** | Sliding window with automatic retry + exponential backoff | None |\n| **Error recovery** | Typed errors with actionable recovery hints | Generic errors |\n| **Cursor compatible** | 13 tools (well under 40-tool limit) | 29+ tools (risks hitting limit) |\n| **Token overhead** | ~3,200 tokens for all tool definitions | ~8,000+ tokens |\n\n### Engagement Analytics (Exclusive)\n\nThis is the only Kit MCP that can answer \"who are my most engaged subscribers?\":\n\n```\n> Find my most engaged 100 subscribers who've been on my list over 6 months\n\nSubscriber Comparison (100 of 100 loaded, sorted by open rate):\n\n  1. Alice <alice@example.com> — Open: 82.3% | Click: 24.1% | Sent: 95 | Last open: 2026-03-15 (ID: 456)\n  2. Bob <bob@example.com> — Open: 71.0% | Click: 18.5% | Sent: 102 | Last open: 2026-03-14 (ID: 789)\n  ...\n```\n\nOther Kit MCPs can list subscribers and get basic profiles, but can't fetch engagement stats, compare across subscribers, or filter by engagement metrics.\n\n## What This Does\n\nConnects any MCP client (Claude Desktop, Claude Code, Cursor, Windsurf, etc.) to your Kit.com email marketing account. Ask questions naturally:\n\n- \"How many subscribers do I have and how's my list growing?\"\n- \"Show me my broadcast stats from last week\"\n- \"Find my most engaged subscribers from the past 6 months\"\n- \"Tag everyone who signed up through my landing page\"\n- \"Create a draft broadcast for my newsletter\"\n- \"Which links got the most clicks in my last broadcast?\"\n\nNo coding required — just set it up and start talking.\n\n## Prerequisites\n\n1. **Node.js 22+** — Download from [nodejs.org](https://nodejs.org). Check with `node --version`.\n2. **A Kit.com account** — Free or paid, any plan.\n3. **Your Kit API key** — [kit.com → Account Settings → Developer](https://app.kit.com/account/developer). Starts with `kit_`.\n\n## Setup: Claude Desktop App (Recommended)\n\n### Step 1: Find your config file\n\n**Mac:**\n```bash\nopen ~/Library/Application\\ Support/Claude/\n```\nOpen `claude_desktop_config.json` in any text editor.\n\n**Windows:**\n```\n%APPDATA%\\Claude\\claude_desktop_config.json\n```\n\n### Step 2: Add the Kit MCP server\n\nIf the file is empty or doesn't exist, paste this (replace `your-kit-api-key` with your actual key):\n\n```json\n{\n  \"mcpServers\": {\n    \"kit\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@dancumberland/kit-mcp@latest\"],\n      \"env\": {\n        \"KIT_API_KEY\": \"your-kit-api-key\"\n      }\n    }\n  }\n}\n```\n\nIf you already have other MCP servers, add `\"kit\"` inside the existing `\"mcpServers\"` block with a comma after the previous entry.\n\n### Step 3: Restart Claude Desktop\n\nFully quit (not just close the window) and reopen.\n\n### Step 4: Verify it works\n\n> Test my Kit connection\n\nClaude should respond with your account name, auth method, and rate limit.\n\n## Setup: Claude Desktop with Cowork\n\n[Cowork](https://www.anthropic.com/research/cowork) is Claude Desktop's background agent. After completing the setup above, Cowork automatically has access to your Kit tools.\n\n**Example tasks:**\n\n- \"Every morning at 8am, summarize my subscriber growth and email performance from the last 24 hours.\"\n- \"Every Monday at 9am, compare my broadcast stats from the past week — open rates, click rates, and unsubscribes.\"\n- \"Every Friday, list all tags with fewer than 10 subscribers (candidates for cleanup).\"\n\n## Setup: Claude Code (CLI)\n\nAdd to `.claude/settings.local.json` or `~/.claude/settings.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"kit\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@dancumberland/kit-mcp@latest\"],\n      \"env\": {\n        \"KIT_API_KEY\": \"your-kit-api-key\"\n      }\n    }\n  }\n}\n```\n\n## Setup: Cursor\n\n1. Open Settings (Cmd+,)\n2. Search for \"MCP\"\n3. Click \"Add MCP Server\"\n4. Add:\n\n```json\n{\n  \"kit\": {\n    \"command\": \"npx\",\n    \"args\": [\"-y\", \"@dancumberland/kit-mcp@latest\"],\n    \"env\": {\n      \"KIT_API_KEY\": \"your-kit-api-key\"\n    }\n  }\n}\n```\n\n## Tools\n\n| Tool | Actions | What You Can Do |\n|------|---------|-----------------|\n| `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 |\n| `manage_tags` | 6 | List, create, update, tag/untag subscribers, list tagged |\n| `manage_broadcasts` | 8 | List, get, create drafts, update, delete, view stats, compare stats across broadcasts, analyze per-link click data |\n| `manage_forms` | 3 | List forms, list subscribers, add subscriber |\n| `manage_sequences` | 3 | List sequences, add subscriber, list subscribers |\n| `manage_custom_fields` | 4 | List, create, update, delete |\n| `manage_purchases` | 3 | List, get, create (OAuth required) |\n| `manage_segments` | 1 | List segments |\n| `manage_webhooks` | 3 | List, create, delete |\n| `manage_email_templates` | 1 | List templates |\n| `get_account` | — | Full account overview with email and growth stats |\n| `test_connection` | — | Verify your API key works |\n| `bulk_operations` | 7 | Batch subscriber/tag/form/field operations (OAuth required) |\n\n## Things You Can Ask\n\n| What You Say | What Happens |\n|-------------|--------------|\n| \"How's my email list doing?\" | Account stats, subscriber count, growth trends |\n| \"Find dan@example.com\" | Subscriber profile with tags, custom fields, engagement stats |\n| \"Who are my most engaged subscribers?\" | Engagement-filtered list ranked by open/click rates |\n| \"Show me my recent broadcasts\" | Broadcasts with status (draft/scheduled/sent) |\n| \"How did my last broadcast perform?\" | Open rate, click rate, unsubscribes, per-link click data |\n| \"Which links got the most clicks?\" | Per-link click analytics for any broadcast |\n| \"Compare my broadcast performance\" | Side-by-side stats across all broadcasts |\n| \"Create a tag called vip-customers\" | Creates the tag in Kit |\n| \"Tag dan@example.com with vip-customers\" | Applies the tag |\n| \"Draft a broadcast with subject 'Big News'\" | Creates a draft (doesn't send) |\n\n## Authentication\n\n**API Key** (covers most features): Get at [kit.com → Developer](https://app.kit.com/account/developer). Set as `KIT_API_KEY`.\n\n**OAuth Token** (optional, for purchases and bulk operations): Set `KIT_OAUTH_TOKEN` alongside your API key.\n\n```json\n{\n  \"env\": {\n    \"KIT_API_KEY\": \"your-api-key\",\n    \"KIT_OAUTH_TOKEN\": \"your-oauth-token\"\n  }\n}\n```\n\nRate limits enforced automatically: 120 req/min (API key) or 600 req/min (OAuth), with retry + backoff on 429s.\n\n## Architecture: Why 13 Tools Instead of 29+\n\nMost MCP servers create one tool per API endpoint. For Kit's API, that means 29+ tools — which causes real problems:\n\n- **Context bloat** — 8,000+ tokens just for tool definitions, leaving less room for your actual conversation\n- **Poor accuracy** — AI tool selection degrades measurably beyond 20 tools ([research](https://arxiv.org/abs/2305.15334))\n- **Compatibility** — Cursor has a hard limit of 40 tools across all servers; 29 tools from one server leaves almost no room for others\n\nThis 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.\n\n## Error Handling\n\nErrors include recovery hints that Claude can act on:\n\n```\nError 401: Invalid API key\nRecovery: Check your KIT_API_KEY. Find your key at kit.com → Account Settings → Developer.\n```\n\n- **429 (rate limit)**: Automatic retry with exponential backoff, up to 3 attempts\n- **5xx (server error)**: Automatic retry once\n- **422 (validation)**: No retry — returns the error immediately with a fix suggestion\n\n## Troubleshooting\n\n| Problem | Solution |\n|---------|----------|\n| \"Cannot find module\" or npx errors | Make sure Node.js 22+ is installed: `node --version` |\n| \"Invalid API key\" | Double-check your key at [kit.com → Developer](https://app.kit.com/account/developer) |\n| Tools don't appear in Claude | Fully quit and restart Claude Desktop (not just close the window) |\n| \"requires OAuth authentication\" | `manage_purchases` and `bulk_operations` need `KIT_OAUTH_TOKEN` |\n| Rate limit errors | Automatic — the server retries with backoff. If persistent, wait 60 seconds |\n\n## Development\n\n```bash\nnpm install\nnpm run dev          # Watch mode\nnpm run build        # Production build\nnpm test             # Unit tests (179 tests)\nnpm run test:int     # Integration tests (requires KIT_API_KEY)\nnpm run lint         # Biome check\nnpm run typecheck    # TypeScript check\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md"}