Creator email platform
Kit logo

Kit (ConvertKit) API + MCP (2026): v4 + Community MCP Coverage

Kit’s API v4 is the modern REST API for programmatic access to subscribers, tags, forms, sequences, broadcasts, and Kit Commerce. Simple API key authentication, JSON payloads, generous rate limits (600 requests per minute per API key), well-documented webhook subscriptions. What Kit does NOT ship in 2026: an official Model Context Protocol server. AI-agent access comes from community MCP wrappers rather than first-party — unusual for a modern ESP but consistent with Kit’s small engineering team and creator-first positioning.

At a glance

v4
Current API version
v3 deprecated, migration path documented
2
Official SDKs
PHP + Node.js; community for others
0
Official MCP server
Community MCPs available (mcp-kit)

MCP integration in 2026

Model Context Protocol is the emerging standard for connecting LLM agents to external tools. Kit has not yet shipped a first-party MCP server, which is notable given the creator community’s early enthusiasm for AI workflows. Community wrappers fill the gap for now.

!

No official MCP — community wrappers cover Kit API v4

Kit has not shipped an official Model Context Protocol server as of August 2026. Given Kit’s small engineering team and creator-first positioning, it may not be a near-term priority. AI-agent access currently comes from two community routes: the aplaceforallmystuff/mcp-kit community MCP (self-hosted, covers subscribers/broadcasts/sequences) and Kit MCP via mcpmarket (commercial hosted). Both are functional but neither is Kit-endorsed.

Available MCP servers for Kit

API v4 essentials

Base URLhttps://api.kit.com/v4
Response formatJSON
AuthenticationAPI key (header: X-Kit-Api-Key) or OAuth 2.0 for public apps
Rate limits600 requests per minute per API key
Response on rate exceedHTTP 429 with Retry-After header
PaginationCursor-based via after and before query params (max page size 500)
Webhook eventsSubscriber events (subscribe, unsubscribe, tag added, purchase)
Legacy v3 statusDeprecated. Migrate to v4.

Authentication methods

API key (X-Kit-Api-Key header)

Simplest and most common for internal use. Generate an API key in your Kit account under Account › Settings › Advanced › API. Send it in the request header:

X-Kit-Api-Key: YOUR_API_KEY
Content-Type: application/json
Accept: application/json

API keys are account-scoped and inherit full account permissions. No granular scopes — a token can do anything the account allows. Rotate keys promptly if compromised.

OAuth 2.0 (for public apps)

Required for third-party apps published in the Kit integration marketplace. Standard three-leg authorization code flow. Register your app in the Kit Developer Portal. Access tokens have long lifetimes; no refresh required for most use cases.

Rate limits

Limit typeValueNotes
General requests600 per minutePer API key. Generous for creator use cases.
Response on exceedHTTP 429Includes Retry-After header with wait time in seconds.
Bulk operationsBatch endpoints available for subscriber operationsPreferred over looping single-subscriber calls.
Webhook payload sizeNot disclosedStandard SaaS conventions apply.

The 600 req/min per API key ceiling is generous for typical creator workflows. Only large-scale migrations (100K+ subscribers moving in a batch) push near the limit — use batch endpoints for bulk operations.

Official SDKs

LanguagePackageInstallStatus
PHPconvertkit/api-clientcomposer requireOfficial
Node.js@kit/api-clientnpm installOfficial
PythonCommunity wrapperspip installCommunity
RubyCommunity wrappersgem installCommunity

Kit’s official SDK footprint is thin (2 official). For Python, Ruby, .NET, and other languages, community wrappers exist but quality varies. Direct API calls with your language’s HTTP client are often safer than an unmaintained community SDK.

Endpoints reference

ResourceHTTP methodsDescription
Subscribers
/subscribers
GET, POST, PATCH, DELETEFull CRUD on subscribers. Bulk import via batch endpoints.
Tags
/tags
GET, POST, PATCH, DELETEManage subscriber tags. Add/remove tags on subscribers via tag membership endpoints.
Custom fields
/custom_fields
GET, POST, PATCH, DELETECustom subscriber fields for enrichment (name, phone, custom text).
Forms
/forms
GET, POST, PATCHSignup forms and their submissions. Add subscribers via form subscription endpoint.
Sequences
/sequences
GET, POSTAutomated email sequences. Add subscribers to sequences via subscription endpoint.
Broadcasts
/broadcasts
GET, POST, PATCH, DELETEOne-off newsletter broadcasts. Schedule, send, get reports.
Purchases
/purchases
GET, POSTTrack purchases (from Kit Commerce or external ecommerce). Trigger post-purchase sequences.
Webhooks
/webhooks
GET, POST, DELETEConfigure webhook subscriptions for subscriber events.

