AI Connector Tools

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

Updated this week

The AI Connectors 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`	Get the canonical catalog of suggested workflows for this Kit account.	Read-only, Idempotent	Read

Account

Tool name	Description	Annotations	R/W
`get_current_account`	Get details for the authenticated Kit account.	Read-only, Idempotent	Read
`list_colors`	Get the brand color palette for this Kit account.	Read-only, Idempotent	Read
`update_colors`	Replace the brand color palette for this Kit account.	Destructive, Idempotent	Write
`get_creator_profile`	Get the creator's newsletter site information.	Read-only, Idempotent	Read
`get_email_stats`	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_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). Use this instead of calling create_subscriber repeatedly.	Destructive, Idempotent, Open-world	Write
`bulk_update_subscriber_custom_field_values`	Update custom field values for multiple subscribers in a single call. Use this instead of calling update_subscriber repeatedly.	Destructive, Idempotent, Open-world	Write
`create_subscriber`	Create or update a single subscriber (upsert by email address). For creating more than one subscriber, use bulk_create_subscribers instead.	Destructive, Idempotent, Open-world	Write
`filter_subscribers`	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 `include` (tags, location, attribution, or engagement stats over a window).	Read-only, Idempotent	Read
`get_subscriber`	Get detailed information about a specific subscriber by ID.	Read-only, Idempotent	Read
`list_stats_for_a_subscriber`	Get engagement statistics for a specific subscriber by ID. Returns (under `subscriber.stats`): `sent`, `opened`, `clicked`, `bounced`, `open_rate`, `click_rate`, `last_sent`, `last_opened`, `last_clicked`, `sends_since_last_open`, `sends_since_last_click`. Use `email_sent_after`/`email_sent_before` (YYYY-MM-DD) to scope to a date range.	Read-only, Idempotent	Read
`list_subscribers`	List subscribers with optional filtering, enrichment, and cursor pagination. Use `include` to enrich each subscriber: `fields` adds custom field values; `tags`, `location`, `attribution`, and `canceled_at` add their respective data in a single call.	Read-only, Idempotent	Read
`list_tags_for_a_subscriber`	List all tags applied to a specific subscriber.	Read-only, Idempotent	Read
`unsubscribe`	Unsubscribe a subscriber from the account.	Destructive, Idempotent, Open-world	Write
`update_subscriber`	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.	Destructive, Idempotent, Open-world	Write

Tags

Tool name	Description	Annotations	R/W
`bulk_create_tags`	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, Open-world	Write
`bulk_delete_tags`	Delete multiple tags in a single call by ID. Use this to clean up a tag taxonomy or remove tags in bulk. Asks for confirmation before deleting.	Destructive, Idempotent, Open-world	Write
`bulk_remove_tags_from_subscribers`	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, Open-world	Write
`bulk_tag_subscribers`	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.	Destructive, Idempotent, Open-world	Write
`create_tag`	Create a new tag. For creating more than one tag, use bulk_create_tags instead.	Idempotent, Open-world	Write
`list_subscribers_for_tag`	List all subscribers who have a specific tag. Returns a slim response by default; add `"fields"` to `include` when you need custom field values.	Read-only, Idempotent	Read
`list_tags`	List all tags in the account. Add `subscriber_count` to `include` to also get each tag’s active subscriber count.	Read-only, Idempotent	Read
`remove_tag_from_subscriber`	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, Open-world	Write
`tag_subscriber`	Apply a tag to a subscriber. For tagging more than one subscriber at once, use bulk_tag_subscribers instead.	Destructive, Idempotent, Open-world	Write
`update_tag_name`	Rename an existing tag.	Destructive, Idempotent, Open-world	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
`bulk_create_custom_fields`	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, Open-world	Write
`create_custom_field`	Create a new custom field. For creating more than one custom field, use bulk_create_custom_fields instead.	Idempotent, Open-world	Write
`delete_custom_field`	Permanently delete a custom field and its values from all subscribers. Asks for confirmation before deleting.	Destructive, Idempotent, Open-world	Write
`list_custom_fields`	List all custom fields defined in the account.	Read-only, Idempotent	Read
`update_custom_field`	Rename an existing custom field.	Destructive, Idempotent	Write

Forms

Tool name	Description	Annotations	R/W
`add_subscriber_to_form`	Subscribe an existing subscriber to a form (create them first with `create_subscriber` if needed). For more than one subscriber, use `bulk_add_subscribers_to_forms` instead.	Destructive, Idempotent, Open-world	Write
`bulk_add_subscribers_to_forms`	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.	Destructive, Idempotent, Open-world	Write
`list_forms`	List all forms and landing pages in the account. Add `subscriber_count` to `include` to also get each form’s active subscriber count. Resolving form URLs can queue a public rebuild of saved page content.	Destructive, Idempotent, Open-world	Write
`list_subscribers_for_form`	List subscribers who signed up through a specific form. Returns a slim response by default; add `"fields"` to `include` when you need custom field values.	Read-only, Idempotent	Read

Landing pages

Tool name	Description	Annotations	R/W
`list_landing_pages`	List the account's landing pages (classic builder and current v2 editor), newest first. `editor_version` shows which pages can be read and edited via the API; classic (v1) pages are listed only.	Read-only, Idempotent	Read
`get_landing_page`	Get an existing landing page. For v2 pages this returns the content as Kit-JSON (`content_tree`, `theme`, `built_with_badge`) plus `is_clean` and `warnings` showing anything the format can't express. Resolving the public URL can queue a public rebuild of saved content.	Destructive, Idempotent, Open-world	Write
`create_landing_page`	Create a landing page from a Kit-JSON `content_tree` (call `get_landing_page_schema` first), with an optional `theme` and `built_with_badge`. Creation queues a public build, so treat the content as public. Share the editor link so the creator can review it.	Open-world	Write
`update_landing_page`	Replace the content of an existing v2 landing page with the `content_tree` you send (a full replace); `theme` and `built_with_badge` only change the keys you pass. If the page holds content Kit-JSON can't express, the update is refused until `allow_content_loss: true` is sent after the creator agrees.	Destructive, Idempotent, Open-world	Write
`get_landing_page_schema`	Return the Kit-JSON schemas for a landing page's `content_tree` and `theme`: the exact shapes `create_landing_page` and `update_landing_page` accept. Call this first when building or editing a page.	Read-only, Idempotent	Read

Email Sequences

Tool name	Description	Annotations	R/W
`add_subscriber_to_sequence`	Add an existing subscriber to an email sequence (create them first with `create_subscriber` if needed). The sequence must be active.	Destructive, Idempotent, Open-world	Write
`create_sequence`	Create a new email sequence (automated email series).	Open-world	Write
`delete_sequence`	Permanently delete a sequence. All subscribers will be removed from the sequence. Asks for confirmation before deleting.	Destructive, Idempotent, Open-world	Write
`get_sequence`	Get detailed information about a specific sequence. Add `"stats"` to `include` to also get deliverability counts and rates (opens, clicks, bounces, complaints, unsubscribes) plus the unsubscriber count (matches the sequences dashboard).	Read-only, Idempotent	Read
`list_sequences`	List all email sequences (automated email series) in the account. Add `"stats"` to `include` to also get per-sequence deliverability counts and rates (opens, clicks, bounces, complaints, unsubscribes) plus the unsubscriber count (matches the sequences dashboard).	Read-only, Idempotent	Read
`list_subscribers_for_sequence`	List subscribers in a specific sequence. Returns a slim response by default; add `"fields"` to `include` when you need custom field values.	Read-only, Idempotent	Read
`update_sequence`	Update an existing sequence's settings.	Destructive, Idempotent, Open-world	Write

Email Sequence emails

Tool name	Description	Annotations	R/W
`create_sequence_email`	Add a new email to a sequence, as HTML `content` or structured `content_tree` blocks (call `get_sequence_email_schema` first). Saved as an unpublished draft until `published: true` is passed.	Destructive, Open-world	Write
`delete_sequence_email`	Remove an email from a sequence. Remaining emails are automatically re-ordered. Asks for confirmation before deleting.	Destructive, Idempotent, Open-world	Write
`get_sequence_email`	Get a specific email within a sequence, including its HTML content. Add `"stats"` to `include` to also get this email’s deliverability counts and rates (opens, clicks, bounces, complaints, unsubscribes). Add `content_tree` to `include` to also get the body as structured Kit-JSON blocks.	Read-only, Idempotent	Read
`list_sequence_emails`	List all emails in a specific sequence, ordered by position. Content is omitted by default; pass `include_content: true` to include it. Add `"stats"` to `include` for per-email deliverability counts and rates (opens, clicks, bounces, complaints, unsubscribes).	Read-only, Idempotent	Read
`update_sequence_email`	Update an existing sequence email. Only fields you provide are changed. Content changes (`content`, `content_tree`, `email_template_id`) are saved as an unpublished draft until `published: true` is passed. A `content_tree` replace that would lose content is refused until `allow_content_loss: true` is sent after the creator agrees.	Destructive, Idempotent, Open-world	Write
`get_sequence_email_schema`	Return the Kit-JSON schema for a sequence email's `content_tree` and `theme`, tailored to the `email_template_id` you plan to use. Call this first when building or editing a sequence email's structured content.	Read-only, Idempotent	Read

Broadcasts

Tool name	Description	Annotations	R/W
`create_broadcast`	Create a draft email broadcast. The body can be HTML `content` or structured `content_tree` blocks (call `get_broadcast_schema` first), with an optional email-wide `theme`. Scheduling and sending stay in Kit's editor via the returned `confirm_url`.	Open-world	Write
`delete_broadcast`	Delete a broadcast. Cannot delete broadcasts that are sending or completed.	Destructive, Idempotent, Open-world	Write
`get_broadcast`	Get detailed information about a specific broadcast. Add `content_tree` to `include` to also get the body as structured Kit-JSON blocks, the email-wide `theme`, and whether the tree fully represents the stored content.	Read-only, Idempotent	Read
`get_link_clicks_for_a_broadcast`	Get click data for a specific broadcast.	Read-only, Idempotent	Read
`get_stats_for_a_broadcast`	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
`get_stats_for_a_list_of_broadcasts`	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_broadcasts`	List all broadcasts (email campaigns) in the account. Add `"content"` to `include` when you need full details (HTML content, targeting) across many broadcasts at once.	Read-only, Idempotent	Read
`update_broadcast`	Update an existing broadcast's subject, body, preview text, segment or template. Accepts HTML `content` or structured `content_tree`. An update that would lose content the structured format can't express, or a template switch that would discard the body, is refused until `allow_content_loss: true` is sent after the creator agrees. Content A/B tests can't have their body rewritten here.	Destructive, Idempotent, Open-world	Write
`get_broadcast_schema`	Return the Kit-JSON schema for a broadcast's `content_tree` and `theme`, tailored to the `email_template_id` you plan to use. Call this first when building or editing a broadcast's structured content.	Read-only, Idempotent	Read

