# Circle of Fifths Navigator MCP for AI Agents MCP

> The Circle of Fifths Navigator helps musicians map out complex musical keys and their relationships. It identifies dominant, subdominant, relative keys, and natural modulation paths using established music theory frameworks. This MCP gives your AI agent the knowledge to analyze scales, find enharmonic equivalents, and structure compositions by understanding how different keys relate to one another.

## Overview
- **Category:** education
- **Price:** Free
- **Tags:** music-theory, circle-of-fifths, composition, musicology, scales, modulation

## Description

Do you spend time manually cross-referencing key signatures or trying to map a difficult modulation path? The Circle of Fifths Navigator gives you the analytical power to visualize and understand tonal relationships instantly. This MCP lets your AI agent analyze any given key, telling you everything about its musical neighbors—the dominant, subdominant, relative major, and minor keys. Need technical specifics? It retrieves details like accidental order and available modes for a scale. For advanced composition, you can plot natural modulation paths to see exactly which keys are adjacent or within reach. You'll find that Vinkius hosts this MCP alongside thousands of others, giving your agent access to a massive catalog of specialized knowledge. Instead of flipping through theory books, you just ask your agent to analyze the relationship between two distant keys and get the answer immediately.

## Tools

### get_enharmonic_mapping
Finds alternative notations for a given key, answering questions about how else that key can be written.

### get_key_neighbors
Lists the closest musical relatives to an input key, including its dominant, subdominant, relative major, and relative minor keys.

### get_key_signature_details
Provides a detailed breakdown of a key's scale components, such as accidental order and available modes.

### calculate_modulation_paths
Identifies natural modulation paths from a starting key by calculating musically appropriate adjacent keys.

## Prompt Examples

**Prompt:** 
```
What are my options for modulating away from D Major?
```

**Response:** 
```
**Key Neighbors of D Major:**
*   **Dominant Key:** A Major (Distance +1)
*   **Subdominant Key:** G Major (Distance -1)
*   **Relative Minor:** B Minor
*   **Relative Major:** D Major (Self)

These options give you solid starting points for your next musical section. You can also check `calculate_modulation_paths` to find even more distant, but natural targets.
```

**Prompt:** 
```
I need a key that sounds like E Minor, but written differently.
```

**Response:** 
```
**Enharmonic Mapping for E Minor:**
*   **Alternative Spelling:** F-flat minor (Fbm)
*   **Key Signature Details:** 4 flats.
*   **Available Modes include:** Aeolian, Dorian, Phrygian. 

This shows that while the name changes, the underlying musical structure and modes remain consistent.
```

**Prompt:** 
```
What are the scale components for F# Major?
```

**Response:** 
```
**F# Major Scale Analysis**
*   **Flats/Sharps:** 6 sharps (F#, C#, G#, D#, A#, E#)
*   **Available Modes:** Ionian, Dorian, Phrygian, Lydian, Mixolydian, Aeolian.
*   **Accidental Order Check:** The scale maintains a clear, predictable pattern of accidentals, which is crucial for composition.
```

## Capabilities

### Identify Key Neighbors
Finds the dominant, subdominant, relative major, and relative minor keys for any given musical key.

### Map Modulation Paths
Calculates natural modulation targets, showing which keys are musically reachable from a starting point and how far away they sit on the circle.

### Determine Key Structure Details
Provides technical components for a key's scale, including available modes and accidental order.

### Find Notation Equivalents
Maps a given key to its enharmonic equivalents, offering alternative spellings or notations.

## Use Cases

### A composer needs a bridge section that sounds related but not identical to the main theme.
The agent uses the Circle of Fifths Navigator to run `get_key_neighbors` on the current key. It discovers the subdominant and relative minor keys, allowing the composer to write a new 'bridge' section in one of those closely related tonal centers.

### A student is studying harmonic movement for an assignment.
The student asks their agent about modulation paths. The agent runs `calculate_modulation_paths`, showing the student a clear, visualized route from C Major to G Major (distance +1) and F Major (distance -1), which they then incorporate into their piece.

### A songwriter needs to ensure all sections of a song feel tonally cohesive.
The agent uses `get_key_signature_details` on the chorus key, identifying its available modes (like Dorian or Aeolian). This tells the songwriter exactly which scale types they should stick to in the verse for maximum coherence.

### A score needs a section written that sounds technically different but is musically identical.
The agent runs `get_enharmonic_mapping` on the key of F# Major. It returns its equivalent as Gb Major, allowing the composer to write the passage using alternative notation while maintaining the intended harmony.

## Benefits

- Instantly identify key relationships. Instead of guessing, you can ask the agent to use `get_key_neighbors` to reveal the dominant and subdominant keys for any piece.
- Plan complex transitions with confidence. Use `calculate_modulation_paths` to map out natural modulation targets, ensuring your music flows logically from one section to the next.
- Get technical scale data on demand. The `get_key_signature_details` tool provides immediate access to a key's modes and accidental order, saving manual chart work.
- Avoid notation roadblocks. If you need to write the same key in different fingerings or notations, `get_enharmonic_mapping` finds every equivalent spelling for you.

## How It Works

The bottom line is that you get instant, comprehensive musical analysis without ever leaving your AI agent's chat interface.

1. Provide the MCP with a starting musical key (e.g., 'G Major') and any specific parameters, like maximum distance for modulation.
2. The agent sends this request to the Circle of Fifths Navigator, which analyzes the input against established music theory rules.
3. You receive structured data detailing related keys, technical scale components, or a list of natural modulation targets.

## Frequently Asked Questions

**How does the Circle of Fifths Navigator help me plan my transitions between keys?**
It helps by identifying natural modulation paths. Instead of randomly switching keys, you can ask it to find musically logical next steps, ensuring your music always flows smoothly and intentionally.

**Can I use the Circle of Fifths Navigator for non-Western musical scales?**
The tool is built on classical Western music theory. It excels at analyzing keys using standard accidentals, modes, and octave relationships common in European composition.

**What if I need to write the same key but with a different set of sharps or flats?**
You can use its enharmonic mapping tool. It shows you equivalent keys using completely different notations (like going from F# major to Gb major), which is helpful for specific instrumentation.

**Does the Circle of Fifths Navigator only deal with simple relationships?**
No, it handles complex analysis. It can provide technical details like accidental order and lists all available modes for a given key signature, offering deep compositional insight.

**How do I find the closest musical relatives to my current theme's key?**
Just ask it to get the key neighbors. It immediately gives you the dominant, subdominant, and relative keys—all proven candidates for your next section.