Kit Help Center

Kit MCP Tools

A complete reference of every tool the Kit MCP exposes — name, description, safety annotations, and whether it reads or writes data.

Updated this week

The Kit MCP server provides tools to help you access and manage your account. Each tool is annotated with safety hints your AI client uses to decide when to ask for confirmation before acting.

Safety annotations explained

Read-only — the tool does not modify your account.
Destructive — the tool may remove or overwrite data. Your AI client will ask before running these.
Idempotent — running the tool twice with the same input has the same effect as running it once.
Open-world — the tool may interact with external systems (e.g. a webhook URL you supply).

Prompts

Tool name	Description	Annotations	R/W
`list_prompt_suggestions`	List the prompt suggestions the Kit MCP exposes. Useful for AI clients that don't implement the MCP prompts spec directly (e.g. ChatGPT) and need a tools-based discovery path instead.	Read-only, Idempotent	Read

Account

Tool name	Description	Annotations	R/W
`get_account`	Get the current Kit account details including name, plan type, email address, and timezone.	Read-only, Idempotent	Read
`get_account_colors`	Get the brand color palette for this Kit account.	Read-only, Idempotent	Read
`update_account_colors`	Replace the brand color palette for this Kit account.	Idempotent	Write
`get_creator_profile`	Get the creator's public profile information.	Read-only, Idempotent	Read
`get_email_stats`	Get email sending statistics for the account.	Read-only, Idempotent	Read
`get_growth_stats`	Get subscriber growth statistics for the account.	Read-only, Idempotent	Read

Subscribers

Tool name	Description	Annotations	R/W
`bulk_create_subscribers`	Create or update multiple subscribers in a single call (upsert by email address).	Idempotent, Open-world	Write
`bulk_update_subscriber_custom_field_values`	Update custom field values for multiple subscribers in a single call.	Idempotent	Write
`create_subscriber`	Create or update a single subscriber (upsert by email address).	Idempotent	Write
`filter_subscribers`	Filter subscribers by engagement (opens, clicks, sends, deliveries) and/or sign-up date.	Read-only, Idempotent	Read
`get_subscriber`	Get detailed information about a specific subscriber by ID.	Read-only, Idempotent	Read
`get_subscriber_stats`	Get engagement statistics for a specific subscriber.	Read-only, Idempotent	Read
`get_subscriber_tags`	List all tags applied to a specific subscriber.	Read-only, Idempotent	Read
`list_subscribers`	List subscribers with optional filtering, enrichment, and cursor pagination.	Read-only, Idempotent	Read
`unsubscribe`	Unsubscribe a subscriber from the account.	Destructive, Idempotent	Write
`update_subscriber`	Update a single subscriber's details (email, name, or custom fields).	Idempotent	Write

Tags

Tool name	Description	Annotations	R/W
`bulk_tag_subscribers`	Apply a tag to multiple subscribers in a single call.	Idempotent	Write
`bulk_untag_subscribers`	Remove a tag from multiple subscribers in a single call.	Destructive, Idempotent	Write
`create_tag`	Create a new tag.	Idempotent	Write
`list_tag_subscribers`	List all subscribers who have a specific tag.	Read-only, Idempotent	Read
`list_tags`	List all tags in the account.	Read-only, Idempotent	Read
`tag_subscriber`	Apply a tag to a subscriber.	Idempotent	Write
`untag_subscriber`	Remove a tag from a subscriber.	Destructive, Idempotent	Write
`update_tag`	Rename an existing tag.	Idempotent	Write

Segments

Tool name	Description	Annotations	R/W
`list_segments`	List all subscriber segments (saved subscriber filters) in the account.	Read-only, Idempotent	Read

Custom fields

Tool name	Description	Annotations	R/W
`create_custom_field`	Create a new custom field.	Idempotent	Write
`delete_custom_field`	Permanently delete a custom field and its values from all subscribers.	Destructive, Idempotent	Write
`list_custom_fields`	List all custom fields defined in the account.	Read-only, Idempotent	Read
`update_custom_field`	Rename an existing custom field.	Idempotent	Write

