# Chiirp MCP MCP > Chiirp manages lead automation through text, email, and voicemail campaigns. Use this MCP to let your AI agent interact with a live CRM, building follow-up sequences and segmenting leads without ever touching the dashboard. ## Overview - **Category:** marketing-automation - **Price:** Free - **Tags:** sms-marketing, drip-campaigns, lead-nurturing, crm, automated-followup, contact-segmentation ## Description This connector lets your AI client manage customer relationships directly inside Chiirp. Instead of manually checking campaign performance or updating records in a web UI, you tell your agent what needs to happen. It handles the entire lifecycle for your leads—from initial contact capture to follow-up sequences. Your agent can check who's active, apply tags to segment groups, and even start new contacts using only natural conversation. If you build out automations that pull customer data from this MCP and pass it through other services (like a billing system or a calendar), the platform handles the security handshake across those different tools, so your keys never sit on disk. Managing leads becomes conversational. Need to know if John Doe is ready for a follow-up? Your agent just asks, and you get real data back. This saves hours of clicking through dashboards. ## Tools ### apply_tag Attaches or detaches labels to a contact, which helps segment leads for specific outreach campaigns. ### check_chiirp_status Verifies that the connection between your AI client and Chiirp is working correctly. ### create_contact Adds a brand new contact into your system, requiring a phone number as its unique identifier. ### get_contact Pulls all the current details for one specific contact record. ### get_profile Retrieves general information about your entire Chiirp account setup. ### list_campaigns Lists all the current SMS and drip campaigns running in your account. ### list_contacts Provides a full list of every contact record stored in Chiirp. ### list_sequences Shows all the automated drip workflows and sequences set up for your leads. ### list_tags Retrieves a list of every available tag you can use to segment contacts. ### remove_tag Removes an existing label from a contact record when the status changes. ### search_contacts Finds specific contacts by searching using their phone number. ### update_contact Modifies an existing contact's data, changing only the fields you specify. ## 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 ### Manage Contact Records Create new contacts or pull detailed information on existing ones using their phone numbers. ### Segment Leads by Tag Apply and remove descriptive labels to contacts, allowing you to group them for specific campaigns. ### Monitor Campaign Status Review active drip campaigns and view which automated sequences are running right now. ### View Account Settings Check the status of your connection and pull general account details for verification. ## Use Cases ### The Sales Lead Needs Immediate Follow-Up A prospect calls in and the rep makes a note that they are interested in 'HVAC systems.' Instead of manually searching for their number, the agent runs `search_contacts` and then uses `apply_tag` to attach 'high-priority hvac' right away. This ensures the automation drip sequence starts immediately. ### The Marketing Team Needs a Campaign Audit It’s time to see what campaigns are running and if any need pausing. The agent runs `list_campaigns` and then uses `list_sequences` to cross-reference all active automated workflows, preventing over-messaging. ### The Ops Engineer Needs a Clean Contact List You suspect some contacts are outdated. You run `list_contacts`, review the output for incomplete data, and then instruct the agent to use `update_contact` on specific records that need corrected information. ### Onboarding a New Customer Segment A new product line launches. You need to group all existing 'pre-sale' leads into a dedicated segment. The agent runs `list_tags`, verifies the tag name, and then uses `apply_tag` across dozens of records simultaneously. ## Benefits - Update records instantly: Instead of logging into the CRM to change a lead's status, your agent can run `update_contact` directly, making changes based on conversation context. - Targeted segmentation: Use `apply_tag` or `remove_tag` via an AI prompt. This lets you segment contacts dynamically without touching the tag management interface. - Visibility into automation: You get a list of all active processes and sequences by calling `list_sequences`, giving you a full picture of your current outreach efforts. - Full contact history: Need to know who's in the system? Running `list_contacts` gives you an immediate, comprehensive view of every lead record available. - Verify status on the fly: Before running a big automation flow, use `check_chiirp_status` to ensure your API connection hasn't dropped out. ## How It Works The bottom line is that you automate complex customer outreach by speaking to your CRM via any MCP-compatible client. 1. First, subscribe to this MCP on Vinkius and paste your Chiirp API token into the client. 2. Next, tell your AI agent exactly what you need done—for example, 'Find all contacts tagged 'hot-lead' and update their status.' 3. The agent executes the necessary steps against Chiirp and returns a plain text summary of the changes. ## Frequently Asked Questions **How do I create contacts using the Chiirp MCP?** You use `create_contact`. The tool requires a phone number to successfully add a new lead record to your system. **Can I update multiple fields for one contact at once with the Chiirp MCP?** Yes, you run `update_contact` and specify all the different pieces of data you need to change—just make sure you know which fields are available. **What is the best way to find a contact if I don't know their exact ID?** Use `search_contacts`. If you have the phone number, this tool finds the record. Otherwise, start by running `list_contacts` to get an overview. **Does the Chiirp MCP let me see all my current marketing campaigns?** Yes, calling `list_campaigns` will show you every drip and SMS campaign that is active in your account right now. **How do I use the `apply_tag` tool to segment contacts for targeted campaigns?** The `apply_tag` tool lets you add or remove tags, which is critical for segmentation. Your agent uses this function to categorize a contact, immediately triggering specific follow-up sequences based on that tag. **Can the Chiirp MCP list all active automation workflows using `list_sequences`?** Yes, calling `list_sequences` shows every drip workflow you've built in your account. This lets your agent check if a specific follow-up path is set up and ready to be activated. **How can I verify that the Chiirp MCP connection is working using `check_chiirp_status`?** Running `check_chiirp_status` instantly verifies your API connectivity. It confirms the credentials are active and ready to send data, preventing failed calls when you're trying to automate a workflow. **What does the `list_tags` tool do for managing contact segmentation?** This tool retrieves a list of all tags currently available in your Chiirp account. Your agent uses this information first, so it knows exactly which tags it can apply or remove when handling contacts.