# Customers.ai MCP for AI Agents MCP > Customers.ai helps you turn anonymous website traffic into qualified, actionable contacts. Connect it with your AI client to automatically identify visitors by name and details, enrich their profiles, tag them for specific campaigns, and manage multichannel outreach directly from conversation. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** customersai, identity-resolution, messaging-automation, lead-generation, x-ray-pixel, marketing-api, sms-automation, audience-segmentation, mcp ## Description This connector lets your AI agent take over the entire process of lead identification and follow-up messaging. Instead of manually scrubbing visitor logs or juggling multiple platforms, you simply talk to your agent. It finds anonymous website visitors, pulls in their details, and builds out a high-fidelity sales pipeline right from chat. You can enrich these leads by finding contacts via phone numbers or emails, updating custom attributes, and tagging them for campaigns like 'Q2 Campaign'. Once the data is clean, you dispatch structured messages—whether that's a quick text or a rich message with buttons—across SMS and chat channels. Through Vinkius, your AI agent becomes your dedicated growth engineer, managing outreach and keeping track of every lead without you ever having to leave your workspace. ## Tools ### add_tag_to_contact Assigns a specific label or tag to an existing contact profile. ### get_contact Retrieves all current details and attributes for a specified contact ID. ### list_xray_leads Pulls a list of website visitors who have been identified through X-Ray Pixel data. ### remove_tag_from_contact Deletes an assigned tag from a contact profile. ### search_contacts Searches the entire contact database using criteria like email or name to find relevant profiles. ### send_rich_message Sends a highly formatted message containing complex data structures, buttons, and galleries across chat channels. ### send_text_message Dispatches a simple, plain text message to a specific contact's number via SMS. ### update_contact_attributes Changes or adds custom data points (attributes) associated with a contact profile. ## Prompt Examples **Prompt:** ``` Find me all leads who visited this week but I haven't messaged yet. ``` **Response:** ``` **Recent X-Ray Leads Report** Here are 4 high-intent visitors identified over the last 7 days: * **John D.** (Role: Director, TechCorp) - Visited on Monday. Tagged as 'Needs Followup'. * **Sarah K.** (Role: Marketing Manager, Acme Inc.) - Visited yesterday. No tag. * **Mike B.** (Role: Founder, Global Co.) - Visited 2 days ago. Needs a rich message. * **Laura P.** (Role: HR Director) - Visited last week. Found via email match. Would you like me to send Mike B. the product overview now? ``` **Prompt:** ``` I need to update the attributes for John Doe and tag him as 'High Priority'. ``` **Response:** ``` **Action Successful.** John D.'s profile (ID: 1024) has been updated: * **Custom Attribute:** Industry set to Tech. * **Tagging:** Successfully added the 'High Priority' tag. * **Status:** Ready for immediate personalized outreach. You can now send a rich message tailored specifically to his role as Director. ``` **Prompt:** ``` List the last 5 leads identified via X-Ray Pixel. What should I send to Sarah K.? ``` **Response:** ``` **X-Ray Lead Report: Last 5 Identifications** 1. *Acme Inc.* (Marketing Manager) - Visited Yesterday. 2. *Global Tech* (Director) - Visited Monday. 3. *Local Biz* (Owner) - Visited Today. 4. ... and two others. For Sarah K., since she's a Marketing Manager, I recommend sending her the 'Q2 Campaign' materials using the rich message tool. It will look professional and guide her to specific resources. ``` ## Capabilities ### List Identified Website Visitors Pulls a list of website visitors who have been identified through X-Ray Pixel data, giving you profiles on anonymous traffic. ### Search and Retrieve Contact Profiles Finds contacts within your database using emails, phone numbers, or other identifiers to get full profile details. ### Send Text and Rich Messages Sends plain text messages via SMS or complex structured JSON messages with galleries and buttons across chat channels. ### Manage Contact Tags and Attributes Adds, removes, or updates custom tags and attributes on contacts to keep your data clean and organized for campaigns. ## Use Cases ### Reacting to Hot Website Traffic A visitor browses pricing pages but leaves without converting. You ask your agent to execute `list_xray_leads` on the recent traffic, identify them, and immediately use `send_text_message` with a link to a demo booking. ### Cleaning Up Stale Leads You run an audit of your contact list. You ask your agent to find all contacts from the 'Q1 Campaign' tag using `search_contacts`, and if they haven't been touched in 90 days, you use `update_contact_attributes` to mark them as inactive. ### Coordinating a Multi-Step Follow-Up A lead profile is found via an external identifier. You first run `get_contact`, then add the 'High Intent' tag using `add_tag_to_contact`. Finally, you use `send_rich_message` to send them a detailed product brochure. ### Scaling Campaign Segmentation After an event, dozens of new leads arrive. You instruct your agent to process the list by calling `list_xray_leads`, then using `add_tag_to_contact` for 'Event Attendee' on every profile. ## Benefits - Instantly enrich your sales pipeline: Instead of guessing, you use `list_xray_leads` to get real visitor profiles that tell you who showed up on your site. - Saves time with messaging: You can dispatch communications across multiple channels—SMS or chat—using `send_text_message` and `send_rich_message` without leaving your AI environment. - Maintains data cleanliness: Use `add_tag_to_contact` to segment leads immediately. This allows you to trigger highly specific, automated follow-ups later on. - Deep contact visibility: The `get_contact` tool pulls every piece of metadata available for a lead, ensuring your outreach is always personalized and accurate. - Keeps data current: If a lead changes roles or companies, use `update_contact_attributes` to keep their profile fresh before you send that follow-up message. ## How It Works The bottom line is: Your AI client handles all the plumbing—finding, tagging, updating, and messaging leads—so you just focus on strategy. 1. First, connect your API key from the Customers.ai dashboard to your AI client. 2. Next, prompt your agent to execute a task, such as listing recent X-Ray leads or searching for a contact by email. 3. Your agent performs the action (like adding a tag) and returns structured data that you can then use in follow-up commands. ## Frequently Asked Questions **How does the Customers.ai MCP help me find anonymous website visitors?** It uses your existing visitor data to identify names and company details for you. Instead of seeing just an IP address, you get a profile that lets you know who they are, making them usable leads right away. **Can I use Customers.ai MCP to automate outreach via SMS?** Yes, absolutely. You can send plain text messages or even highly structured, button-filled rich messages directly through your AI agent, coordinating the entire flow from one place. **What is the best way to keep my leads organized with this MCP?** You should use the tagging and attribute tools. By running commands like 'Add tag' or 'Update attributes', you ensure every lead has a precise, searchable status that dictates your next action. **Does Customers.ai MCP let me search my contacts by anything other than email?** It lets you do much more. You can use the contact search tool to find people based on phone numbers or any other unique identifier, ensuring you never lose track of a potential client. **Is Customers.ai MCP only for big companies?** Not at all. It works whenever you need to systematize lead capture and outreach. Whether you're managing 10 leads or 10,000, the process is simple: Identify -> Enrich -> Message. **How can I make sure my follow-up messages are personalized?** By using the MCP to pull contact details and attributes first. Your AI agent reads that data—like their job title or industry—and uses those facts to write a message that sounds like it came from a human.