# Chord Progression Analyzer MCP

> Chord Progression Analyzer converts raw chord lists into deep music theory insights. It reads any sequence of chords—like C-Am-F-G—and immediately translates them into their Roman numeral functions relative to a key. You can then identify complex harmonic patterns, such as secondary dominants or cadences, and look up the emotional context associated with those movements.

## Overview
- **Category:** analysis
- **Price:** Free
- **Tags:** music-theory, chords, roman-numerals, harmonic-analysis, musicians

## Description

If you're studying music theory or composing, you know that converting chords from simple notes into functional harmony is half the battle. This MCP handles that translation instantly. Instead of spending hours cross-referencing charts and textbooks to determine if a sequence like I-IV-V constitutes a strong cadence, this tool does the heavy lifting for you. You input your chord list and specify the key, and it gives you precise Roman numeral functions. Beyond just labels, the system can detect the overarching harmonic structure of the piece, pointing out specific patterns that define the progression type. Plus, it provides metadata about the emotional weight or common genre associations tied to those movements. It's exactly what your agent needs when working with complex musical structures. Because Vinkius hosts this MCP in its catalog, you can connect your preferred AI client and access professional-grade harmonic analysis right where you’re writing.

## Tools

### analyze_roman_numerals
Takes a list of chords and transforms them into their functional Roman numeral scale degrees based on the key you supply.

### classify_progression
Examines a sequence of Roman numerals to pinpoint the specific harmonic pattern, like an authentic or plagal cadence.

### lookup_musical_context
Retrieves general stylistic information and associated emotional metadata for any identified progression type.

## Prompt Examples

**Prompt:** 
```
Analyze the progression C, Am, F, G in the key of C Major.
```

**Response:** 
```
The Roman numeral functions for this sequence are ["I", "vi", "IV", "V"].
```

**Prompt:** 
```
What is the harmonic pattern of ['I', 'IV', 'V', 'I']?
```

**Response:** 
```
The identified progression type is a cadence.
```

**Prompt:** 
```
What emotion is associated with a 'secondary dominant'?
```

**Response:** 
```
A secondary dominant typically evokes tension and movement.
```

## Capabilities

### Determine Roman Numeral Functions
Converts any list of named chords into their corresponding scale degrees relative to a set key.

### Identify Harmonic Patterns
Analyzes a sequence of Roman numerals to categorize the overarching musical structure, such as cadences or secondary dominants.

### Lookup Musical Context
Retrieves stylistic and emotional metadata associated with specific harmonic progression types.

## Use Cases

### Analyzing a Complex Chord Change
A student has transcribed a complex piece of jazz and is unsure if the passage uses standard functional harmony. They ask their agent to run `analyze_roman_numerals` on the chord list in C minor, immediately getting clear Roman numerals, which they then feed into `classify_progression` for confirmation.

### Building a Dramatic Scene Score
A film composer needs music that builds tension before a major reveal. They input the chord progression and use `lookup_musical_context` to confirm that secondary dominants are known for creating maximum dramatic anticipation.

### Refining Songwriting Material
A songwriter has written a chorus but feels it lacks a satisfying resolution. They input the progression and run `classify_progression`, which suggests that swapping out one chord might create a stronger, more definitive perfect authentic cadence.

### Academic Research on Harmony
A music theorist is writing an essay comparing Renaissance harmony to modern pop. They use the MCP tools sequentially: first `analyze_roman_numerals` for both styles, then `lookup_musical_context` to gather stylistic data for their paper.

## Benefits

- Stop guessing the theory behind your favorite songs. Use `analyze_roman_numerals` to instantly convert any chord chart into its precise I, IV, V notation.
- Don't just see a sequence of notes; understand its structure. The `classify_progression` tool identifies if you've landed on a strong cadence or another specific harmonic pattern.
- Add emotional depth to your writing. Use `lookup_musical_context` to find out what genre and emotion are typically tied to a secondary dominant, for instance.
- Spend less time in textbooks and more time creating music. This MCP handles the tedious conversion from raw chords to theoretical language.
- It's perfect for academic work or professional composing. It gives you structured data on harmonic analysis that general LLMs can’t reliably provide.

## How It Works

The bottom line is: you get a complete theoretical breakdown of your chord changes without manual calculation.

1. First, provide the MCP with your raw chord list and specify the musical key (e.g., 'C Major').
2. The tool converts the chords into Roman numerals and then classifies that sequence to reveal the underlying harmonic pattern.
3. Finally, you receive metadata on the progression type, including its common emotional associations or genre usage.

## Frequently Asked Questions

**How do I use Chord Progression Analyzer to find Roman numerals?**
You run the `analyze_roman_numerals` tool. Just provide your list of chords and tell it which key you are working in, and it returns the scale degrees.

**Can I use Chord Progression Analyzer to check for cadences?**
Yes. After getting your Roman numerals, feed them into `classify_progression`. This tool is specifically designed to identify major harmonic patterns like perfect authentic or plagal cadences.

**What kind of emotional context does the Chord Progression Analyzer provide?**
The `lookup_musical_context` tool provides metadata about typical emotions and associated genres. It tells you what a certain progression generally suggests to an audience, which is great for scoring.

**Is this MCP better than just using Google search?**
Yes. A general search engine gives you definitions; this MCP executes complex, multi-step calculations specific to music theory. It provides actionable data, not just academic text.