# Scale Generator MCP

> Scale Generator MCP provides structural breakdowns of musical scales across multiple octaves. It lets you discover complex scale families—like Modes or Pentatonic structures—and check if your proposed tonic and scale type are musically valid before composing a single note.

## Overview
- **Category:** music
- **Price:** Free
- **Tags:** music-theory, scales, intervals, musical-notes, octaves

## Description

This connector lets you build complex music theory tools directly into your workflow. If you're working on an app that needs to generate accurate musical data, this MCP handles the heavy lifting. You get structural breakdowns of specific scales across multiple octaves, complete with Roman numeral degrees and enharmonic equivalents. Need to know what scale families exist? You can discover over four popular groups, including Pentatonic and Exotic modes. Plus, you never have to guess if your notes work together; the engine validates any tonic or scale type input instantly. Through Vinkius, you connect this power source once from any MCP-compatible client and get access to precise musical data for everything from game scores to educational curricula.

## Tools

### generate_scale_report
Creates a full structural breakdown of any specific scale across multiple octaves, listing all the notes and their degrees.

### list_available_scales
Finds and lists every supported musical scale family available in the system.

### validate_musical_input
Checks whether a specific tonic note paired with a chosen scale type is mathematically and musically valid.

## Prompt Examples

**Prompt:** 
```
Generate a report for C Major scale with 2 octaves.
```

**Response:** 
```
The C Major scale (2 octaves) includes: I: C, II: D, III: E, IV: F, V: G, VI: A, VII: B. The second octave follows the same pattern starting from the next C.
```

**Prompt:** 
```
What scales are available in the Pentatonic category?
```

**Response:** 
```
The available pentatonic scales include Major Pentatonic and Minor Pentatonic.
```

**Prompt:** 
```
Is F# a valid tonic for the Lydian scale?
```

**Response:** 
```
Yes, F# is a valid tonic and the Lydian scale type is supported by the engine.
```

## Capabilities

### Generate multi-octave scale reports
Instantly generates a complete structural breakdown of a chosen scale across multiple octaves.

### Discover supported scales
Retrieves a list of all the musical scale families and types available in the engine.

### Validate musical inputs
Confirms whether a user's specified tonic note and scale type combination is musically supported.

## Use Cases

### Developing a new music education quiz
An educator needs to build a quiz that only accepts valid harmonic combinations. They can first run `list_available_scales` to map all options, and then use `validate_musical_input` on the front end to ensure students' answers are always musically supported.

### Creating dynamic game music for a fantasy RPG
A developer needs the background score to shift smoothly but remain harmonically consistent. They use `generate_scale_report` on the chosen scale type, getting reliable note data that dictates the limits of the entire musical system.

### Harmonizing a complex piece for publication
A composer has an idea but isn't sure if their proposed key signature is viable. They use `validate_musical_input` to check their tonic against various scale types, quickly ruling out impossible combinations.

### Building a comprehensive music reference tool
A developer wants to list every recognized musical structure. They run `list_available_scales`, pulling in all the necessary data families—Modes, Pentatonic, etc.—to populate their entire database.

## Benefits

- Stop guessing if a scale works. Use `validate_musical_input` to confirm instantly that your tonic and scale type are mathematically sound before writing code or music.
- Generate huge reports without manual calculation. The `generate_scale_report` tool gives you structural breakdowns across multiple octaves, saving hours of notation work.
- Never get stuck on what scales exist. Run `list_available_scales` to discover every supported family, from Pentatonic to Exotic modes, giving you creative options.
- Write smarter music theory tools. You can feed the engine any tonic and ask it if that combination is valid, making your app much more robust.
- Cut down on data cleanup. The detailed reports provide not just notes, but Roman numeral degrees and enharmonic equivalents, ready for direct use in documentation.

## How It Works

The bottom line is that it turns theoretical music knowledge into reliable, actionable data points.

1. Start by checking the system to validate if your chosen starting note (tonic) and desired scale type are legitimate combinations.
2. If the input passes validation, you select how many octaves of detail you need for that specific scale structure.
3. The MCP returns a structured report detailing every note in the requested range, including its Roman numeral degree and enharmonic name.

## Frequently Asked Questions

**How does Scale Generator MCP validate musical input?**
It checks if your chosen tonic note and scale type combination is mathematically and theoretically sound. This prevents your app from generating impossible or non-existent scales.

**Can I use generate_scale_report for more than one octave?**
Yes, the `generate_scale_report` tool handles multi-octave breakdowns easily. You just specify the number of octaves you need in your request.

**What kinds of scales can list_available_scales find?**
It finds a wide range of families, including standard modes like Dorian and Phrygian, as well as specific types like Pentatonic and Exotic scales.

**Is Scale Generator MCP just for Western music theory?**
The engine is designed to handle complex musical structures. Use `list_available_scales` first to see the full range of supported systems.

**What format does generate_scale_report return?**
It returns a structured data output containing every note, its Roman numeral degree (I, II, etc.), and its enharmonic equivalent.