# Song Key Transposer AI Agent Connect

> Song Key Transposer MCP handles the heavy lifting of music theory. It lets your AI client shift entire chord progressions between keys, calculate semitone distances, and break down complex chord symbols into their basic components. Whether you are rewriting a song for a different vocalist or just analyzing notation, this tool gives your agent the musical intelligence it needs.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_ucdYuDs50xb2xEnTqpEtjXV3fDZcE5MU13PSmG0V/ai-agent-connect
- **Tags:** music, chords, transposition, notation, theory

## Description

You can stop manually calculating transpositions and chord structures. This MCP gives your AI client the ability to manipulate musical notation with precision. If you have a chord progression in C Major but need it in Eb Minor, your agent can perform the shift in seconds. It doesn't just move notes; it understands the relationship between keys and the internal structure of chord symbols. You can use it to verify if a key is valid or to find the exact semitone interval between two different keys. It's a specialized toolkit for anyone working with music theory, songwriting, or notation within an AI-driven workflow. Instead of guessing at intervals or manually rewriting every chord, you just give the instruction and let the tool handle the math.

## Tools

### validate_key_existence
Checks if a specific musical key name is valid. It ensures your agent doesn't attempt to transpose using non-existent keys.

### get_transposition_interval
Calculates the semitone distance between two musical keys. This helps your agent understand how far to shift a progression.

### parse_chord_symbol
Breaks a single chord string into its individual parts. It identifies the root, accidentals, and quality of a chord.

### transpose_chords
Shifts a full sequence of chords from a starting key to a target key. This is the primary tool for rewriting progressions.

## Prompt Examples

**Prompt:** 
```
Transpose the chords C, Am, F, G from C Major to G Major.
```

**Response:** 
```
G, Em, C, D
```

**Prompt:** 
```
What is the interval between Eb Minor and Bb Minor?
```

**Response:** 
```
5
```

**Prompt:** 
```
Break down the chord Bbmaj7.
```

**Response:** 
```
Root: Bb, Accidental: b, Quality: maj7
```

## Capabilities

### Chord Transposition
Your agent shifts entire sequences of chords to new keys.

### Interval Calculation
The tool finds the exact semitone distance between any two keys.

### Chord Deconstruction
It pulls apart chord symbols to identify roots and qualities.

### Key Validation
The agent verifies that musical keys are legitimate before processing.

## Use Cases

### Vocal Range Adjustment
You can tell your agent to transpose a song to a lower key to fit a specific singer.

### Theory Analysis
Use the parsing tool to understand the components of difficult jazz chords.

### Composition Assistance
Quickly test how a progression sounds in a different key by shifting the entire sequence.

### Data Cleaning
Standardize chord notation by breaking symbols down into their constituent parts.

## Benefits

- Eliminates manual math for semitone intervals.
- Automates the rewriting of chord sequences.
- Provides instant breakdown of complex chord symbols.
- Prevents errors by validating musical keys.

## How It Works

Connecting this MCP to your AI client gives it immediate access to music theory tools.

1. Connect the MCP to your client like Claude or Cursor via Vinkius.
2. Provide a chord sequence or a key name in your prompt.
3. The agent invokes the specific tool needed for the task.
4. The tool processes the musical logic and returns the result.

## Frequently Asked Questions

**How do I use this with Claude?**
You connect the MCP through the Vinkius platform. Once connected, your Claude client can call the transposition and parsing tools directly.

**Can it handle complex jazz chords?**
Yes, the parse_chord_symbol tool is designed to break down chord strings into their roots, accidentals, and qualities.

**Does it work with any musical key?**
The validate_key_existence tool ensures that the keys being used are valid musical keys before any operations occur.

**What is a semitone interval?**
It is the distance between two notes. The get_transposition_interval tool calculates this distance between keys for you.

**Do I need to host this myself?**
No, Vinkius hosts and manages the MCP, so it is ready to use as soon as you connect your client.

**How do I transpose a song?**
You can use the `transpose_chords` tool by providing the original chord sequence, the source key, and the target key.

**Can I choose between sharps and flats?**
Yes, when using `transpose_chords`, you can set the `preferSharps` parameter to true or false to control the accidental preference.

**What happens if I provide an invalid key?**
The `validate_key_existence` tool will check if the key is valid. If you attempt to transpose using an invalid key, the tool will return an error.