# Lucidya MCP for AI Agents AI Agent Connect

> Lucidya MCP connects your social listening and customer data to your AI agent. It lets you monitor mentions across platforms like Twitter and Instagram, run sentiment analysis on customer feedback, and pull unified customer profiles from your CDP. It's built for brands that need to understand their audience in real time without switching between dozen of tabs.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_BPSEfoyccLuNlXxXWFPftMfYer40OlJMGTjAi8cS/ai-agent-connect
- **Tags:** social-listening, sentiment-analysis, customer-intelligence, brand-monitoring, social-media-analytics, text-analysis

## Description

Managing a brand's reputation across multiple social channels usually feels like a game of whack-a-mole. You're constantly jumping between dashboards to see what people are saying about your products, trying to figure out if the vibe is positive or if a PR crisis is brewing. This Connector changes that by bringing your Lucidya data directly into your AI client. Instead of exporting CSVs or manually checking monitor statuses, you can just ask your agent to summarize the latest sentiment or pull up a specific customer's history. It handles the heavy lifting of digging through your customer data and service analytics so you can focus on making decisions. Since Vinkius hosts this connection, you can get your agent up and running in minutes. You'll be able to spot trends in Arabic dialects or grab performance KPIs without ever leaving your chat interface. It turns your social intelligence into a conversation rather than a chore.

## Tools

### detect_arabic_dialect
Identify the specific dialect used in Arabic text. It's a huge help for understanding regional nuances.

### get_customer_profile
Get all the details for a single customer profile. You can see their full history and interaction points.

### get_monitor_details
Fetch the status and metadata for a specific monitor. Use this to check if your social listening is active.

### analyze_text_sentiment
Determine if a piece of text is positive, negative, or neutral. This works on any string you feed it.

### list_cdp_customers
Pull a list of all customer profiles from your CDP. This helps you see the scale of your user base at a glance.

### list_social_monitors
See every monitor you have active across Twitter, Instagram, and other sources. It gives you a bird's-eye view of your tracking.

### get_omniserve_analytics
Query your customer service KPIs and performance metrics. It's the fastest way to check your team's stats.

## Prompt Examples

**Prompt:** 
```
What's the general vibe of our mentions on Twitter today?
```

**Response:** 
```
I've analyzed the latest mentions for you. Here is the current sentiment summary:

| Metric | Status |
| :--- | :--- |
| **Overall Sentiment** | Positive |
| **Top Topic** | New Product Launch |
| **Volume** | 142 Mentions |

The vibe is mostly excited. People are sharing photos of the new packaging, though there are a few questions about shipping times.
```

**Prompt:** 
```
Show me the profile for customer ID 9982.
```

**Response:** 
```
I've pulled the profile for customer **9982**. Here is what I found in the CDP:

* **Interaction Count:** 14 times
* **Primary Channels:** Twitter and Intercom
* **Overall Sentiment:** Neutral / Positive
* **Recent Activity:** Last interacted 2 days ago regarding a shipping inquiry.
* **Status:** Active
```

**Prompt:** 
```
Are our social monitors still active?
```

**Response:** 
```
I checked your active monitors. Here is the current status:

* **Competitor Tracking:** Active
* **Brand Mentions:** Active
* **Campaign Launch 2024:** Paused
* **Regional Arabic Feed:** Active

You have 4 active monitors currently running.
```

## Capabilities

### Monitor social media mentions
Track active and inactive monitors across Twitter, Instagram, and other sources in one place.

### Detect Arabic dialects
Identify specific regional dialects in Arabic text strings automatically.

### Pull unified customer profiles
Retrieve complete customer interaction histories and profiles from your CDP.

### Analyze text sentiment
Determine the emotional tone of any given text string with high confidence.

### Fetch service analytics
Query customer service KPIs and performance metrics via the OmniServe API.

### Retrieve monitor details
Fetch metadata and status for your configured listening monitors instantly.

## Use Cases

### Sudden PR Crisis
A brand manager notices a spike in mentions. They ask the agent to analyze_text_sentiment on the latest posts to see if it's a coordinated attack or a localized issue.

### Personalized CX
A support agent needs to know a customer's history. They ask the agent to get_customer_profile for a specific ID to see every past interaction across Twitter and Intercom.

### Regional Marketing
A team wants to know if their Middle East campaign is hitting the right notes. They use detect_arabic_dialect to see how different regions are reacting.

### Weekly Reporting
An analyst asks the agent to get_omniserve_analytics to summarize the last 7 days of customer service performance metrics.

## Benefits

- Stop manual sentiment tracking by using analyze_text_sentiment to get instant vibes on customer feedback.
- Get a full view of your audience by pulling unified profiles with get_customer_profile.
- Understand regional nuances better by using detect_arabic_dialect on local social mentions.
- Save time on reporting by using get_omniserve_analytics to pull KPIs directly into your chat.
- Keep tabs on your tracking status by using list_social_monitors to see every active source.

## How It Works

The bottom line is you get a direct line from your social listening data to your AI agent.

1. Subscribe to the Lucidya MCP on Vinkius.
2. Provide your Lucidya API Token in the configuration.
3. Ask your AI client to list monitors or pull customer data.

## Frequently Asked Questions

**Can Lucidya MCP help with Arabic social media?**
Yes, it detects specific Arabic dialects in customer text. This helps you understand regional nuances and local sentiment more accurately.

**Does this connect to my CDP?**
Yes, it pulls unified customer profiles directly from your Lucidya CDP. You can see interaction histories and profile details in your chat.

**How do I see my service KPIs?**
You can ask your agent to query your customer service KPIs and performance metrics via the OmniServe API connection.

**Can I check if my monitors are live?**
Yes, you can fetch the status and metadata for any specific monitor to see if it is active or paused.

**Is this for brand monitoring?**
Yes, it's built specifically for social listening and brand monitoring to help you track mentions and sentiment in real time.

**How do I get customer interaction history?**
You can pull a complete profile for any customer ID. This shows you their history across different channels like Twitter and Intercom.

**How do I find my API Token?**
Log in to your Lucidya account and navigate to Account Settings or API section to generate and copy your unique authorization token.

**Does the AI analysis work for languages other than English?**
Yes, Lucidya's AI is highly optimized for multiple languages, with specific advanced support for various Arabic dialects.

**Can I retrieve historical social data?**
You can retrieve any data that has been captured by your active monitors. Use the `monitor_details` tool to check what is currently being monitored.