# Lucidya MCP

> Lucidya connects your AI agent directly to deep customer intelligence platforms. This MCP lets you monitor brand mentions across Twitter or Instagram, analyze public sentiment in real-time, and pull unified customer profiles from the CDP using natural language commands.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Tags:** social-listening, sentiment-analysis, customer-intelligence, brand-monitoring, social-media-analytics, text-analysis

## Description

Need to know what people are saying about your brand? Lucidya gives your AI client eyes on social media conversations and a deep dive into your customer records. Instead of jumping through multiple dashboards, you just ask your agent a question—like 'What's the overall mood around our new product?'—and get an immediate, actionable answer.

This MCP pulls data from social listening tools, lets agents check specific customer interactions, and even analyzes text to detect nuances like different Arabic dialects. It’s how you move beyond just seeing a metric and actually understand *why* the metric is high or low. Because we host this on Vinkius, your agent connects once and gains access to all these social intelligence tools right from any compatible client.

## Tools

### get_omniserve_analytics
Pulls key performance indicators regarding customer service interactions.

### list_cdp_customers
Generates a list of all available customer profiles within the CDP.

### detect_arabic_dialect
Analyzes text and specifies which particular Arabic dialect it belongs to.

### get_customer_profile
Retrieves the complete, detailed record for a single customer profile.

### get_monitor_details
Fetches specific metadata and status information about one social media monitor.

### list_social_monitors
Retrieves a list of all currently active or inactive social media monitors set up in the platform.

### analyze_text_sentiment
Determines if a given piece of text is positive, negative, or neutral in tone.

## Prompt Examples

**Prompt:** 
```
List all my social media monitors in Lucidya.
```

**Response:** 
```
I've retrieved your monitors. You have 5 active monitors, including 'Competitor Tracking', 'Brand Mentions', and 'Campaign Launch 2024'.
```

**Prompt:** 
```
Analyze the sentiment of this text: 'I am extremely happy with the new product release!'.
```

**Response:** 
```
The AI analysis confirms a 🟢 Positive sentiment for that text, with a high confidence score of 0.98.
```

**Prompt:** 
```
Show the customer profile for ID 'cust-123' in the Lucidya CDP.
```

**Response:** 
```
I've fetched the profile for customer cust-123. They have interact with your brand 12 times across Twitter and Intercom, with an overall sentiment score of 0.85 (Neutral-Positive).
```

## Capabilities

### Monitor Social Media Activity
List active monitors across various platforms or get full status details for a specific listening monitor.

### Analyze Public Sentiment
Determine the emotional tone—positive, negative, or neutral—from any piece of text written by a customer.

### Retrieve Customer Records
Fetch complete profiles and interaction histories for specific customers from your Customer Data Platform (CDP).

### Review Service Performance Metrics
Query key performance indicators (KPIs) related to customer service operations.

### Detect Text Dialects
Identify the specific regional dialect when analyzing Arabic language text strings.

## Use Cases

### Figuring out why a campaign failed.
The Brand Manager asks their agent: 'Show me all mentions from last week and run sentiment analysis.' The agent uses `list_social_monitors` to gather the data, then runs `analyze_text_sentiment`, revealing that negative chatter spiked right after the pricing change.

### Investigating a specific customer complaint.
The CX Lead asks: 'What's everything we know about user ID 456?' The agent uses `get_customer_profile` to pull interaction history, cross-referencing service tickets with social mentions for a complete view.

### Auditing the current monitoring setup.
The Data Analyst asks: 'What monitors are running?' The agent uses `list_social_monitors` and then `get_monitor_details`, providing a clean report on which streams need attention or updating.

### Tracking regional market sentiment.
The team receives incoming messages in Arabic. Instead of guessing the origin, the agent first runs `detect_arabic_dialect` before pulling the profile using `get_customer_profile`, ensuring accurate localized support.

## Benefits

- Stop guessing about brand health. By using the `analyze_text_sentiment` tool, your agent instantly tells you if public reactions are positive or negative, giving real-time insight.
- Get a single source of truth for every user. The `get_customer_profile` tool pulls all interaction histories and unified data from the CDP into one place for review.
- Keep track of everything without manual checks. You can use `list_social_monitors` to see the status of every active monitoring stream across multiple platforms.
- Deep dive into service issues using `get_omniserve_analytics`. This tool lets your agent query specific KPIs, telling you exactly where customer support is struggling right now.
- Handle global communication complexity. If you receive text in Arabic, the `detect_arabic_dialect` tool pinpoints the region immediately, helping route it to the right team.

## How It Works

The bottom line is that you talk to your AI agent like talking to a teammate who already knows where all the data lives.

1. Subscribe to this MCP and input your unique Lucidya API Token into Vinkius.
2. Connect your preferred agent (like Cursor or Claude) to the Vinkius catalog.
3. Ask your AI client a natural language question—for example, 'Show me the customer profile for user X'—and the agent executes the necessary tool calls.

## Frequently Asked Questions

**How do I use Lucidya MCP for sentiment analysis?**
You simply ask your agent to analyze the text you provide. The `analyze_text_sentiment` tool returns whether the tone is positive, negative, or neutral, along with a confidence score.

**Can I get a full customer history using Lucidya MCP?**
Yes. Use the `get_customer_profile` tool and provide a unique customer ID. The agent pulls all gathered interaction data from the CDP into one detailed view.

**What kind of social media monitoring can I do with Lucidya MCP?**
You can list all monitors using `list_social_monitors` or get status updates for a single stream using `get_monitor_details`. This shows you if your tracking is active and working.

**Does Lucidya MCP help with non-English text?**
Absolutely. If the text is Arabic, use `detect_arabic_dialect` to identify the specific regional dialect first, ensuring accurate interpretation before running sentiment checks.

**Can I see service performance data from Lucidya MCP?**
Yes. Use the `get_omniserve_analytics` tool to query KPIs for your customer service department, helping you spot bottlenecks that social chatter might be pointing toward.