Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Kit MCP connector

OAuth 2.1/DCR MarketingAutomation

Connect to Kit MCP. Manage email subscribers, sequences, broadcasts, tags, and forms for your email marketing workflows.

Kit MCP connector

  1. Install the SDK

    Section titled “Install the SDK”
    Terminal window
    npm install @scalekit-sdk/node

    Full SDK reference: Node.js | Python

  2. Set your credentials

    Section titled “Set your credentials”

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>

  3. Authorize and make your first call

    Section titled “Authorize and make your first call”
    quickstart.ts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    

    const scalekit = new ScalekitClient(
      process.env.SCALEKIT_ENV_URL,
      process.env.SCALEKIT_CLIENT_ID,
      process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    

    const connector = 'kitmcp'
    const identifier = 'user_123'
    

    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Kit MCP:', link)
    process.stdout.write('Press Enter after authorizing...')
    await new Promise(r => process.stdin.once('data', r))
    

    // Make your first call
    const result = await actions.executeTool({
      connector,
      identifier,
      toolName: 'kitmcp_get_account',
      toolInput: {},
    })
    console.log(result)

What you can do

Section titled “What you can do”

Connect this agent connector to let your agent:

  • Update tag, subscriber, snippet — Rename a tag by ID
  • Subscriber untag, tag — Remove a tag from a subscriber by subscriber ID and tag ID
  • Unsubscribe records — Cancel a subscriber’s subscription by subscriber ID
  • List webhooks, tags, tag subscribers — List all registered webhooks in the account
  • Get subscriber tags, subscriber stats, subscriber — Retrieve all tags applied to a specific subscriber, paginated
  • Subscribers filter, bulk untag, bulk tag — Search and filter subscribers by engagement events (opens, clicks, sends, deliveries) or sign-up date

Tool list

Section titled “Tool list”

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

kitmcp_add_subscriber_to_form # Subscribe a single email address to a Kit form. Creates the subscriber if they do not exist; returns the subscriber record. 4 params

Subscribe a single email address to a Kit form. Creates the subscriber if they do not exist; returns the subscriber record.

Name Type Required Description
email_address string required Subscriber's email address (required)
form_id integer required The form ID (required). Use list_forms to find IDs.
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_add_subscriber_to_sequence # Enroll a single subscriber (by email) into a Kit email sequence. Use list_sequences to find the sequence ID. 4 params

Enroll a single subscriber (by email) into a Kit email sequence. Use list_sequences to find the sequence ID.

Name Type Required Description
email_address string required Subscriber's email address (required)
sequence_id integer required The sequence ID (required). Use list_sequences to find IDs.
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_bulk_add_subscribers_to_form # Subscribe multiple existing subscribers to one or more forms in a single request. Batches over 100 are processed asynchronously. 4 params

Subscribe multiple existing subscribers to one or more forms in a single request. Batches over 100 are processed asynchronously.

Name Type Required Description
additions array required Form subscriptions to create (required). Each item must include `form_id` and `subscriber_id`.
callback_url string optional URL to POST results to when the batch is processed asynchronously (batches > 100).
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_bulk_create_custom_fields # Create multiple custom subscriber fields in one request. Use list_custom_fields to view existing fields. 4 params

Create multiple custom subscriber fields in one request. Use list_custom_fields to view existing fields.

Name Type Required Description
custom_fields array required Custom field definitions to create (required). Each item must include `label`.
callback_url string optional URL to POST results to when the batch is processed asynchronously (batches > 100).
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_bulk_create_subscribers # Create or update multiple subscribers in one request. Batches over 100 are processed asynchronously. 4 params

Create or update multiple subscribers in one request. Batches over 100 are processed asynchronously.

Name Type Required Description
subscribers array required Subscribers to upsert (required). Each item must include `email_address`; `first_name` and `state` are optional.
callback_url string optional URL to POST results to when the batch is processed asynchronously (batches > 100).
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_bulk_create_tags # Create multiple tags in one request. Returns created tag records. 4 params

Create multiple tags in one request. Returns created tag records.

Name Type Required Description
tags array required Tags to create (required). Each item must include `name`.
callback_url string optional URL to POST results to when the batch is processed asynchronously (batches > 100).
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_bulk_tag_subscribers # Apply a tag to multiple subscribers in one request. Batches over 100 are processed asynchronously. 4 params

Apply a tag to multiple subscribers in one request. Batches over 100 are processed asynchronously.

Name Type Required Description
taggings array required Tag-subscriber pairs to apply (required). Each item must include `tag_id` (integer) and `subscriber_id` (integer).
callback_url string optional URL to POST results to when the batch is processed asynchronously (batches > 100).
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_bulk_untag_subscribers # Remove a tag from multiple subscribers in one request. Batches over 100 are processed asynchronously. 4 params

Remove a tag from multiple subscribers in one request. Batches over 100 are processed asynchronously.

Name Type Required Description
taggings array required Tag-subscriber pairs to remove (required). Each item must include `tag_id` (integer) and `subscriber_id` (integer).
callback_url string optional URL to POST results to when the batch is processed asynchronously (batches > 100).
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_bulk_update_subscriber_custom_field_values # Update custom field values for multiple subscribers in one request. 4 params

Update custom field values for multiple subscribers in one request.

Name Type Required Description
custom_field_values array required Custom field updates to apply (required). Each item must include `subscriber_id`, `subscriber_custom_field_id`, and `value`.
callback_url string optional URL to POST results to when the batch is processed asynchronously (batches > 100).
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_create_broadcast # Create a draft email broadcast in Kit. The broadcast is saved as a draft; scheduling and sending happen from the Kit UI. 10 params

Create a draft email broadcast in Kit. The broadcast is saved as a draft; scheduling and sending happen from the Kit UI.

Name Type Required Description
content string required Email body content in HTML (required)
subject string required Email subject line (required)
allow_starting_point boolean optional Set to true when posting adapted content from a Starting-point template (in combination with `email_template_id` set to that template's id and `content` set to the adapted body). Required only for the Starting-point + content combination; omit otherwise.
description string optional Internal description for organizing broadcasts
email_template_id integer optional Email template ID. Use list_email_templates to find IDs.
preview_text string optional Preview text shown in email clients
public boolean optional Whether to publish on the creator's profile page
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
subscriber_filter array optional Target audience filter. A single-element array wrapping one filter group (all/any/none). Example: [{ "all": [{ "type": "tag", "ids": [1, 2] }] }]. Only one filter group (all, any, or none) may be populated per request. Filter types allowed: 'tag' or 'segment'. Omit to target all subscribers.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_create_custom_field # Create a new custom subscriber field. Returns the created field record with its key. 3 params

Create a new custom subscriber field. Returns the created field record with its key.

Name Type Required Description
label string required Field label (required), e.g. 'Company' or 'Website'
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_create_sequence # Create a new email sequence. Returns the sequence record including its ID. 9 params

Create a new email sequence. Returns the sequence record including its ID.

Name Type Required Description
name string required Sequence name (required)
email_address string optional From email address to use for this sequence
email_template_id integer optional Email template ID. Use list_email_templates to find IDs.
repeat boolean optional Whether the sequence repeats for subscribers
send_days array optional Days to send on (e.g. ['monday', 'wednesday', 'friday'])
send_hour integer optional Hour of day to send (0-23)
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
time_zone string optional Timezone for send scheduling (e.g. 'America/New_York')
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_create_sequence_email # Add a new email to an existing sequence at a specified position and delay. 12 params

Add a new email to an existing sequence at a specified position and delay.

Name Type Required Description
delay_unit string required 'days' or 'hours' (required)
delay_value integer required Number of days or hours to wait before sending this email (required). Unit is controlled by delay_unit.
sequence_id integer required The sequence ID (required). Use list_sequences to find IDs.
subject string required Email subject line (required)
content string optional Email body content in HTML
email_template_id integer optional Layout template ID. Use list_email_templates to find IDs.
position integer optional 0-based position in the sequence. Defaults to the end.
preview_text string optional Preview text shown in email clients
published boolean optional Publish the email immediately (default: false)
send_days array optional Days of the week this email may send. Omit or pass null to allow all days (inherits the sequence schedule).
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_create_snippet # Create a reusable content snippet (inline or block) for use in broadcasts and sequences. 6 params

Create a reusable content snippet (inline or block) for use in broadcasts and sequences.

Name Type Required Description
name string required Snippet name (required). Used to auto-generate the key.
snippet_type string required 'inline' or 'block' (required). Cannot be changed after creation.
content string optional Text/Liquid content for inline snippets (required when snippet_type is 'inline')
document_attributes object optional Rich HTML content for block snippets (required when snippet_type is 'block')
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_create_subscriber # Create or update a single subscriber by email address (upsert). Returns the subscriber record. 6 params

Create or update a single subscriber by email address (upsert). Returns the subscriber record.

Name Type Required Description
email_address string required Subscriber's email address (required)
fields object optional Custom field values as key-value pairs
first_name string optional Subscriber's first name
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
state string optional Subscriber state (default: active)
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_create_tag # Create a new tag. Returns the tag record with its ID. 3 params

Create a new tag. Returns the tag record with its ID.

Name Type Required Description
name string required Tag name (required)
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_create_webhook # Register a webhook endpoint to receive Kit events. Returns the created webhook record. 4 params

Register a webhook endpoint to receive Kit events. Returns the created webhook record.

Name Type Required Description
event object required Event configuration (required). Must include 'name' and optional filter IDs.
target_url string required URL to receive webhook POST requests (required)
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_delete_broadcast # Delete a draft broadcast by ID. Only draft broadcasts can be deleted. 3 params

Delete a draft broadcast by ID. Only draft broadcasts can be deleted.

Name Type Required Description
broadcast_id integer required The broadcast ID to delete (required). Use list_broadcasts to find IDs.
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_delete_custom_field # Delete a custom subscriber field by ID. 3 params

Delete a custom subscriber field by ID.

Name Type Required Description
custom_field_id integer required The custom field ID to delete (required). Use list_custom_fields to find IDs.
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_delete_sequence # Delete a sequence and all its emails by ID. 3 params

Delete a sequence and all its emails by ID.

Name Type Required Description
id integer required The sequence ID to delete (required). Use list_sequences to find IDs.
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_delete_sequence_email # Delete a single email from a sequence by email ID and sequence ID. 4 params

Delete a single email from a sequence by email ID and sequence ID.

Name Type Required Description
id integer required The email ID to delete (required). Use list_sequence_emails to find IDs.
sequence_id integer required The sequence ID (required). Use list_sequences to find IDs.
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_delete_webhook # Delete a registered webhook by ID. 3 params

Delete a registered webhook by ID.

Name Type Required Description
webhook_id integer required The webhook ID to delete (required). Use list_webhooks to find IDs.
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_filter_subscribers # Search and filter subscribers by engagement events (opens, clicks, sends, deliveries) or sign-up date. Returns paginated results. 9 params

Search and filter subscribers by engagement events (opens, clicks, sends, deliveries) or sign-up date. Returns paginated results.

Name Type Required Description
after string optional Pagination cursor for the next page. Use `pagination.end_cursor` from a previous response. Distinct from per-filter date ranges in `all[].after`.
all array optional Array of filter conditions, AND-ed together. Each item filters by one event type (opens, clicks, sent, delivered) or by sign-up date (subscribed). Omit to match all subscribers.
before string optional Pagination cursor for the previous page. Use `pagination.start_cursor` from a previous response. Distinct from per-filter date ranges in `all[].before`.
include_total_count boolean optional If true, include `pagination.total_count` in the response (slower).
per_page integer optional Results per page (1-100).
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
sort_field string optional Field to sort by. Defaults to `id` (recommended for stable cursor pagination).
sort_order string optional Sort direction (default: desc).
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_get_account # Retrieve the Kit account details for the authenticated user. 2 params

Retrieve the Kit account details for the authenticated user.

Name Type Required Description
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_get_account_colors # Retrieve the custom brand color palette for the Kit account. 2 params

Retrieve the custom brand color palette for the Kit account.

Name Type Required Description
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_get_broadcast # Retrieve a single broadcast record by ID. 3 params

Retrieve a single broadcast record by ID.

Name Type Required Description
id integer required The broadcast ID
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_get_broadcast_clicks # Retrieve click data for a specific broadcast, paginated by cursor. 6 params

Retrieve click data for a specific broadcast, paginated by cursor.

Name Type Required Description
id integer required The broadcast ID
after string optional Cursor for next page. Use `pagination.end_cursor` from a previous response.
before string optional Cursor for previous page. Use `pagination.start_cursor` from a previous response.
per_page integer optional Results per page (1-100)
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_get_broadcast_stats # Retrieve performance statistics (opens, clicks, etc.) for a specific broadcast. 3 params

Retrieve performance statistics (opens, clicks, etc.) for a specific broadcast.

Name Type Required Description
id integer required The broadcast ID
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_get_broadcasts_stats # Retrieve aggregated performance statistics for multiple broadcasts, with optional date and status filters. 8 params

Retrieve aggregated performance statistics for multiple broadcasts, with optional date and status filters.

Name Type Required Description
after string optional Cursor for next page. Use `pagination.end_cursor` from a previous response.
before string optional Cursor for previous page. Use `pagination.start_cursor` from a previous response.
per_page integer optional Results per page (1-100)
sent_after string optional ISO 8601 date or datetime (e.g. `2026-01-15` or `2026-01-15T10:00:00Z`). Only include broadcasts with `send_at >= sent_after`.
sent_before string optional ISO 8601 date or datetime (e.g. `2026-01-15` or `2026-01-15T10:00:00Z`). Only include broadcasts with `send_at < sent_before`.
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
status string optional Filter to broadcasts in this state. Omit to return all states.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_get_creator_profile # Retrieve the creator profile linked to the authenticated Kit account. 2 params

Retrieve the creator profile linked to the authenticated Kit account.

Name Type Required Description
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_get_email_stats # Retrieve overall email performance statistics for the Kit account. 2 params

Retrieve overall email performance statistics for the Kit account.

Name Type Required Description
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_get_email_template # Retrieve a single email template by ID. 3 params

Retrieve a single email template by ID.

Name Type Required Description
id integer required The email template ID (required). Use list_email_templates to find IDs.
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_get_growth_stats # Retrieve subscriber growth statistics for a specified date range. 4 params

Retrieve subscriber growth statistics for a specified date range.

Name Type Required Description
ending string optional End date (YYYY-MM-DD). Defaults to today.
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
starting string optional Start date (YYYY-MM-DD). Defaults to 90 days ago.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_get_post # Retrieve a single Kit post (newsletter issue) by ID. 3 params

Retrieve a single Kit post (newsletter issue) by ID.

Name Type Required Description
id integer required The post ID
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_get_purchase # Retrieve a single purchase record by ID. 3 params

Retrieve a single purchase record by ID.

Name Type Required Description
id integer required The purchase ID
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_get_sequence # Retrieve a single sequence record by ID. 3 params

Retrieve a single sequence record by ID.

Name Type Required Description
id integer required The sequence ID
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_get_sequence_email # Retrieve a single email within a sequence by email ID and sequence ID. 4 params

Retrieve a single email within a sequence by email ID and sequence ID.

Name Type Required Description
id integer required The email ID (required). Use list_sequence_emails to find IDs.
sequence_id integer required The sequence ID (required). Use list_sequences to find IDs.
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_get_snippet # Retrieve a single content snippet by ID. 3 params

Retrieve a single content snippet by ID.

Name Type Required Description
id integer required The snippet ID (required). Use list_snippets to find IDs.
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_get_subscriber # Retrieve a single subscriber record by ID, including their custom fields. 3 params

Retrieve a single subscriber record by ID, including their custom fields.

Name Type Required Description
id integer required The subscriber ID
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_get_subscriber_stats # Retrieve engagement statistics for a single subscriber. 3 params

Retrieve engagement statistics for a single subscriber.

Name Type Required Description
id integer required The subscriber ID
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_get_subscriber_tags # Retrieve all tags applied to a specific subscriber, paginated. 6 params

Retrieve all tags applied to a specific subscriber, paginated.

Name Type Required Description
id integer required The subscriber ID
after string optional Cursor for next page. Use `pagination.end_cursor` from a previous response.
before string optional Cursor for previous page. Use `pagination.start_cursor` from a previous response.
per_page integer optional Results per page (1-100)
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_list_broadcasts # List all broadcasts with optional status filter and cursor pagination. 7 params

List all broadcasts with optional status filter and cursor pagination.

Name Type Required Description
after string optional Cursor for next page. Use `pagination.end_cursor` from a previous response.
before string optional Cursor for previous page. Use `pagination.start_cursor` from a previous response.
include array optional Extra fields to include per broadcast. `content` adds the full HTML body (can be large — only request when needed).
per_page integer optional Results per page (1-100)
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
status string optional Filter to broadcasts in this state. Omit to return all states.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_list_custom_fields # List all custom subscriber fields in the account. 5 params

List all custom subscriber fields in the account.

Name Type Required Description
after string optional Cursor for next page. Use `pagination.end_cursor` from a previous response.
before string optional Cursor for previous page. Use `pagination.start_cursor` from a previous response.
per_page integer optional Results per page (1-100)
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_list_email_templates # List all email templates in the account. 5 params

List all email templates in the account.

Name Type Required Description
after string optional Cursor for next page. Use `pagination.end_cursor` from a previous response.
before string optional Cursor for previous page. Use `pagination.start_cursor` from a previous response.
per_page integer optional Results per page (1-100)
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_list_form_subscribers # List all subscribers on a specific form, paginated. 7 params

List all subscribers on a specific form, paginated.

Name Type Required Description
id integer required The form ID. Use list_forms to find IDs.
after string optional Cursor for next page. Use `pagination.end_cursor` from a previous response.
before string optional Cursor for previous page. Use `pagination.start_cursor` from a previous response.
include array optional Extra data to include per subscriber. `fields` adds custom field values (omit for slim responses).
per_page integer optional Results per page (1-100)
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_list_forms # List all forms in the account with optional status filter. 6 params

List all forms in the account with optional status filter.

Name Type Required Description
after string optional Cursor for next page. Use `pagination.end_cursor` from a previous response.
before string optional Cursor for previous page. Use `pagination.start_cursor` from a previous response.
per_page integer optional Results per page (1-100)
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
status string optional Form status (default: active)
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_list_posts # List all Kit newsletter posts with optional cursor pagination. 6 params

List all Kit newsletter posts with optional cursor pagination.

Name Type Required Description
after string optional Cursor for next page. Use `pagination.end_cursor` from a previous response.
before string optional Cursor for previous page. Use `pagination.start_cursor` from a previous response.
include_content boolean optional Set to true to include the full HTML body of each post. Omit (or set false) for a slim response.
per_page integer optional Results per page (1-100)
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_list_prompt_suggestions # Retrieve suggested prompts to help the user get started with Kit via AI. 2 params

Retrieve suggested prompts to help the user get started with Kit via AI.

Name Type Required Description
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_list_purchases # List all purchase records in the account, paginated. 5 params

List all purchase records in the account, paginated.

Name Type Required Description
after string optional Cursor for next page. Use `pagination.end_cursor` from a previous response.
before string optional Cursor for previous page. Use `pagination.start_cursor` from a previous response.
per_page integer optional Results per page (1-100)
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_list_segments # List all subscriber segments in the account. 5 params

List all subscriber segments in the account.

Name Type Required Description
after string optional Cursor for next page. Use `pagination.end_cursor` from a previous response.
before string optional Cursor for previous page. Use `pagination.start_cursor` from a previous response.
per_page integer optional Results per page (1-100)
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_list_sequence_emails # List all emails in a specific sequence. 7 params

List all emails in a specific sequence.

Name Type Required Description
sequence_id integer required The sequence ID (required). Use list_sequences to find IDs.
after string optional Cursor for next page. Use `pagination.end_cursor` from a previous response.
before string optional Cursor for previous page. Use `pagination.start_cursor` from a previous response.
include_content boolean optional Include HTML content in each email (default: false)
per_page integer optional Results per page (1-100)
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_list_sequence_subscribers # List all subscribers enrolled in a specific sequence. 7 params

List all subscribers enrolled in a specific sequence.

Name Type Required Description
id integer required The sequence ID
after string optional Cursor for next page. Use `pagination.end_cursor` from a previous response.
before string optional Cursor for previous page. Use `pagination.start_cursor` from a previous response.
include array optional Extra data to include per subscriber. `fields` adds custom field values (omit for slim responses).
per_page integer optional Results per page (1-100)
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_list_sequences # List all email sequences in the account. 5 params

List all email sequences in the account.

Name Type Required Description
after string optional Cursor for next page. Use `pagination.end_cursor` from a previous response.
before string optional Cursor for previous page. Use `pagination.start_cursor` from a previous response.
per_page integer optional Results per page (1-100)
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_list_snippets # List all content snippets in the account with optional type and archive filters. 8 params

List all content snippets in the account with optional type and archive filters.

Name Type Required Description
after string optional Cursor for next page. Use `pagination.end_cursor` from a previous response.
archived boolean optional true to list archived snippets, false (default) for active ones
before string optional Cursor for previous page. Use `pagination.start_cursor` from a previous response.
include_content boolean optional Include content and document fields in each snippet (default: false)
per_page integer optional Results per page (1-100)
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
snippet_type string optional Filter by type: 'inline' or 'block'
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_list_subscribers # List all subscribers with optional status, sort, and cursor pagination. 9 params

List all subscribers with optional status, sort, and cursor pagination.

Name Type Required Description
after string optional Cursor for next page. Use `pagination.end_cursor` from a previous response.
before string optional Cursor for previous page. Use `pagination.start_cursor` from a previous response.
include array optional Extra data to include per subscriber. `fields` adds custom field values (omit for slim responses). `canceled_at` requires `status` set to `cancelled` (otherwise the API returns 422).
per_page integer optional Results per page (1-100)
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
sort_field string optional Sort by `id` (default, recommended for stable cursor pagination), `created_at`, or `updated_at`.
sort_order string optional Sort direction: asc or desc
status string optional Filter by subscriber state. Defaults to active when omitted. Use `all` to include every state.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_list_tag_subscribers # List all subscribers who have a specific tag applied. 7 params

List all subscribers who have a specific tag applied.

Name Type Required Description
id integer required The tag ID. Use list_tags to find IDs.
after string optional Cursor for next page. Use `pagination.end_cursor` from a previous response.
before string optional Cursor for previous page. Use `pagination.start_cursor` from a previous response.
include array optional Extra data to include per subscriber. `fields` adds custom field values (omit for slim responses).
per_page integer optional Results per page (1-100)
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_list_tags # List all tags in the account. 5 params

List all tags in the account.

Name Type Required Description
after string optional Cursor for next page. Use `pagination.end_cursor` from a previous response.
before string optional Cursor for previous page. Use `pagination.start_cursor` from a previous response.
per_page integer optional Results per page (1-100)
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_list_webhooks # List all registered webhooks in the account. 5 params

List all registered webhooks in the account.

Name Type Required Description
after string optional Cursor for next page. Use `pagination.end_cursor` from a previous response.
before string optional Cursor for previous page. Use `pagination.start_cursor` from a previous response.
per_page integer optional Results per page (1-100)
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_tag_subscriber # Apply a tag to a subscriber identified by email address. 4 params

Apply a tag to a subscriber identified by email address.

Name Type Required Description
email_address string required Subscriber's email address (required)
tag_id integer required The tag ID (required). Use list_tags to find IDs.
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_unsubscribe # Cancel a subscriber's subscription by subscriber ID. 3 params

Cancel a subscriber's subscription by subscriber ID.

Name Type Required Description
subscriber_id integer required The subscriber ID (required). Use list_subscribers or get_subscriber to find IDs.
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_untag_subscriber # Remove a tag from a subscriber by subscriber ID and tag ID. 4 params

Remove a tag from a subscriber by subscriber ID and tag ID.

Name Type Required Description
subscriber_id integer required The subscriber ID (required)
tag_id integer required The tag ID (required). Use list_tags to find IDs.
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_update_account_colors # Update the custom brand color palette for the Kit account. 3 params

Update the custom brand color palette for the Kit account.

Name Type Required Description
colors array required Array of up to 10 hex color codes (e.g. ["#FF6900", "#FCB900"]). Replaces the existing palette entirely.
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_update_broadcast # Update a draft broadcast's subject, content, or audience filter. 10 params

Update a draft broadcast's subject, content, or audience filter.

Name Type Required Description
broadcast_id integer required The broadcast ID (required). Use list_broadcasts to find IDs.
content string optional Email body content in HTML
description string optional Internal description
email_template_id integer optional Email template ID
preview_text string optional Preview text shown in email clients
public boolean optional Whether to publish on the creator's profile page
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
subject string optional Email subject line
subscriber_filter array optional Target audience filter. A single-element array wrapping one filter group (all/any/none). Example: [{ "all": [{ "type": "tag", "ids": [1, 2] }] }]. Only one filter group (all, any, or none) may be populated per request. Filter types allowed: 'tag' or 'segment'. Omit to leave current filter unchanged.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_update_custom_field # Rename a custom subscriber field by ID. 4 params

Rename a custom subscriber field by ID.

Name Type Required Description
custom_field_id integer required The custom field ID (required). Use list_custom_fields to find IDs.
label string required New field label (required)
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_update_sequence # Update sequence settings such as name, send days, or active state. 12 params

Update sequence settings such as name, send days, or active state.

Name Type Required Description
id integer required The sequence ID (required). Use list_sequences to find IDs.
active boolean optional Whether the sequence is active
email_address string optional From email address
email_template_id integer optional Email template ID
hold boolean optional Whether the sequence is on hold
name string optional New sequence name
repeat boolean optional Whether the sequence repeats
send_days array optional Days to send on
send_hour integer optional Hour of day to send (0-23)
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
time_zone string optional Timezone for send scheduling
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_update_sequence_email # Update an existing sequence email's subject, content, delay, or position. 13 params

Update an existing sequence email's subject, content, delay, or position.

Name Type Required Description
id integer required The email ID (required). Use list_sequence_emails to find IDs.
sequence_id integer required The sequence ID (required). Use list_sequences to find IDs.
content string optional Email body content in HTML
delay_unit string optional 'days' or 'hours'
delay_value integer optional Number of days or hours to wait before sending this email. Unit is controlled by delay_unit.
email_template_id integer optional Layout template ID. Use list_email_templates to find IDs.
position integer optional 0-based position in the sequence
preview_text string optional Preview text shown in email clients
published boolean optional Publish or unpublish the email
send_days array optional Days of the week this email may send. To reset to the full weekly schedule, pass all 7 values explicitly.
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
subject string optional Email subject line
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_update_snippet # Update a content snippet's name, content, or archived state. 7 params

Update a content snippet's name, content, or archived state.

Name Type Required Description
id integer required The snippet ID (required). Use list_snippets to find IDs.
archived boolean optional true to archive, false to restore
content string optional New text/Liquid content (inline snippets only)
document_attributes object optional New HTML content (block snippets only)
name string optional New snippet name
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_update_subscriber # Update a subscriber's email, name, or custom field values by subscriber ID. 6 params

Update a subscriber's email, name, or custom field values by subscriber ID.

Name Type Required Description
subscriber_id integer required The subscriber ID (required). Use list_subscribers or filter_subscribers to find IDs.
email_address string optional New email address
fields object optional Custom field values to update as key-value pairs
first_name string optional New first name
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.
kitmcp_update_tag # Rename a tag by ID. 4 params

Rename a tag by ID.

Name Type Required Description
name string required New tag name (required)
tag_id integer required The tag ID (required). Use list_tags to find IDs.
session_id string optional UUID v4 identifier for grouping tool calls in the same conversation. Generate once at the start of the session and reuse it on every call.
user_goal string optional What the creator is trying to accomplish with this tool call. Pick the closest match; use 'unknown' only when no category fits.