Email templates

Tool name	Description	Annotations	R/W
`list_email_templates`	List all email templates available in the account, with each template's `category` ("HTML", "Classic" or "Starting point"). Starting point templates are pre-designed layouts to draft a styled broadcast from; call `get_email_template` next.	Read-only, Idempotent	Read
`get_email_template`	Get a single email template's default body, as HTML `content` and, with `content_tree` in `include`, as structured Kit-JSON blocks with its `theme`. Use it to draft a broadcast or sequence email from a Starting point template's design.	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.	Open-world	Write
`update_snippet`	Update an existing snippet. Only fields you provide are changed (patch semantics).	Destructive, Idempotent, Open-world	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 newsletter site.	Read-only, Idempotent	Read

Products

Tool name	Description	Annotations	R/W
`list_products`	List the account's Commerce products — everything the creator sells, including tip jars.	Read-only, Idempotent	Read
`list_tax_codes`	List the Kit tax codes used to classify a product's tax category, i.e. to choose a product's `tax_code_id` when creating or updating a product.	Read-only, Idempotent	Read
`get_product`	Fetch a single Commerce product by ID, including its prices, tax settings, `edit_url` and public page `url`.	Read-only, Idempotent	Read
`create_product`	Create a Commerce product the creator can sell: a digital download, an external URL, a paid newsletter or a tip jar. Needs a verified domain for the product page; Stripe must be connected in Kit before it can take payments. Prices and billing model always come from the creator.	Open-world	Write
`update_product`	Update a Commerce product. Only the fields you pass change; the pricing model, currency and fulfilment type are fixed at creation. Passing `pricing` replaces the product's plans wholesale.	Destructive, Idempotent, Open-world	Write

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

Domains

Tool name	Description	Annotations	R/W
`list_domains`	List the account's domains.	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. It will stop firing for all future events.	Destructive, Idempotent, Open-world	Write
`list_webhooks`	List all webhooks configured in the account.	Read-only, Idempotent	Read

Did this answer your question?

Related Articles

How to connect the AI Connectors to your AI tools