# Set-List Planner MCP for AI Agents AI Agent Connect

> Set-List Planner helps musicians design better live shows. It analyzes your song list to make sure the energy flows correctly, the transitions don't feel weird, and you don't burn out halfway through the set. It's built for anyone who needs to move from a messy list of tracks to a professional, high-impact performance arc.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_MbwdjsrfATwBhytZ2RCn4eegODptUJpAODo5d8Pr/ai-agent-connect
- **Tags:** musician, setlist, live-performance, energy-curve, music-theory

## Description

Organizing a live set is usually a guessing game. You might have a great list of songs, but if you play your most high-energy track in the middle of a slow acoustic section, you lose the crowd. Or worse, you hit a wall of exhaustion because you didn't pace your physical output correctly. This Connector changes that by turning your setlist into a data-driven performance map. Instead of just dragging and dropping songs, you can actually see how the keys and tempos interact. You'll get a clear picture of where the peaks and valleys are, helping you build a narrative that keeps people moving. It handles the heavy lifting of music theory and pacing so you can focus on the actual performance. When you connect this through the Vinkius catalog, you're essentially giving your AI agent a music theory degree and a decade of touring experience. It's the difference between just playing a list of songs and actually putting on a show that feels cohesive from the first note to the final encore.

## Tools

### analyze_transition_smoothness
analyze_transition_smoothness evaluates how well two songs flow together based on key and tempo. It helps you spot jarring jumps before you get on stage.

### optimize_set_sequence
optimize_set_sequence rearranges your songs into a specific energy arc. Use it to build a set that starts strong, dips in the middle, and ends with a climax.

### extract_performance_metadata
extract_performance_metadata pulls out key information like primary keys and warm-up data from your list. It makes it easier to plan your technical prep.

## Prompt Examples

**Prompt:** 
```
I have 6 songs for a 30-minute set. Can you arrange them so they build up to a big finish?
```

**Response:** 
```
Certainly! I've analyzed your tracks and rearranged them into a 'Mountain Arc' using `optimize_set_sequence`. Here is your new order:

| Order | Song Title | Energy | BPM | Key |
| :--- | :--- | :--- | :--- | :--- |
| 1 | Opening Track | High | 128 | Am |
| 2 | Vibe Setter | Med | 120 | G |
| 3 | The Deep Cut | Low | 90 | Em |
| 4 | Build Up | Med | 115 | D |
| 5 | Energy Peak | High | 130 | C |
| 6 | Finale | Max | 140 | G |

This sequence ensures you don't burn out too early and keeps the crowd's attention moving toward the climax.
```

**Prompt:** 
```
Check if moving from a 110 BPM song in G Major to a 125 BPM song in Bb Major sounds smooth.
```

**Response:** 
```
I ran `analyze_transition_smoothness` on that jump for you. 

**Result: Jarring**

Because of the significant jump in tempo and the distance on the Circle of Fifths, this might feel like a stumble to the audience. I'd recommend finding a 'bridge' song in the middle that sits around 118 BPM and a mix of those two keys to smooth out the shift.
```

**Prompt:** 
```
Look at my setlist and tell me what key I should warm up in first.
```

**Response:** 
```
Based on the `extract_performance_metadata` from your 20-song list, **G Major** is your primary key. 

Since 60% of your songs are in G Major or its relative minor, starting your vocal warmups there will give you the best range for the majority of your set.
```

## Capabilities

### Reorder songs for better energy
Rearrange your tracks to create a specific emotional arc for your audience.

### Check transition smoothness
See if jumping between two songs will sound jarring or fluid.

### Find vocal warm-up keys
Identify which keys appear most often to plan your pre-show prep.

### Spot tempo jumps
Detect large BPM changes that might disrupt the flow of the set.

### Plan performance breaks
Find natural points in the music to take a breather or swap instruments.

## Use Cases

### Fixing a mid-set energy crash
A band leader realizes they're exhausted by song three. They ask the agent to reorder the list to spread out the high-intensity tracks using optimize_set_sequence.

### Verifying a tricky transition
A DJ wants to know if jumping from 110 BPM to 125 BPM in a different key will sound weird. They use analyze_transition_smoothness to get a smoothness rating.

### Planning vocal warmups
A singer wants to know what key they should warm up in. They use extract_performance_metadata to find the most frequent key in their 20-song set.

### Building a festival climax
A festival act needs a 30-minute set that builds perfectly to a finale. They ask the agent to create a mountain arc using the optimize_set_sequence tool.

## Benefits

- Better crowd engagement by using optimize_set_sequence to create a narrative arc that keeps people moving throughout the entire show.
- Avoid awkward silences or musical whiplash by checking every jump with analyze_transition_smoothness to ensure a fluid experience.
- Save time on technical prep by using extract_performance_metadata to quickly see which keys you'll be hitting most often.
- Prevent physical burnout by identifying mid-set valleys where the band can catch their breath without losing the audience's attention.
- Move from a random list of tracks to a professional-grade production by letting your agent handle the complex music theory calculations.

## How It Works

The bottom line is you get a professionally paced setlist without having to manually calculate every musical transition.

1. Upload your current song list with basic info like BPM, key, and energy level.
2. Ask your agent to rearrange the sequence or check specific transitions.
3. Get a revised setlist with a clear breakdown of the performance flow.

## Frequently Asked Questions

**How does Set-List Planner help my band's live show?**
It helps you organize your songs into a logical flow so the energy stays high and the audience stays engaged from start to finish.

**Can Set-List Planner find the best order for my songs?**
Yes, it analyzes your tracks to create a specific energy arc, moving from a strong opening to a climax.

**Will Set-List Planner tell me if my transitions are too jumpy?**
It evaluates the smoothness of your jumps based on tempo and key, flagging anything that might sound jarring to the audience.

**Can I use Set-List Planner to plan my vocal warmups?**
It can extract metadata from your setlist to identify your most frequent keys, making it easier to know where to start.

**Is Set-List Planner for DJs too?**
It's great for DJs who want to map out BPM and key shifts to ensure a seamless flow on the dance floor.

**How do I get started with Set-List Planner?**
Just provide your list of songs with basic details like BPM and key, and your agent will handle the sequencing.

**How does the energy curve optimization work?**
The `optimize_set_sequence` tool rearranges your songs to follow a 'Standard' pattern: a high-energy opening, a lower-energy middle section (the valley), and a high-energy finale (the climax).

**Can I check if my song transitions are smooth?**
Yes, use the `analyze_transition_smoothness` tool. It calculates the distance between keys on the Circle of Fifths and measures tempo volatility to give you a smoothness rating.

**How can I prepare for my vocal performance?**
Use `extract_performance_metadata` to find the `primaryWarmupKey`. This identifies the most frequent key in your set, helping you prepare your vocal range effectively.