# Chiirp MCP > Chiirp lets you manage customer relationships and lead follow-ups through automated text, email, and voicemail campaigns. Connect your CRM data to any AI client and use natural conversation to create new contacts, segment users with tags, and monitor entire campaign sequences at scale. ## Overview - **Category:** marketing-automation - **Price:** Free - **Tags:** sms-marketing, drip-campaigns, lead-nurturing, crm, automated-followup, contact-segmentation ## Description Need to keep up with hundreds of leads? This MCP connects directly to your Chiirp account so you can manage all your outreach from within your preferred agent. Instead of jumping between a CRM dashboard and an email sender, your AI client handles the heavy lifting. You use natural language commands to build out your customer records, check which campaigns are running, and see exactly where each lead stands in their automated journey. This means you don't just send messages; you nurture relationships systematically, making sure no potential sale falls through the cracks. It’s basically an entire marketing automation platform available as a simple chat command, hosted on Vinkius so your agent can talk to it regardless of what app they're using. ## Tools ### apply_tag Applies a descriptive label to a contact, which helps segment your list for targeted campaigns. ### check_chiirp_status Verifies that the MCP has connected properly and that Chiirp is running correctly. ### create_contact Adds a brand new person to your contact list, requiring a phone number as its unique ID. ### get_contact Pulls up all the details for one specific person in your CRM. ### get_profile Retrieves general information about your overall Chiirp account setup. ### list_campaigns Shows you a list of all the automated SMS and email campaigns running in your system. ### list_contacts Retrieves a full list of every single contact currently stored in your account. ### list_sequences Lists all the multi-step automation workflows or drip sequences you have set up. ### list_tags Shows every available tag you can use for segmenting your contacts. ### remove_tag Takes a specific label off an existing contact record when they change status or need re-evaluation. ### search_contacts Finds and retrieves details for a contact using only their phone number as the key search term. ### update_contact Changes specific pieces of information on an existing contact record without touching everything else. ## Prompt Examples **Prompt:** ``` List all my contacts in Chiirp. ``` **Response:** ``` You have 247 contacts. The most recent are: John Smith (+1-555-0101, tagged 'hot-lead'), Maria Garcia (+1-555-0202, tagged 'hvac-customer'), and David Lee (+1-555-0303). ``` **Prompt:** ``` Apply the 'hot-lead' tag to the contact with phone +1-555-0303. ``` **Response:** ``` Done! The 'hot-lead' tag has been applied to David Lee (+1-555-0303). This triggered the 'Hot Lead Follow-up' drip sequence automatically. ``` **Prompt:** ``` Create a new contact for +1-555-0404 named Sarah Johnson. ``` **Response:** ``` New contact created: Sarah Johnson (+1-555-0404). The contact is now in your Chiirp CRM and ready for tagging or campaign enrollment. ``` ## Capabilities ### Build and update customer records Create entirely new contacts or adjust existing ones with specific details like names and phone numbers. ### Segment leads by group tags Apply descriptive labels to a contact, which automatically triggers different follow-up campaigns based on the tag (e.g., 'hot-lead' or 'needs-quote'). ### Audit and view campaign performance List all active drip campaigns and sequences, checking engagement data to see what methods are working. ### Search for specific contact details Find a person's record quickly using their phone number or by listing all contacts in the system. ### Review account status and profile data Check if your API connection is working and view basic account information to confirm connectivity. ## Use Cases ### The 'Cold Lead' Follow-Up A home service owner gets a new call from an interested lead. Instead of writing down the details manually, they ask their agent to `create_contact` using the phone number and name. They then immediately use `apply_tag` to mark them as 'New Prospect', which starts the automated follow-up sequence. ### The Reclassified Customer A marketing manager notices a prospect has been unresponsive for two weeks. They ask the agent to `remove_tag` from 'Hot Lead' and then use `update_contact` to change their status to 'Nurture Track', preventing automated messages from continuing. ### The Data Checkup A sales team needs to review the progress of all high-value clients. They ask the agent to `list_contacts` and filter for contacts with the 'Enterprise' tag, allowing them to see who needs a personal follow-up call. ### The Campaign Audit Before sending out a major holiday campaign, an operations lead asks the agent to `list_sequences` and `list_campaigns`. This confirms all drip workflows are active and correctly configured for the launch date. ## Benefits - Stop losing leads between departments. By using `get_contact` and `update_contact`, your agent keeps the entire history of a person in one place, whether it's sales notes or service details. - Improve segmentation instantly. Instead of manually updating records, use `apply_tag` to categorize contacts, which immediately triggers the right automated follow-up sequence. - Audit your outreach effort with ease. Simply running `list_campaigns` shows you all active SMS and drip campaigns, so you always know what's sending messages. - Save time finding records. If you only have a phone number, use `search_contacts`. It’s faster than browsing through hundreds of contacts when you need to make an immediate follow-up. - Maintain data cleanliness by running `list_contacts` and checking for outdated or incomplete entries before a major campaign launch. ## How It Works The bottom line is that you tell your agent what to do using plain text, and Chiirp handles the communication with your account. 1. Subscribe to this MCP on Vinkius. 2. Enter the Chiirp API token from your dashboard into the agent's settings. 3. Start chatting with your AI client and ask it to perform a task, like 'List all contacts tagged as hot-lead.' ## Frequently Asked Questions **How do I check if Chiirp is connected using the `check_chiirp_status` tool?** Run the `check_chiirp_status` tool. It immediately confirms whether your API token is valid and if there are any connection errors preventing you from running other commands. **Can I update a contact using the `update_contact` tool?** Yes, use `update_contact` to change specific details on an existing record. Remember that only the fields you provide will be changed; everything else stays put. **How do I find a contact by phone number? Use `search_contacts`?** `search_contacts` is the fastest way to pull up details when you know the phone number. It skips searching all records and gets straight to the relevant profile. **What if I want to group contacts for a specific campaign? Should I use `apply_tag`?** Yes, using `apply_tag` is how you segment your audience. You apply tags like 'Q3-Sale' so that when you list campaigns, only the relevant ones are visible. **Can I see all my active automation workflows? Use `list_sequences`.** Running `list_sequences` shows every multi-step drip workflow. This lets you monitor which automated paths your leads are currently following in the CRM. **If I need to add a completely new lead to Chiirp, what details are required when using the `create_contact` tool?** You must provide a phone number to create any contact. The system uses that phone number as the unique identifier for the record. This ensures the new lead immediately enters your CRM and is ready for tagging or campaign enrollment. **How do I get an overview of all my existing leads and contacts at once, using the `list_contacts` tool?** The `list_contacts` tool returns a comprehensive summary of every contact in your account. This allows you to quickly verify lead counts and review basic metadata without having to search for individual numbers. **What tools should I use to view all current SMS and drip campaigns, like `list_campaigns`?** Using `list_campaigns` gives you a roster of every active marketing campaign. You can check the names, status, and associated engagement data for your automated text or email sequences. **Can I search for a contact by phone number?** Yes! Use `search_contacts` with the phone number to find matching contacts in your Chiirp database. **How do I add a tag to trigger an automation?** Use `apply_tag` with the contact's phone number and the tag ID. If the tag is linked to an automation sequence in Chiirp, it will trigger automatically. **Can I view my active campaigns?** Yes! Use `list_campaigns` to see all SMS and drip campaigns, or `list_sequences` to view automation workflows with their statuses.