Forms

Tool name	Description	Annotations	R/W
`add_subscriber_to_form`	Subscribe someone to a form.	Idempotent, Open-world	Write
`list_form_subscribers`	List subscribers who signed up through a specific form.	Read-only, Idempotent	Read
`list_forms`	List all forms and landing pages in the account.	Read-only, Idempotent	Read

Sequences

Tool name	Description	Annotations	R/W
`create_sequence`	Create a new email sequence (automated email series).	Open-world	Write
`update_sequence`	Update an existing sequence's settings.	Idempotent, Open-world	Write
`delete_sequence`	Permanently delete a sequence.	Destructive, Idempotent	Write
`add_subscriber_to_sequence`	Add a subscriber to an email sequence.	Idempotent, Open-world	Write
`get_sequence`	Get detailed information about a specific sequence.	Read-only, Idempotent	Read
`list_sequence_subscribers`	List subscribers in a specific sequence.	Read-only, Idempotent	Read
`list_sequences`	List all email sequences (automated email series) in the account.	Read-only, Idempotent	Read

Sequence emails

Tool name	Description	Annotations	R/W
`list_sequence_emails`	List all emails in a specific sequence, ordered by position.	Read-only, Idempotent	Read
`get_sequence_email`	Get a specific email within a sequence, including its HTML content.	Read-only, Idempotent	Read
`create_sequence_email`	Add a new email to a sequence.	Open-world	Write
`update_sequence_email`	Update an existing sequence email.	Idempotent, Open-world	Write
`delete_sequence_email`	Remove an email from a sequence.	Destructive, Idempotent	Write

Broadcasts

Tool name	Description	Annotations	R/W
`create_broadcast`	Create a new email broadcast (draft or scheduled).	Open-world	Write
`delete_broadcast`	Delete a broadcast.	Destructive, Idempotent	Write
`get_broadcast`	Get detailed information about a specific broadcast.	Read-only, Idempotent	Read
`get_broadcast_clicks`	Get click data for a specific broadcast.	Read-only, Idempotent	Read
`get_broadcast_stats`	Get performance statistics for a specific broadcast.	Read-only, Idempotent	Read
`get_broadcasts_stats`	Get per-broadcast statistics across the account.	Read-only, Idempotent	Read
`list_broadcasts`	List all broadcasts (email campaigns) in the account.	Read-only, Idempotent	Read
`update_broadcast`	Update an existing broadcast's content or schedule.	Idempotent, Open-world	Write

Email templates

Tool name	Description	Annotations	R/W
`list_email_templates`	List all email templates available in the account.	Read-only, Idempotent	Read

Snippets

Tool name	Description	Annotations	R/W
`list_snippets`	List all snippets in the account.	Read-only, Idempotent	Read
`get_snippet`	Get a specific snippet by ID, including its content and document.	Read-only, Idempotent	Read
`create_snippet`	Create a new reusable snippet.	—	Write
`update_snippet`	Update an existing snippet.	Idempotent	Write

Posts

Tool name	Description	Annotations	R/W
`get_post`	Get detailed information about a specific post.	Read-only, Idempotent	Read
`list_posts`	List all published posts on the creator's profile.	Read-only, Idempotent	Read

Purchases

Tool name	Description	Annotations	R/W
`get_purchase`	Get details about a specific purchase.	Read-only, Idempotent	Read
`list_purchases`	List all purchases tracked in the account.	Read-only, Idempotent	Read

Webhooks

Tool name	Description	Annotations	R/W
`create_webhook`	Create a webhook that fires HTTP requests to an external URL when events occur.	Open-world	Write
`delete_webhook`	Delete a webhook.	Destructive, Idempotent	Write
`list_webhooks`	List all webhooks configured in the account.	Read-only, Idempotent	Read

Related Articles

How to connect the Kit MCP to your AI tools