# Emotion Wheel Classifier MCP for AI Agents AI Agent Connect

> Emotion Wheel Classifier maps raw text to Plutchik's Wheel of Emotions. It identifies specific emotional nodes, intensities (Low, Medium, High), and emotional families. Use it to move beyond basic sentiment analysis into nuanced psychological data.

## Overview
- **Category:** psychology
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_yxyGf3CuwFLbbJVPv3NF70WIQsKf6zvqEPAC9v0i/ai-agent-connect
- **Tags:** emotions, plutchik, sentiment, nlp, psychology

## Description

You can give your agent raw notes, customer reviews, or journal entries and get back a structured psychological profile. Instead of just saying a piece of text is sad, this Connector tells you if it is specifically disappointment, how intense that feeling is, and where it fits in the broader emotional family. It is built for people who need more than just a basic sentiment score. You can see how an emotion builds in strength or figure out what happens when two primary feelings collide to create a complex state. Finding these nuances manually is tedious, but this Connector makes it a standard part of your agent workflow. Since it is hosted on Vinkius, you get a reliable way to plug this psychological depth into your existing setup without worrying about the underlying logic. It turns messy human feelings into clean data you can actually use for your reports.

## Tools

### explore_emotional_dyad
Calculate the complex emotion that results from combining two primary emotions. It is great for understanding nuanced feelings.

### get_emotion_spectrum
Show how a specific emotion changes as it gets stronger or weaker. Use this to understand emotional progression.

### analyze_text_emotion
Identify specific emotions, intensities, and families from raw text. This helps you categorize qualitative data quickly.

## Prompt Examples

**Prompt:** 
```
I'm feeling a bit let down by the new update, but I still like the team.
```

**Response:** 
```
Based on your statement, here is the emotional breakdown:

- **Primary Emotion:** Disappointment
- **Intensity:** Medium
- **Family:** Sadness

**Context:** You are expressing a mix of sadness and trust, which often indicates a lingering loyalty despite a specific setback.
```

**Prompt:** 
```
What happens when someone feels both fear and trust at the same time?
```

**Response:** 
```
When **Fear** and **Trust** combine in Plutchik's model, they create the complex emotion of **Awe**.

This suggests a state of being overwhelmed but also feeling safe enough to experience the magnitude of the moment.
```

**Prompt:** 
```
Show me how Joy changes as it gets more intense.
```

**Response:** 
```
Here is the progression of Joy on the emotion wheel:

- **Low Intensity:** Serenity
- **Medium Intensity:** Happiness
- **High Intensity:** Ecstasy

This shows the shift from a calm state to a high-energy emotional peak.
```

## Capabilities

### Identify specific emotions
The agent picks out the exact emotional node from a text description.

### Measure emotional intensity
It assigns a Low, Medium, or High intensity level to the identified feeling.

### Map to emotional families
It places the emotion within the correct psychological family group.

### Trace emotion progression
It shows how a specific emotion changes as it grows in strength.

### Calculate complex emotional states
It determines the result of combining two primary emotions into one complex state.

## Use Cases

### Analyzing customer feedback
A brand gets 500 reviews. The agent identifies specific emotional nodes to group them by family rather than just star ratings.

### Mapping a user journey
A UX designer asks the agent to find the emotional arc of a user story. It shows how frustration builds over time.

### Content creation
A writer wants to know the emotional vibe of a script. The agent checks if the mix of fear and surprise creates shock.

### Mental health tracking
A developer uses the tool to help users categorize their daily journal entries into a visual emotional wheel.

## Benefits

- Get precise emotional labels. Instead of generic happy tags, you get specific nodes like joy or contentment.
- Measure emotional intensity. You can distinguish between low-level feelings and high-intensity states automatically.
- Understand emotional evolution. You can see the path an emotion takes as it intensifies.
- Discover complex states. See how primary feelings like trust and joy combine into love.
- Standardize psychology data. Ensure your agent always uses the same consistent model for every analysis.

## How It Works

The bottom line is you get structured, psychologically grounded emotion data instead of vague sentiment labels.

1. Provide your agent with a text snippet or description.
2. The Connector processes the text against Plutchik's model.
3. You get back the specific emotion, intensity level, and family.

## Frequently Asked Questions

**What is the Emotion Wheel Classifier MCP?**
It is a tool that lets your AI agent understand human feelings using Plutchik's Wheel of Emotions. It turns messy text into organized data like intensity and emotional families.

**How does this help with customer reviews?**
It goes beyond good or bad. It identifies specific feelings like frustration or contentment, helping you see exactly why customers feel the way they do.

**Can it tell how strong an emotion is?**
Yes, it identifies if a feeling is Low, Medium, or High intensity. This helps you prioritize which customer issues need the most immediate attention.

**What is an emotional dyad?**
It is a way to see what happens when two primary emotions mix. The Connector can calculate complex results, like how joy and trust become love.

**Is this for psychology research?**
Yes, it is perfect for researchers who need to map out emotional journeys or analyze qualitative data using a standard psychological model.

**Does it work on any kind of text?**
It works on any text description, including journal entries, social media posts, or transcripts, as long as they describe a human feeling.

**How does the tool identify emotions?**
The `analyze_text_emotion` tool interprets the weight and descriptors in your text to map it to a specific node on Plutchik's wheel, determining intensity levels like Low or High.

**Can I see the progression of an emotion?**
Yes, using `get_emotion_spectrum`, you can retrieve the three-tier intensity names (Low, Medium, High) for any primary emotion.

**What are emotional dyads?**
Dyads are complex emotions formed by combining two primary ones. The `explore_emotional_dyad` tool calculates the resulting state and its complexity.