# Voice Leading Checker MCP for AI Agents AI Agent Connect

> Voice Leading Checker analyzes musical note movements between chord voicings to identify harmonic errors like parallel fifths and octaves. It provides quality scores and suggested alternative voicings for SATB arrangements, ensuring your harmony follows classical music theory principles.

## Overview
- **Category:** analysis
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_AE7mBjSfASougT2yczI7GtD6kMgaA9neVF04vCXy/ai-agent-connect
- **Tags:** harmony, voice-leading, musicology, satb, composition, musical-analysis

## Description

If you're working on a complex choral arrangement, you know how easy it is to miss a parallel fifth or an awkward voice crossing buried in a dense score. Instead of squinting at every single note in your Bass, Tenor, Alto, and Soprano lines, you can let your AI client handle the heavy lifting. This Connector acts as a dedicated music theory engine that audits your chord transitions for technical integrity. It looks for the specific errors that make a piece sound amateur, like excessive melodic leaps or voices that jump out of their proper order. It doesn't just flag the problem; it gives you a smoothness score and actual suggestions for how to rearrange your notes to keep the transition clean. You'll find this and thousands of other specialized tools in the Vinkius catalog, making it easy to build a professional musicology suite into your agent's capabilities. This means you can focus on the artistry of your composition while getting a technical audit that ensures your work meets classical standards.

## Tools

### analyze_voice_conduction
Analyzes the movement between two specific chord voicings. It identifies harmonic errors like parallel fifths or octaves.

### check_voice_hierarchy
Validates that your voices are in the correct ascending order. It prevents errors where notes from different parts cross each other.

### evaluate_smoothness
Calculates a quality score for a musical transition. It looks at leap magnitudes and violation counts to judge the flow.

## Prompt Examples

**Prompt:** 
```
Is this transition from C major to F major okay? Bass: 48, Tenor: 55, Alto: 60, Soprano: 65 to Bass: 55, Tenor: 62, Alto: 67, Soprano: 72.
```

**Response:** 
```
I have analyzed the transition for you. Here is the report:

| Metric | Result |
| :--- | :--- |
| **Parallel Fifths** | None detected |
| **Parallel Octaves** | None detected |
| **Voice Crossing** | None detected |
| **Smoothness Score** | 95/100 |

The movement is very smooth and follows classical standards.
```

**Prompt:** 
```
How smooth is a transition that has a total leap sum of 15 and two violations?
```

**Response:** 
```
Based on the analysis, the transition quality is rated as **Low**. 

* **Violations**: 2 (Parallel fifths detected)
* **Leap Magnitude**: 15
* **Smoothness Score**: 42/100

Because of the high leap sum and the presence of violations, this transition will likely sound jumpy or technically incorrect.
```

**Prompt:** 
```
Check if my voices are in the right order: Bass 45, Tenor 40, Alto 50, Soprano 60.
```

**Response:** 
```
The voice hierarchy is **Invalid**. 

* **Error**: The Tenor pitch (40) is lower than the Bass pitch (45).
* **Status**: Voice Crossing detected.

You should rearrange the Tenor line to be higher than the Bass to maintain a correct ascending order.
```

## Capabilities

### Detect parallel fifths and octaves
The tool identifies forbidden harmonic movements between two chord voicings.

### Validate voice hierarchy
It ensures your voices stay in the correct ascending order without crossing.

### Score transition smoothness
Get a numerical quality grade based on leap magnitudes and violation counts.

### Identify voice crossing
It flags instances where different melodic lines overlap or swap positions.

### Get alternative voicings
Receive specific suggestions for fixing detected harmonic errors.

## Use Cases

### Choral Arrangement Audit
A composer wants to check a transition from a G major to a C major chord in an SATB arrangement to ensure no parallel octaves occur.

### Music Theory Exam Prep
A student wants to know if their leap from a specific bass note is too large for a smooth transition during a practice session.

### Historical Score Analysis
A musicologist wants to verify if a historical score follows standard classical voice-leading rules using a batch of transitions.

### Real-time Harmony Check
A songwriter wants to quickly check if their four-part harmony sounds correct before finalizing a melody for a recording.

## Benefits

- Stop worrying about parallel fifths by using analyze_voice_conduction to catch errors instantly.
- Keep your parts organized with check_voice_hierarchy to ensure voices never cross.
- Get objective quality scores on your transitions using evaluate_smoothness to track progress.
- Save hours of manual analysis by letting your agent identify specific harmonic violations.
- Improve your arrangement skills with suggested alternative voicings for every error found.

## How It Works

The bottom line is you get a professional music theory audit for your chord progressions in seconds.

1. Input your initial and target chord voicings in SATB format.
2. The Connector analyzes the conduction and hierarchy of the notes.
3. Receive a report on violations, smoothness scores, and suggested fixes.

## Frequently Asked Questions

**Can the Voice Leading Checker find parallel fifths in my music?**
Yes, it specifically identifies parallel fifths and octaves between your chord voicings. It helps you catch these common harmonic errors instantly.

**How does Voice Leading Checker help with choral arrangements?**
It audits your SATB parts to ensure that voices stay in the correct order and that your transitions are smooth and technically correct.

**What kind of musical analysis does Voice Leading Checker perform?**
The tool performs an analysis of note conduction, voice hierarchy, and transition smoothness. It checks for leaps, crossings, and classical harmonic violations.

**Can I use Voice Leading Checker to check my SATB voicings?**
Yes, it is designed specifically for SATB (Bass, Tenor, Alto, Soprano) arrangements. It validates the movement of all four melodic ranges at once.

**Will Voice Leading Checker suggest better ways to write my chords?**
Yes, when it detects a violation, the tool provides suggested alternative voicings. This helps you correct errors while maintaining your intended harmony.

**How does Voice Leading Checker score my music?**
It provides a smoothness score based on the magnitude of note leaps and the number of harmonic violations found in a transition.

**How can an agent detect parallel fifths?**
Agents use the `analyze_voice_conduction` tool, providing initial and target voicings. The tool identifies when two voices move in the same direction while maintaining a perfect fifth interval.

**What does `check_voice_hierarchy` do?**
The `check_voice_hierarchy` tool ensures that the pitch values for Bass, Tenor, Alto, and Soprano are in correct ascending order, preventing voice crossing errors.

**Can I get suggestions for better voicings?**
Yes. When using `analyze_voice_conduction`, the tool returns a `suggested_voicing` object containing an alternative arrangement that resolves detected violations.