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 |
| Get the canonical catalog of suggested workflows for this Kit account. | Read-only, Idempotent | Read |
Account
Tool name | Description | Annotations | R/W |
| Get details for the authenticated Kit account. | Read-only, Idempotent | Read |
| Get the brand color palette for this Kit account. | Read-only, Idempotent | Read |
| Replace the brand color palette for this Kit account. | Idempotent | Write |
| Get the creator's newsletter site information. | Read-only, Idempotent | Read |
| Get account-level email sending statistics (averages across the whole account, last 90 days), not per-broadcast stats. For one broadcast's performance use get_stats_for_a_broadcast; for many broadcasts at once use get_stats_for_a_list_of_broadcasts. | Read-only, Idempotent | Read |
| Get subscriber growth statistics for the account. | Read-only, Idempotent | Read |
Subscribers
Tool name | Description | Annotations | R/W |
| Create or update multiple subscribers in a single call (upsert by email address). Use this instead of calling create_subscriber repeatedly. | Idempotent, Open-world | Write |
| Update custom field values for multiple subscribers in a single call. Use this instead of calling update_subscriber repeatedly. | Idempotent | Write |
| Create or update a single subscriber (upsert by email address). For creating more than one subscriber, use bulk_create_subscribers instead. | Idempotent | Write |
| Filter subscribers by engagement (opens, clicks, sends, deliveries), sign-up date, subscriber state, tag membership, primary location, and/or original signup attribution. Results can be enriched via | Read-only, Idempotent | Read |
| Get detailed information about a specific subscriber by ID. | Read-only, Idempotent | Read |
| Get engagement statistics for a specific subscriber by ID. Returns (under | Read-only, Idempotent | Read |
| List subscribers with optional filtering, enrichment, and cursor pagination. Use | Read-only, Idempotent | Read |
| List all tags applied to a specific subscriber. | Read-only, Idempotent | Read |
| Unsubscribe a subscriber from the account. | Destructive, Idempotent | Write |
| Update a single subscriber's details (email, name, or custom fields). For updating custom fields on more than one subscriber, use bulk_update_subscriber_custom_field_values instead. | Idempotent | Write |
Tags
Tool name | Description | Annotations | R/W |
| Create multiple tags in a single call (upsert by name). Use this instead of calling create_tag repeatedly when setting up a tag taxonomy or importing many tags at once. | Idempotent | Write |
| Delete multiple tags in a single call by ID. Use this to clean up a tag taxonomy or remove tags in bulk. | Destructive, Idempotent | Write |
| Remove a tag from multiple subscribers in a single call. Prefer this over repeated remove_tag_from_subscriber calls when untagging more than a handful of subscribers. | Destructive, Idempotent | Write |
| Apply a tag to multiple subscribers in a single call. Prefer this over repeated tag_subscriber calls when tagging more than a handful of subscribers. | Idempotent | Write |
| Create a new tag. For creating more than one tag, use bulk_create_tags instead. | Idempotent | Write |
| List all subscribers who have a specific tag. Returns a slim response by default; add | Read-only, Idempotent | Read |
| List all tags in the account. Add | Read-only, Idempotent | Read |
| Remove a tag from a subscriber. For removing a tag from more than one subscriber at once, use bulk_remove_tags_from_subscribers instead. | Destructive, Idempotent | Write |
| Apply a tag to a subscriber. For tagging more than one subscriber at once, use bulk_tag_subscribers instead. | Idempotent | Write |
| Rename an existing tag. | Idempotent | Write |
Segments
Tool name | Description | Annotations | R/W |
| List all subscriber segments (saved subscriber filters) in the account. | Read-only, Idempotent | Read |
Custom fields
Tool name | Description | Annotations | R/W |
| Create multiple custom field definitions in a single call (upsert by label). Use this instead of calling create_custom_field repeatedly when setting up a new account or importing a field schema. | Idempotent | Write |
| Create a new custom field. For creating more than one custom field, use bulk_create_custom_fields instead. | Idempotent | Write |
| Permanently delete a custom field and its values from all subscribers. | Destructive, Idempotent | Write |
| List all custom fields defined in the account. | Read-only, Idempotent | Read |
| Rename an existing custom field. | Idempotent | Write |
Forms
Tool name | Description | Annotations | R/W |
| Subscribe someone to a form. For subscribing more than one subscriber, use bulk_add_subscribers_to_forms instead. | Idempotent, Open-world | Write |
| Subscribe multiple existing subscribers to one or more forms in a single call, triggering the form's confirmation or incentive email for each. Use this instead of calling add_subscriber_to_form repeatedly for onboarding or lead-import workflows. | Idempotent, Open-world | Write |
| List all forms and landing pages in the account. Add | Read-only, Idempotent | Read |
| List subscribers who signed up through a specific form. Returns a slim response by default; add | Read-only, Idempotent | Read |
Email Sequences
Tool name | Description | Annotations | R/W |
| Add a subscriber to an email sequence. Creates the subscriber if they don't exist. | Idempotent, Open-world | Write |
| Create a new email sequence (automated email series). | Open-world | Write |
| Permanently delete a sequence. All subscribers will be removed from the sequence. | Destructive, Idempotent | Write |
| Get detailed information about a specific sequence. Add | Read-only, Idempotent | Read |
| List all email sequences (automated email series) in the account. Add | Read-only, Idempotent | Read |
| List subscribers in a specific sequence. Returns a slim response by default; add | Read-only, Idempotent | Read |
| Update an existing sequence's settings. | Idempotent, Open-world | Write |
Email Sequence emails
Tool name | Description | Annotations | R/W |
| Add a new email to a sequence. | Open-world | Write |
| Remove an email from a sequence. Remaining emails are automatically re-ordered. | Destructive, Idempotent | Write |
| Get a specific email within a sequence, including its HTML content. Add | Read-only, Idempotent | Read |
| List all emails in a specific sequence, ordered by position. Content is omitted by default; pass | Read-only, Idempotent | Read |
| Update an existing sequence email. Only fields you provide are changed (patch semantics). | Idempotent, Open-world | Write |
Broadcasts
Tool name | Description | Annotations | R/W |
| Create a draft email broadcast. | Open-world | Write |
| Delete a broadcast. Cannot delete broadcasts that are sending or completed. | Destructive, Idempotent | Write |
| Get detailed information about a specific broadcast. | Read-only, Idempotent | Read |
| Get click data for a specific broadcast. | Read-only, Idempotent | Read |
| Get performance statistics for a single broadcast by ID. Requires a broadcast ID; use list_broadcasts first to find IDs. For stats across many broadcasts at once, use get_stats_for_a_list_of_broadcasts. | Read-only, Idempotent | Read |
| Performance analytics across many broadcasts at once. Use this when the goal is performance analysis or building a stats leaderboard across multiple sends. This is not the listing tool: to browse or find broadcasts, use list_broadcasts. For the stats of a single broadcast, use get_stats_for_a_broadcast after finding its ID with list_broadcasts. | Read-only, Idempotent | Read |
| List all broadcasts (email campaigns) in the account. Add | Read-only, Idempotent | Read |
| Update an existing broadcast's content (subject, body, preview text, segment, template, etc.). | Idempotent, Open-world | Write |
Email templates
Tool name | Description | Annotations | R/W |
| List all email templates available in the account. | Read-only, Idempotent | Read |
Snippets
Tool name | Description | Annotations | R/W |
| List all snippets in the account. | Read-only, Idempotent | Read |
| Get a specific snippet by ID, including its content and document. | Read-only, Idempotent | Read |
| Create a new reusable snippet. | — | Write |
| Update an existing snippet. Only fields you provide are changed (patch semantics). | Idempotent | Write |
Posts
Tool name | Description | Annotations | R/W |
| Get detailed information about a specific post. | Read-only, Idempotent | Read |
| List all published posts on the creator's newsletter site. | Read-only, Idempotent | Read |
Products
Tool name | Description | Annotations | R/W |
| List the account's Commerce products — everything the creator sells, including tip jars. | Read-only, Idempotent | Read |
| List the Kit tax codes used to classify a product's tax category, i.e. to choose a product's | Read-only, Idempotent | Read |
Purchases
Tool name | Description | Annotations | R/W |
| Get details about a specific purchase. | Read-only, Idempotent | Read |
| List all purchases tracked in the account. | Read-only, Idempotent | Read |
Domains
Tool name | Description | Annotations | R/W |
| List the account's domains. | Read-only, Idempotent | Read |
Webhooks
Tool name | Description | Annotations | R/W |
| Create a webhook that fires HTTP requests to an external URL when events occur. | Open-world | Write |
| Delete a webhook. It will stop firing for all future events. | Destructive, Idempotent | Write |
| List all webhooks configured in the account. | Read-only, Idempotent | Read |