{
  "markdown": "# MCP Kit Server\n\n![Architecture](docs/images/architecture-diagram.png)\n\n<!-- <p align=\"center\">\n  <img src=\"docs/mcp-kit-logo.png\" alt=\"MCP Kit Server\" width=\"400\">\n</p> -->\n\n[![npm version](https://img.shields.io/npm/v/kit-mcp-server.svg)](https://www.npmjs.com/package/kit-mcp-server)\n[![CI](https://github.com/aplaceforallmystuff/mcp-kit/actions/workflows/ci.yml/badge.svg)](https://github.com/aplaceforallmystuff/mcp-kit/actions/workflows/ci.yml)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![MCP](https://img.shields.io/badge/MCP-Compatible-blue)](https://modelcontextprotocol.io)\n[![Status: Deprecated](https://img.shields.io/badge/status-deprecated-red.svg)](#deprecated--use-kits-official-mcp-servers)\n\nAn MCP (Model Context Protocol) server that connects AI assistants like Claude to the [Kit.com](https://kit.com) (formerly ConvertKit) email marketing platform. Manage your email lists, subscribers, broadcasts, sequences, and more through natural language.\n\n> [!WARNING]\n> **This project is deprecated and no longer maintained.** Kit now ships official, first-party MCP servers that supersede it with broader API coverage and managed authentication. Please migrate — see below.\n\n## ⚠️ Deprecated — use Kit's official MCP servers\n\nThis community server was built before Kit offered its own MCP. Kit now maintains **official servers** that cover far more of the Kit API v4 surface (including analytics, commerce, segments, and bulk operations), handle auth for you, and stay current with API changes. **New and existing users should migrate.**\n\n| Use case | Official server | URL |\n|----------|-----------------|-----|\n| Act on your Kit account — subscribers, tags, sequences, broadcasts, **analytics**, commerce… | **Kit MCP** | `https://app.kit.com/mcp` |\n| Give a coding agent live access to Kit's developer docs + API | **Kit Developer Docs MCP** | `https://developers.kit.com/mcp` |\n\n### Migrate in Claude Code\n\n```bash\n# Remove this deprecated server (if you added it as \"kit\")\nclaude mcp remove kit\n\n# Add the official operational Kit MCP\nclaude mcp add --transport http kit https://app.kit.com/mcp\n\n# Optional: add Kit's developer-docs MCP for building integrations\nclaude mcp add --transport http kit-docs https://developers.kit.com/mcp\n```\n\nOfficial setup guides (Claude Desktop, Cursor, Windsurf, Cline, and more): <https://developers.kit.com/mcp/kit-developer-docs-mcp/mcp/overview>\n\n---\n\n<details>\n<summary>📦 Legacy documentation (for historical reference)</summary>\n\n## Why Use This?\n\nIf you run a newsletter or email marketing on Kit.com, this MCP server lets you:\n\n- **Manage subscribers** - List, create, update, and organize your email subscribers\n- **Handle tags efficiently** - Create tags, add/remove tags from subscribers, list subscribers by tag\n- **Work with sequences** - View email sequences and add subscribers to automated sequences\n- **Create broadcasts** - Draft and manage email campaigns\n- **Analyze your list** - Query subscriber data with filters (status, date ranges, custom fields)\n- **Automate workflows** - Let Claude handle repetitive email marketing tasks\n\n## Features\n\n| Category | Tools |\n|----------|-------|\n| **Account** | Get account information |\n| **Subscribers** | List, get, create, update, manage tags |\n| **Tags** | List, create, update, delete, get subscribers by tag |\n| **Sequences** | List, get, add subscribers |\n| **Broadcasts** | List, get, create, update, delete |\n| **Forms** | List, get, add subscribers |\n| **Custom Fields** | List available fields |\n| **Webhooks** | List, create, delete |\n\n### Complete Tool Reference\n\n**Account**\n- `kit_get_account` - Get Kit.com account information\n\n**Subscribers (7 tools)**\n- `kit_list_subscribers` - List subscribers with filters (status, date ranges, pagination)\n- `kit_get_subscriber` - Get a specific subscriber by ID\n- `kit_create_subscriber` - Create a new subscriber\n- `kit_update_subscriber` - Update subscriber details\n- `kit_get_subscriber_tags` - Get all tags for a subscriber\n- `kit_add_tag_to_subscriber` - Add a tag to a subscriber\n- `kit_remove_tag_from_subscriber` - Remove a tag from a subscriber\n\n**Tags (6 tools)**\n- `kit_list_tags` - List all tags\n- `kit_get_tag` - Get a specific tag\n- `kit_create_tag` - Create a new tag\n- `kit_update_tag` - Rename a tag\n- `kit_delete_tag` - Delete a tag\n- `kit_list_tag_subscribers` - List all subscribers with a specific tag\n\n**Sequences (3 tools)**\n- `kit_list_sequences` - List all email sequences\n- `kit_get_sequence` - Get sequence details\n- `kit_add_subscriber_to_sequence` - Add subscriber to a sequence\n\n**Broadcasts (5 tools)**\n- `kit_list_broadcasts` - List all broadcasts\n- `kit_get_broadcast` - Get broadcast details\n- `kit_create_broadcast` - Create a new broadcast\n- `kit_update_broadcast` - Update a broadcast\n- `kit_delete_broadcast` - Delete a broadcast\n\n**Forms (3 tools)**\n- `kit_list_forms` - List all forms\n- `kit_get_form` - Get form details\n- `kit_add_subscriber_to_form` - Add subscriber via form\n\n**Custom Fields (1 tool)**\n- `kit_list_custom_fields` - List all custom fields\n\n**Webhooks (3 tools)**\n- `kit_list_webhooks` - List configured webhooks\n- `kit_create_webhook` - Create a new webhook\n- `kit_delete_webhook` - Delete a webhook\n\n## Prerequisites\n\n- Node.js 18+\n- A [Kit.com](https://kit.com) account\n- Your Kit.com API key (v4 API)\n\n## Installation\n\n### Option 1: Install from npm (recommended)\n\n```bash\nnpx kit-mcp-server\n```\n\nOr install globally:\n\n```bash\nnpm install -g kit-mcp-server\n```\n\n### Option 2: Clone and Build\n\n```bash\ngit clone https://github.com/aplaceforallmystuff/mcp-kit.git\ncd mcp-kit\nnpm install\nnpm run build\n```\n\n## Configuration\n\n### 1. Get Your Kit.com API Key\n\n1. Log in to [Kit.com](https://kit.com)\n2. Navigate to Settings > Developer\n3. Create a new API key or copy an existing v4 API key\n\n### 2. Configure Your MCP Client\n\n#### For Claude Desktop\n\nAdd to your Claude Desktop config file:\n\n**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n\n**Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"kit\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/mcp-kit/dist/index.js\"],\n      \"env\": {\n        \"KIT_API_KEY\": \"your-api-key-here\"\n      }\n    }\n  }\n}\n```\n\n#### For Claude Code\n\n```bash\nclaude mcp add kit -e KIT_API_KEY=your-api-key-here -- node /path/to/mcp-kit/dist/index.js\n```\n\nOr add to `~/.claude.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"kit\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/mcp-kit/dist/index.js\"],\n      \"env\": {\n        \"KIT_API_KEY\": \"your-api-key-here\"\n      }\n    }\n  }\n}\n```\n\n## Usage Examples\n\nOnce configured, you can interact with Kit.com through natural language:\n\n### Subscriber Management\n> \"Show me all active subscribers from the last 30 days\"\n\n> \"Create a new subscriber with email user@example.com and tag them as 'newsletter'\"\n\n> \"What tags does subscriber@example.com have?\"\n\n### Tag Operations\n> \"List all my tags and how many subscribers each has\"\n\n> \"Create a tag called 'VIP Customers'\"\n\n> \"Add the 'engaged' tag to all subscribers who signed up this month\"\n\n### Email Sequences\n> \"Show me all my email sequences\"\n\n> \"Add user@example.com to the welcome sequence\"\n\n### Broadcasts\n> \"Create a draft broadcast with subject 'Weekly Update' and preview text 'This week in AI...'\"\n\n> \"List all my recent broadcasts and their stats\"\n\n### Forms\n> \"Show me all active forms\"\n\n> \"Add a subscriber to my main signup form\"\n\n## Development\n\n```bash\n# Run in development mode (watches for changes)\nnpm run dev\n\n# Build for production\nnpm run build\n\n# Run the built version\nnpm start\n```\n\n## Troubleshooting\n\n### \"KIT_API_KEY environment variable is required\"\nEnsure you have set the `KIT_API_KEY` environment variable in your MCP configuration.\n\n### \"Kit API error (401)\"\nYour API key is invalid or expired. Generate a new one from Kit.com Settings > Developer.\n\n### \"Kit API error (403)\"\nYour API key doesn't have permission for this operation. Check that you're using a v4 API key with appropriate scopes.\n\n### \"Kit API error (404)\"\nThe resource (subscriber, tag, broadcast, etc.) was not found. Verify the ID is correct.\n\n### \"Kit API error (422)\"\nInvalid request data. Check that email addresses are valid and required fields are provided.\n\n## API Reference\n\nThis server uses the [Kit.com API v4](https://developers.kit.com/). All tools support pagination where applicable using `per_page` and `after` cursor parameters.\n\n## Contributing\n\nThis project is **deprecated** and not accepting contributions. Please use Kit's [official MCP servers](https://developers.kit.com/mcp/kit-developer-docs-mcp/mcp/overview) instead.\n\n## License\n\nMIT License - see [LICENSE](LICENSE) for details.\n\n## Links\n\n- [Kit.com](https://kit.com)\n- [Kit.com API Documentation](https://developers.kit.com/)\n- [Model Context Protocol](https://modelcontextprotocol.io)\n- [MCP Specification](https://spec.modelcontextprotocol.io)\n\n</details>",
  "bytes": 9023,
  "sha": "bb76dfb066562058dfcb857f35cd923b4eb629691be90b14f9877184e2bf4987",
  "repo_slug": "aplaceforallmystuff/mcp-kit",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_aplaceforallmystuff_mcp_kit_8360d044/readme"
}