# Customers.ai MCP for AI Agents AI Agent Connect

> Customers.ai MCP for AI Agents. Identify anonymous website visitors by name, manage contact attributes, and automate multichannel outreach via SMS and chat. Turn your identity resolution data into a reachable lead pipeline without manual data entry.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_lGINU3IYv8gTeL0cmcMWkTmAhyDIJhWuWFKMc5nQ/ai-agent-connect
- **Tags:** customersai, identity-resolution, messaging-automation, lead-generation, x-ray-pixel, marketing-api, sms-automation, audience-segmentation, mcp

## Description

You can now treat your website visitor data like a conversation rather than a spreadsheet. This Connector lets your AI agent pull the names of anonymous visitors who just landed on your site and turn them into actionable leads instantly. Instead of manually scrubbing logs, you can ask your agent to find specific people, update their tags, or trigger an SMS follow-up based on what they clicked. It's a massive shift for anyone tired of the manual parts of lead generation. By adding this to your Vinkius setup, you're essentially giving your AI a direct line to your identity resolution pipeline. You get to move from 'who is this?' to 'let's talk' in a single prompt. It handles the heavy lifting of looking up profiles and dispatching messages so you can focus on the actual sales process.

## Tools

### send_rich_message
Dispatch a structured JSON message including buttons or galleries to a lead. This creates a much higher engagement rate than plain text.

### add_tag_to_contact
Add a specific tag to a contact profile to trigger nurturing sequences. This helps you organize leads as they move through your funnel.

### get_contact
Pull the full profile details for a specific contact in your database. Use this to see all attributes and tags at once.

### list_xray_leads
Retrieve a list of website visitors identified through the X-Ray Pixel. This is how you see who is actually on your site.

### remove_tag_from_contact
Strip a tag from a contact when they no longer meet a specific criteria. This keeps your segments clean and accurate.

### search_contacts
Find specific people in your database using their email or phone number. It makes finding a lead during a live call easy.

### send_text_message
Send a plain text SMS to a contact for quick follow-ups. It's the fastest way to get a response from a high-intent lead.

### update_contact_attributes
Modify custom data fields for a contact to keep your records accurate. Use this to sync data from your sales conversations.

## Prompt Examples

**Prompt:** 
```
Who visited my site in the last hour?
```

**Response:** 
```
I've pulled the latest visitor data from your X-Ray Pixel. Here are the most recent identified leads:

| Name | Company | Role |
| :--- | :--- | :--- |
| Sarah Chen | TechFlow | VP of Engineering |
| Marcus Thorne | BlueSky Inc | Operations Director |
| Elena Rodriguez | Nova Systems | CTO |

Would you like me to send a follow-up SMS to any of them?
```

**Prompt:** 
```
Find the lead with email test@test.com and send them a text.
```

**Response:** 
```
I've located the profile for **test@test.com**.

*   **Name:** Jane Doe
*   **Status:** Hot Lead
*   **Tags:** Q3_Prospect

I've sent a plain text SMS to her: *'Hi Jane, thanks for checking out our demo. Let me know if you have any questions!'*
```

**Prompt:** 
```
Add a 'Demo Requested' tag to the last 3 X-ray leads.
```

**Response:** 
```
I've updated the following leads with the **Demo Requested** tag:

*   Sarah Chen (ID: 8821)
*   Marcus Thorne (ID: 8822)
*   Elena Rodriguez (ID: 8823)

This will now trigger your automated nurturing sequence for these contacts.
```

## Capabilities

### Identify anonymous website visitors
Get the actual names and details of people browsing your site through your identity resolution pipeline.

### Send rich SMS messages
Dispatch text messages that include buttons and galleries directly to your leads.

### Update contact tags
Add or remove labels from leads to organize your sales pipeline automatically.

### Search lead database
Find specific contacts in your database using email addresses, phone numbers, or other identifiers.

### Manage audience segments
Update custom attributes to keep your marketing data accurate and your segments clean.

## Use Cases

### Identifying a high-intent B2B visitor
A lead visits your pricing page. You ask the agent to list_xray_leads to see who it is and then use get_contact to see their job title.

### Automating a personalized follow-up
An SDR finds a lead and asks the agent to send_text_message with a personalized intro based on the contact's custom attributes.

### Dynamic segment updates
A lead clicks a demo link. The agent uses add_tag_to_contact to move them into the 'Demo Requested' bucket for the sales team.

### Cleaning up lead records
You want to remove a 'New' tag from old leads. The agent uses remove_tag_from_contact on a specific list to keep your dashboard tidy.

## Benefits

- Stop guessing who is visiting your site. Use list_xray_leads to see the real names behind anonymous traffic.
- Send messages that actually get read. Use send_rich_message to include buttons and galleries in your SMS.
- Organize your pipeline automatically. Use add_tag_to_contact to segment leads as they move through the funnel.
- Keep your data clean without the manual work. Use update_contact_attributes to sync info from your sales calls.
- Find the right person faster. Use search_contacts to pull up a profile instantly when a new lead comes in.
- Turn intent into action. Use list_xray_leads to find high-intent visitors and trigger a follow-up in one move.

## How It Works

The bottom line is you turn anonymous web traffic into a searchable, reachable database of real people.

1. Subscribe to the Customers.ai MCP on the Vinkius marketplace.
2. Retrieve your API key from your Customers.ai dashboard under Settings.
3. Connect your AI client and start querying your visitor data with natural language.

## Frequently Asked Questions

**What is the Customers.ai MCP for?**
It connects your website visitor data to your AI agent. You can use it to identify anonymous visitors, manage contact tags, and send SMS or chat messages to leads.

**Can I see who visited my site with Customers.ai MCP?**
Yes. By using the X-Ray Pixel integration, your AI agent can pull a list of identified visitors so you know exactly who is looking at your content.

**Can the Customers.ai MCP send SMS messages?**
Yes, it can send both plain text messages and rich messages that include buttons and galleries to help you engage with leads more effectively.

**How do I manage lead tags using Customers.ai MCP?**
You can ask your AI agent to add or remove tags from any contact. This helps you organize your sales pipeline and trigger automated nurturing workflows.

**Is Customers.ai MCP for email marketing?**
No, this Connector is specifically for identity resolution and mobile messaging like SMS and chat. It's designed for direct, high-intent outreach.

**How do I find a specific lead in Customers.ai MCP?**
You can ask your agent to search for a contact using their email address, phone number, or other identifiers to pull up their full profile instantly.

**How do I find my Customers.ai API Key?**
Log in to your dashboard, navigate to **Settings** > **API**, and generate or copy your unique API Key.

**What is the X-Ray Pixel?**
The X-Ray Pixel is a tool that identifies anonymous website visitors and resolves their identity into actionable lead profiles.

**Can I send rich JSON messages?**
Yes! Use the `send_rich_message` tool and provide a JSON payload containing image URLs, buttons, or gallery structures.