# Roman Numeral Converter MCP

> Roman Numeral Converter converts musical chords into functional Roman numerals and back. Use this MCP to instantly analyze chord progressions—like turning C-Am-F-G into I-vi-IV-V. It also handles automatic transposition, shifting any sequence of chords to a new key while keeping the underlying harmonic logic intact.

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

## Description

This connector lets musicians quickly move between practical chord names and functional music theory notation. If you write out chords for a piece—say, C major followed by Am—this MCP translates that raw list into Roman numerals (I-vi), which is how theorists discuss harmony. It’s essential when you need to analyze the underlying structure of a song or build a progression in a specific key. You can give it a sequence and instantly get its theoretical equivalent. Plus, if you decide your piece needs to shift keys, the tool automatically transposes the whole progression for you, keeping the harmonic relationships sound. Finding this specialized utility within Vinkius makes advanced music theory analysis accessible directly through your agent.

## Prompt Examples

**Prompt:** 
```
Parse this progression: C-Am-F-G
```

**Response:** 
```
The parsed chords are: C, Am, F, G.
```

**Prompt:** 
```
What is the harmonic function of Am in the key of C?
```

**Response:** 
```
In the key of C, Am is the vi (minor) degree, which you can find using `resolve_harmonic_function`.
```

**Prompt:** 
```
Transpose I-vi-IV-V from C to G.
```

**Response:** 
```
The transposed progression in G is: G, Em, C, D, calculated via `transpose_progression`.
```

## Capabilities

### Analyze a chord sequence
It takes raw chords (like C-Am) and turns them into their Roman numeral functional notation (I-vi).

### Determine harmonic function
You can ask what the theoretical role of any given chord is within a specific key.

### Shift progressions to new keys
The tool automatically transposes an entire progression, keeping all the harmonic relationships intact when changing the target key.

## Use Cases

### Analyzing an existing song's harmony
A music student is analyzing a pop song and has only written down the chord names (G-D/F#-Em). Instead of looking up every chord in theory books, they run it through the MCP to get the functional Roman numerals immediately.

### Adapting an arrangement for a different performer
A composer writes a piece meant for D major but realizes the soloist plays best in A minor. They input the original progression and use the tool to automatically transpose it to sound perfect in A minor.

### Understanding complex theory concepts
A musician needs to know why a specific chord sounds 'sad' (minor). They ask the MCP what the harmonic function of that chord is within the key, and the tool provides the exact theoretical answer.

## Benefits

- Stop writing out full chord names. Use this MCP to translate any progression (C-Am-F-G) directly into its functional Roman numeral equivalent (I-vi-IV-V).
- Need to change the key? Run a sequence through `transpose_progression` and get an entire, harmonically stable progression in minutes, not hours.
- Don't guess theory. Ask the tool what the harmonic function of any chord is within its specific key using `resolve_harmonic_function`.
- It handles complex data parsing; use `parse_progression_string` to cleanly separate and analyze a massive list of chords you scribbled down.
- Get deep technical details on single notes or chords, like inversions or scale degrees, with the `get_chord_metadata` tool.

## How It Works

The bottom line is you stop manually cross-referencing theory books and start working with structured musical analysis right inside your agent's chat window.

1. Give the MCP a sequence of chords or a Roman numeral progression.
2. Specify your desired output, such as converting to Roman numerals or transposing it to a new key.
3. The tool returns the analyzed, converted, or transposed chord data in clear notation.

## Frequently Asked Questions

**How do I use Roman Numeral Converter to find the harmonic function?**
You must first provide a chord and specify the key. For example, ask: 'What is the harmonic function of Am in C major?' The tool uses `resolve_harmonic_function` to give you the precise theoretical answer (vi).

**Can I transpose an entire song progression using Roman Numeral Converter?**
Yes. Use the `transpose_progression` tool. Give it your starting sequence and tell it the new key, and it returns a fully mapped, transposed list of chords.

**Is this MCP better than just looking at chord charts?**
Yes. Standard charts only show notes; this MCP shows *function*. It tells you if that chord is acting as the dominant (V) or the submediant (vi), which changes what it means musically.

**What does `parse_progression_string` do?**
`parse_progression_string` cleans up raw input. It takes a jumbled string of chords and breaks it down into a clean, structured list that the other analysis tools can read.

**Does Roman Numeral Converter handle different time signatures?**
The tool focuses on harmonic function and key changes rather than rhythm. It handles chord relationships regardless of specific time signature input.