# Kit (ConvertKit) MCP > Kit (ConvertKit) MCP Server manages your email marketing operations. Use your AI agent to read subscriber profiles, apply tags, list forms, and check campaign metrics directly. It lets you manage entire email audiences and monitor broadcast performance without opening the Kit dashboard. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** newsletter, subscriber-management, audience-segmentation, broadcast-campaigns, engagement-metrics, creator-economy ## Description Manages your email marketing ops through your AI agent. You can read subscriber profiles, apply tags, list forms, and check campaign metrics directly. This lets you handle your entire audience and monitor broadcast performance without opening the Kit dashboard. **Getting Subscriber Data** You can pull a full list of all your current email subscribers using `list_subscribers`. To check a specific person's profile or their current tags, use `get_subscriber_details` or `search_subscriber_by_id` with their unique ID. You can also update a subscriber's metadata or custom fields using `update_subscriber`. **Segmenting and Tagging** To organize your audience, you can apply a specific tag to a subscriber based on their email using `apply_tag_to_subscriber`. You'll see every tag you've got available by running `list_all_tags`. You can also see every opt-in form you've built with `list_optin_forms`, and you'll always know which automated email sequences are running by listing them with `list_email_sequences`. **Onboarding Leads** When a new lead signs up, you can subscribe them to a specific form using `add_subscriber_to_form`. **Reviewing Audience Size** You can get a high-level summary of your total subscriber count and growth by running `get_account_growth_summary`. ## Tools ### add_subscriber_to_form Subscribes a new person to a specified form. ### apply_tag_to_subscriber Applies a specific tag to a subscriber based on their email address. ### get_account_growth_summary Retrieves a high-level summary of your total subscriber count and growth. ### get_subscriber_details Gets detailed information for a single subscriber. ### list_all_tags Lists every available audience tag in your account. ### list_email_sequences Lists all automated email sequences you have set up. ### list_optin_forms Lists every opt-in form available on your account. ### list_subscribers Lists all of your current email subscribers. ### search_subscriber_by_id Retrieves a subscriber's details using their unique numeric ID. ### update_subscriber Updates a subscriber's metadata or custom fields. ## Prompt Examples **Prompt:** ``` Get the profile and tags for 'john.doe@example.com'. ``` **Response:** ``` Subscriber 'John Doe' is active. Tags: 'Welcome Sequence Completed', 'VIP Customers'. Last broadcast interaction: 3 days ago. ``` **Prompt:** ``` Show the open rate and clicks from my latest broadcast. ``` **Response:** ``` Your latest broadcast 'Monthly Creator Tips' was sent to 14,500 subscribers. Open rate: 42.1% (6,104 opens). Unique clicks: 1,215 (CTR: 8.3%). Want me to check the top performing link? ``` **Prompt:** ``` List all tags available in my Kit account so I can categorize new leads. ``` **Response:** ``` I've retrieved 12 tags from your account, including 'Newsletter Subscriber', 'Ebook Download', and 'Webinar-2024-Attendee'. Which tag should we apply to the current segment? ``` ## Capabilities ### Check a specific subscriber's data Retrieve a user's profile and current tags using `get_subscriber_details` or `search_subscriber_by_id`. ### Update user segments and tags Apply tags to subscribers or update their metadata fields directly using `apply_tag_to_subscriber` or `update_subscriber`. ### List all audience assets See all available tags, opt-in forms, and email sequences using `list_all_tags`, `list_optin_forms`, and `list_email_sequences`. ### Onboard new leads Subscribe a new person to a specific form using `add_subscriber_to_form`. ### Review audience size Get a high-level count and summary of your total subscriber count via `get_account_growth_summary`. ## Use Cases ### Need to find out why a user isn't opening emails. A user asks: 'Check John Doe's profile.' Your agent runs `get_subscriber_details` and returns their full profile, including their current tags. You can then check the tags to see if they belong to an inactive segment, solving the mystery instantly. ### Need to segment users for a new product launch. The marketing manager needs to target only 'Webinar Attendees' who signed up last month. They ask the agent to list tags, run `list_all_tags`, and then use the resulting tags to filter the list of subscribers, ensuring the campaign hits the right people. ### Need to clean up stale or incorrect subscriber data. A support agent discovers a user's custom field is outdated. They use `search_subscriber_by_id` to get the user's ID, and then run `update_subscriber` to fix the metadata. The data is clean, and the user gets the right sequence. ### Need to launch a campaign based on current growth. A creator needs to know how many subs they have before setting a goal. They ask the agent to run `get_account_growth_summary`. The result gives them the current count, letting them plan the next steps for their newsletter. ## Benefits - Check a user's profile and tags instantly. Instead of digging through the dashboard to find a user's history, use `get_subscriber_details` to pull all their data right from your agent. - Target audiences precisely. Use `list_all_tags` to see every tag you have, and then use `apply_tag_to_subscriber` to segment users based on recent actions. - Monitor campaign performance without logging in. You can check open rates and click-through metrics for recent sends by listing email sequences or running targeted queries. - Handle new sign-ups instantly. When a lead converts, use `add_subscriber_to_form` to get them into the right list without manual work. - Keep track of growth. Get a quick, high-level view of your total audience size using `get_account_growth_summary` before starting a campaign. ## How It Works The bottom line is, your AI agent runs the API calls for you, letting you manage complex email marketing tasks with conversation. 1. Add the Kit integration to your AI toolset and provide your Kit API Secret (found in Settings > Advanced). 2. Ask your AI client to perform a marketing action (e.g., 'Find all users who downloaded the ebook'). 3. The agent executes the necessary tools (`list_all_tags`, `list_subscribers`, etc.) and provides the resulting data to you. ## Frequently Asked Questions **How do I use the `apply_tag_to_subscriber` tool?** You must provide the subscriber's email and the exact tag name. For example: 'Apply the 'VIP' tag to john@example.com.' The agent runs the tool and confirms if the tag was added. **Can I check a subscriber's full profile using `get_subscriber_details`?** Yes, `get_subscriber_details` pulls all known metadata, including their activity history and custom field values, giving you a complete view of the user. **What is the best way to find out how many people I have?** Use `get_account_growth_summary`. This tool provides a quick, high-level count of your total subscribers, which is faster than listing every single person with `list_subscribers`. **How do I make sure a new lead is added correctly?** Use `add_subscriber_to_form` and specify the exact form ID or name. This ensures the lead is added to the correct list and funnel immediately. **What tools can I use to list all the audience tags using `list_all_tags`?** You use the `list_all_tags` tool to see every tag available in your account. This is useful for seeing what segmentation options you already have, like 'Webinar Attendee' or 'VIP Customer'. **How can I check the status of my automated emails using `list_email_sequences`?** The `list_email_sequences` tool shows you a list of all automated email sequences. It lets you verify if a sequence is active, paused, or needs updating. **What information does `update_subscriber` handle for a user?** `update_subscriber` lets you change a user's metadata or custom fields. You can use this to correct old data or add specific information that isn't covered in their basic profile. **If I need to find a subscriber by their numeric ID, should I use `search_subscriber_by_id`?** Yes, `search_subscriber_by_id` retrieves a subscriber using only their unique numeric ID. This is faster than searching by email if you have the ID readily available. **How do I find my Kit API Secret?** Log in to Kit, go to **Settings > Advanced**. Under 'API', click **Show** next to API Secret, copy the string, and paste it below. **Why is the API Secret required instead of the standard API Key?** The API Key only provides read access to public forms. The API Secret grants full access to manage subscribers, tags, and broadcast data as needed by this integration. **Can the agent send broadcast emails?** No. For safety, the integration is read/manage only. The agent can check campaign metrics and manage tags, but actual email sending must be done via the Kit dashboard.