# Chord Substitution Finder MCP MCP

> Chord Substitution Finder identifies harmonic substitutions and analyzes tension in chord progressions. It calculates possible musical variations for single chords or entire sequences, letting you explore Tritone, Relative, Diatonic, Parallel, and Chromatic Mediant changes instantly. Stop guessing; start composing with theory-backed alternatives.

## Overview
- **Category:** music-theory
- **Price:** Free
- **Tags:** harmony, chords, musicology, composition, jazz-theory

## Description

This MCP lets composers and music theorists analyze how changing a chord can affect the whole piece. You give it a starting chord or an entire sequence of chords, and it figures out what variations work best. It doesn't just suggest random changes; it evaluates how those substitutions affect harmonic tension and voice leading motion—the core elements of musical movement. For example, you can check which common substitutes increase the tension in a specific spot, or find alternatives that keep the progression feeling smooth. If your composition feels flat, you ask this MCP to pinpoint where the harmonic structure is weakest and suggests precise chord replacements. When you build complex multi-part arrangements, Vinkius AI Analytics gives you full visibility into exactly what data flowed through every analysis—which substitutions were checked and how they impacted tension. It's pure compositional intelligence that keeps your creative flow going.

## Tools

### analyze_progression_tension
Analyzes the harmonic energy level and emotional arc across a series of chords.

### find_substitutions
Looks up all possible alternative chords for any single chord you provide.

### get_substitution_detail
Provides a clear explanation of the mechanics behind specific substitution types, like Tritone changes.

## Prompt Examples

**Prompt:** 
```
Find substitutions for G7.
```

**Response:** 
```
Running `find_substitutions` for G7... Found Tritone substitution: Db7, which increases tension and creates chromatic movement.
```

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

**Response:** 
```
Using `analyze_progression_tension`... The progression starts with Low tension (Cmaj7) and moves through Medium tension to a High tension dominant (G7).
```

**Prompt:** 
```
What is a Tritone substitution?
```

**Response:** 
```
According to `get_substitution_detail`, a Tritone substitution replaces a dominant seventh chord with another dominant seventh chord an augmented fourth away.
```

## Capabilities

### Find available chord substitutes
The agent identifies multiple viable alternative chords for a single input chord.

### Analyze tension in chord sequences
It evaluates the harmonic energy level that builds or drops across an entire progression of chords.

### Get detailed substitution rules
You can request a deep dive into how one specific type of chord change works theoretically.

## Use Cases

### Fixing a Flat Bridge Section
A composer has a bridge section that sounds dull. They ask their agent to run `analyze_progression_tension` on the sequence and discover it dips too low in harmonic energy. The agent then suggests using specific substitutions found via `find_substitutions` to inject necessary tension.

### Developing a New Jazz Theme
A musician needs variations for a difficult chord like G7. They use the MCP's tools to run `find_substitutions`, quickly identifying Db7 as a viable substitute, and then check its specific rules using `get_substitution_detail` before writing it into their score.

### Analyzing Historical Music
A student is studying Baroque music. They input a common sequence and ask the agent to run `analyze_progression_tension`, comparing the historical pattern's tension arc against modern compositional standards for academic contrast.

## Benefits

- Instead of guessing, you can run `find_substitutions` to instantly see every possible chord swap available for a given note. This keeps your compositional ideas flowing without interruption.
- You get an objective view of tension using `analyze_progression_tension`. It tells you exactly where in the piece the harmonic energy is low or high, so you know when to build drama and when to pull back.
- Need a refresher on theory? Use `get_substitution_detail` to understand what makes a Tritone substitution work. It explains the 'why' behind the suggested chords.
- Build complex arrangements by chaining this MCP with other tools. You can analyze harmony, then send that data to another service for rhythmic arrangement, all through one agent.
- The whole process is safe and transparent because Vinkius AI Analytics tracks every chord checked and how it impacted the tension score.

## How It Works

The bottom line is: you stop manually cross-referencing music theory books; you just ask for the analysis.

1. Specify the starting point: either an individual chord or a full sequence you want to analyze.
2. The MCP runs calculations, checking various theoretical substitution types (Tritone, Relative, etc.) against your input chords.
3. You receive detailed reports showing suggested replacements and quantifying how those changes affect harmonic tension across the progression.

## Frequently Asked Questions

**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.

**If I use `find_substitutions`, what format does the chord name need to be in?**
The tool expects standard musical notation. It handles common variations like Cmaj7 or Dm/F# automatically, so you just give it the root and quality needed for accurate substitution results.

**When I call `get_substitution_detail`, how are my chord progressions kept private?**
Your inputs use Vinkius zero-trust proxy architecture. Credentials pass through without ever being stored on disk, meaning your data is only used in transit and remains highly secure.

**Are there rate limits when I use `analyze_progression_tension` on a large score?**
The platform manages usage quotas. For heavy analysis, check the Vinkius AI Analytics dashboard to monitor your call volume and ensure you stay within your set budget.

**Can I use `find_substitutions` even if my primary agent is running in an environment other than Claude or Cursor?**
You connect through your single MCP-compatible client. As long as that client supports the Model Context Protocol, it can access this tool regardless of its specific underlying platform.

**If I run `find_substitutions` on an ambiguous chord, what kind of error should I expect?**
The tool returns a structured error message. It clearly explains why the substitution failed, usually indicating if the chord is outside standard Western theory or if additional harmonic context is required.