# Chord Substitution Finder MCP for AI Agents AI Agent Connect

> Chord Substitution Finder helps you identify harmonic substitutions and analyze tension in chord progressions. It allows you to explore Tritone, Relative, Parallel, Diatonic, and Chromatic Mediant substitutions while checking how each change affects your harmonic movement and voice leading. Use it to break out of repetitive loops and find fresh, sophisticated ways to transition between keys or moods in your music.

## Overview
- **Category:** music-theory
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_ZAgrIuNaZTebTYCxaLhSjDKlNDByFaDEFkLvSk9u/ai-agent-connect
- **Tags:** harmony, chords, musicology, composition, jazz-theory

## Description

The Chord Substitution Finder lets you move past basic chord progressions by identifying sophisticated harmonic swaps. If you're stuck in a repetitive loop or want to spice up a standard jazz progression, you can ask your agent to find specific moves like Tritone, Relative, or Chromatic Mediant substitutions. It doesn't just give you a list of notes to play. It explains how each change affects the tension of your music and how the voices actually move between chords. This makes it a go-to for anyone who needs to understand the "why" behind a transition rather than just memorizing a chart. You'll find this tool stands out in the Vinkius marketplace because it treats music theory as a logic engine rather than just a static list. It gives you a way to explore complex harmony and get immediate feedback on the emotional weight of your musical choices. Whether you're writing a film score, a pop hit, or a new jazz standard, this Connector helps you navigate the rules of harmony with confidence. It removes the guesswork from complex theory, allowing you to focus on the creative side of your composition while the engine handles the heavy lifting of interval math and tension analysis. By automating the calculation of intervals and voice leading, it allows you to experiment with more daring changes without worrying about the technicalities.

## Tools

### analyze_progression_tension
Analyze the tension arc of a chord progression. It identifies where the music feels heavy or resolved.

### get_substitution_detail
Get detailed information about a specific chord substitution. It explains the theory behind a specific move.

### find_substitutions
Find available chord substitutions for a given chord. It shows different ways to swap chords.

## Prompt Examples

**Prompt:** 
```
What can I swap Cmaj7 with?
```

**Response:** 
```
Here are some common substitutions for **Cmaj7**:

| Substitution | Type | Tension | Notes |
| :--- | :--- | :--- | :--- |
| **Db7** | Tritone | High | Creates a smooth, chromatic slide |
| **Am7** | Relative | Low | Provides a soft, modal shift |
| **Abmaj7** | Chromatic Mediant | Medium | Offers a distant, cinematic color |

Would you like more details on any of these?
```

**Prompt:** 
```
Analyze the tension of [Fmaj7, G7, Cmaj7].
```

**Response:** 
```
I've analyzed the tension arc for your progression:

* **Fmaj7**: Low Tension (Stable)
* **G7**: Medium Tension (Building)
* **Cmaj7**: High Tension (Resolved)

The progression follows a standard **Low > Medium > High** arc, providing a clear sense of resolution at the final chord.
```

**Prompt:** 
```
Explain a Tritone substitution.
```

**Response:** 
```
A **Tritone Substitution** involves replacing a dominant seventh chord with another dominant seventh chord that is an augmented fourth (or diminished fifth) away.

**Key details:**
* It maintains the same "tritone" interval between the 3rd and 7th.
* It creates a smooth, chromatic bass line.
* **Example:** Replacing **G7** with **Db7**.
```

## Capabilities

### Find specific chord swaps
Identify various harmonic substitutions for any given chord.

### Measure progression tension
Analyze the tension arc of a chord sequence to map emotional weight.

### Get deep theory details
Receive detailed explanations on specific substitution mechanics.

### Analyze voice leading
See how notes move between chords to ensure smooth transitions.

### Explore chromatic mediants
Discover complex harmonic moves that create unexpected colors.

## Use Cases

### Spicing up a jazz standard
A jazz pianist wants to spice up a standard II-V-I progression and uses find_substitutions to find fresh chord swaps.

### Building tension in a film scene
A film composer needs to build tension in a specific scene and uses analyze_progression_tension to map the arc.

### Breaking out of a songwriting loop
A songwriter is stuck in a repetitive loop and uses the Connector to find a Chromatic Mediant substitution.

### Analyzing voice leading for students
A music theory teacher uses get_substitution_detail to show students how notes move between specific chords.

## Benefits

- Stop repeating the same four chords by using find_substitutions to find fresh paths.
- Map your song's emotional journey by using analyze_progression_tension to see where the tension peaks.
- Understand the "why" behind the music as get_substitution_detail provides deep theory on every move.
- Master advanced jazz moves like Tritone or Chromatic Mediants without having to memorize every rule.
- Improve your voice leading automatically because the Connector explains how notes move between chords.

## How It Works

The bottom line is you get instant, accurate music theory advice to make your compositions more sophisticated without doing the manual math.

1. Provide a chord or a full progression to your agent.
2. The Connector identifies the harmonic context and available substitutions.
3. You receive a list of options with tension scores and theory details.

## Frequently Asked Questions

**Can the Chord Substitution Finder help me write jazz?**
Yes, it's perfect for finding sophisticated jazz moves like Tritone substitutions and helping you move beyond basic triads.

**Does the Chord Substitution Finder work for film scores?**
Yes, it allows you to map out the tension arc of a scene to ensure the music matches the emotional weight of the visuals.

**What kinds of substitutions can I find with this?**
You can find Tritone, Relative, Parallel, Diatonic, and Chromatic Mediant substitutions for any chord you provide.

**How do I use the Chord Substitution Finder to find tension?**
Just provide a sequence of chords, and the tool will analyze the progression to tell you where the tension builds and where it resolves.

**Can the Chord Substitution Finder explain Chromatic Mediants?**
Yes, it provides deep theory details on complex moves like Chromatic Mediants, explaining the logic behind the change.

**Is the Chord Substitution Finder for beginners?**
It works for everyone. Beginners can use it to learn theory, while pros can use it to quickly brainstorm complex harmonic ideas.

**Can I use it to check voice leading?**
Yes, it explains how the notes move between chords, helping you ensure your transitions sound smooth and intentional.

**What types of substitutions can I find?**
The engine supports Tritone, Relative, Parallel, Diatonic, and Chromatic Mediant substitutions.

**How do I analyze a whole progression?**
Use the `analyze_progression_tension` tool by providing a JSON array of chords.

**Can I see how voice leading changes?**
Yes, the `find_substitutions` tool provides details on the voice leading effect for each substitution.