Code examples

Node.js: add subscriber and tag

const axios = require('axios');

const API_KEY = 'YOUR_API_KEY';
const BASE_URL = 'https://api.kit.com/v4';

async function subscribeWithTag(email, tagId) {
  // 1. Create subscriber
  const created = await axios.post(
    `${BASE_URL}/subscribers`,
    {
      email_address: email,
      first_name: 'Alaa',
      state: 'active'
    },
    { headers: { 'X-Kit-Api-Key': API_KEY } }
  );

  // 2. Add tag
  await axios.post(
    `${BASE_URL}/tags/${tagId}/subscribers`,
    { email_address: email },
    { headers: { 'X-Kit-Api-Key': API_KEY } }
  );

  console.log(`Subscribed and tagged: ${created.data.subscriber.id}`);
}

subscribeWithTag('user@example.com', 'YOUR_TAG_ID');

Common gotchas

API v3 deprecated — migrate to v4

Kit’s legacy API v3 is deprecated. New development targets v4 at api.kit.com/v4. Note that v4 uses X-Kit-Api-Key header (not v3’s api_secret query parameter).

Tokens do not have granular scopes

Kit API keys grant full account access. No read-only or object-scoped tokens. For safer third-party integrations, rotate keys on staff turnover and limit key distribution.

Sequences are read-only for CRUD via API

You can subscribe/unsubscribe subscribers to existing sequences via the API. Creating or modifying sequence content is UI-only.

Small SDK footprint

Only PHP and Node.js official SDKs. For Python, Ruby, .NET, community wrappers vary in quality. Audit maintenance status before adopting a community SDK, or call the API directly with your language’s HTTP client.

Deprecations and changelog

  • API v4 is current. Modern REST API with cleaner authentication and better documentation.
  • API v3 deprecated. Legacy integrations should migrate to v4 promptly.
  • No official MCP server as of 2026. Community MCPs (aplaceforallmystuff/mcp-kit, mcpmarket) fill the gap.
  • ConvertKit renamed to Kit in 2024. API and product names transitioning; some docs still reference “ConvertKit”.
  • Kit Commerce API endpoints matured in 2024-2025 for programmatic creator commerce integration.

Frequently asked questions

Does Kit have an official MCP server for AI agents?

No. Kit does not ship a first-party MCP server as of August 2026. Community coverage: aplaceforallmystuff/mcp-kit (self-hosted, most-active) or Kit MCP via mcpmarket (commercial hosted).

Which programming languages have official Kit SDKs?

Two officially maintained SDKs: PHP and Node.js. For Python, Ruby, .NET, community wrappers exist but quality varies. Audit maintenance status before adopting a community SDK.

What is the Kit API rate limit?

600 requests per minute per API key. Generous for creator use cases. HTTP 429 includes Retry-After header. Use batch endpoints for bulk operations.

How do I authenticate with the Kit API?

API key in the X-Kit-Api-Key header. Generate under Account › Settings › Advanced › API. Account-scoped, no granular permissions. For public apps: OAuth 2.0 with app registration in Kit Developer Portal.

Is Kit API v3 still supported?

Deprecated. Migrate to v4 at api.kit.com/v4. Note that v4 uses X-Kit-Api-Key header (v3 used api_secret query parameter).

Can I send emails through Kit from Claude Desktop?

Yes, via community MCP. Install aplaceforallmystuff/mcp-kit (self-hosted) or subscribe to Kit MCP via mcpmarket. Both let AI agents manage subscribers, tags, broadcasts, sequences through natural language.

Can I create sequences via the API?

No. Sequences are UI-only for creation and content editing. The API lets you subscribe/unsubscribe subscribers to existing sequences, but sequence creation requires the Kit dashboard.

Changelog (recent)

  • 2026-08-18 API + MCP tab published on SMTPedia. First profile documenting Kit API v4 alongside community MCP coverage (aplaceforallmystuff/mcp-kit, mcpmarket).
  • 2026 Community MCP wrappers for Kit gaining traction (aplaceforallmystuff/mcp-kit most-active). No first-party MCP yet.
  • 2024 ConvertKit renamed to Kit. API base URL migrated to api.kit.com/v4. Product name transitioning across docs.
AAlaa Touil RRabeb How we test →

This review follows our email infrastructure testing methodology. We disclose affiliate relationships in our editorial independence policy.