# Pyramid Scheme Builder MCP for AI Agents MCP

> Pyramid Scheme Builder lets you create and compare structured training repetition sets for strength athletes. It handles the math for ascending, peaking, and descending phases of a workout. Use it to figure out exactly how many reps to do at each weight step to hit your target volume without guessing. It's built for people who need precision in their progressive overload planning.

## Overview
- **Category:** fitness
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_JTDSEF4GmS12IdSyiJaUIBqPweMdyiOIcEUVeees/mcp
- **Tags:** strength-training, progressive-overload, workout-builder, repetition-tracking, pyramid-sets

## Description

If you're a strength athlete or a fitness coach, you know that managing volume is a constant balancing act. You want to push your limits, but you also need to make sure your progression makes sense mathematically so you don't burn out or miss your targets. This MCP takes the guesswork out of that planning phase. Instead of scribbling notes or using a messy spreadsheet to figure out your rep counts, you can just describe your peak goal to your AI client. It handles the heavy lifting of calculating the sequence for every step of the pyramid, ensuring your total workload is exactly what you intended. It's a great way to get organized because it's part of the Vinkius catalog, meaning you can pull this into your existing workflow without hunting for a separate app. You can check if your plan is actually solid before you head to the gym, or compare two different ways of structuring the same workout to see which one actually puts more work on your muscles. It turns a tedious math problem into a quick conversation with your agent. You get a clear, accurate plan that lets you focus on the actual lifting rather than the arithmetic of your training block.

## Tools

### compare_scheme_intensities
Compare two different pyramid structures to see which one generates more total work. This helps you decide which workout path is actually heavier.

### generate_pyramidal_sequence
Create a full list of reps for a workout based on your peak goal and step size. It also calculates the total volume for the whole session.

### validate_scheme_parameters
Check if your proposed training numbers are mathematically sound. Use this to catch errors in your planning before you start lifting.

## Prompt Examples

**Prompt:** 
```
I want to do a pyramid with 8 peak reps, increasing by 2 each time. What's the sequence?
```

**Response:** 
```
### Your Training Sequence
Based on a peak of **8 reps** with an increment of **2**, here is your pyramid:

*   **Set 1:** 2 reps
*   **Set 2:** 4 reps
*   **Set 3:** 6 reps
*   **Set 4:** 8 reps (Peak)
*   **Set 5:** 6 reps
*   **Set 6:** 4 reps
*   **Set 7:** 2 reps

**Total Volume:** 32 repetitions.
```

**Prompt:** 
```
Compare a pyramid of 6 peak reps with 1-rep steps vs 10 peak reps with 2-rep steps.
```

**Response:** 
```
### Intensity Comparison
Here is how the two structures compare in terms of total work:

| Scheme | Peak | Increment | Sequence | Total Volume |
| :--- | :--- | :--- | :--- | :--- |
| **Option A** | 6 | 1 | 1,2,3,4,5,6,5,4,3,2,1 | 37 reps |
| **Option B** | 10 | 2 | 2,4,6,8,10,8,6,4,2 | 50 reps |

**Result:** Option B is significantly heavier, providing **13 more repetitions** total.
```

**Prompt:** 
```
Can I do a pyramid that goes from 2 to 15 reps with 3-rep increments?
```

**Response:** 
```
### Parameter Validation
I checked the math for a pyramid starting at 2 reps with a 3-rep increment to a peak of 15.

**Status:** ✅ **Valid**

**The resulting sequence is:**
2, 5, 8, 11, 14, 15, 14, 11, 8, 5, 2

**Total Volume:** 95 repetitions.
```

## Capabilities

### Generate full rep sequences
Create a complete list of repetitions for a workout based on your peak goal and step size.

### Validate training parameters
Check if your proposed training numbers are mathematically sound before you start.

### Compare workout intensities
See which of two different pyramid structures generates more total volume.

### Calculate total session volume
Get the total number of repetitions for a specific training session automatically.

### Map ascending and descending phases
Build out the full path from your starting weight to your peak and back down again.

## Use Cases

### Comparing peak set variations
A coach wants to know if a 3-set peak is harder than a 2-set peak. They use compare_scheme_intensities to see the volume difference.

### Building a specific peaking block
A lifter wants a 10-rep peak with steps of 2. They use generate_pyramidal_sequence to get the 2, 4, 6, 8, 10, 8, 6, 4, 2 list.

### Verifying plan logic
A user isn't sure if a specific pyramid is even possible. They run validate_scheme_parameters to check the math.

### Tracking weekly volume
To keep an eye on total reps over weeks, a user uses the sequence generator to get the total volume for every session.

## Benefits

- Stop guessing your rep counts. Use generate_pyramidal_sequence to get an exact plan for every set of your workout.
- Ensure your programming is sound. validate_scheme_parameters catches math errors before you ever step into the gym.
- Make better training choices. Use compare_scheme_intensities to see exactly how much more volume one structure gives over another.
- Track your total workload accurately. The MCP calculates the total volume of your session automatically so you can monitor progress.
- Save time on programming. Instead of manual calculations, you can describe your goals and let the agent build the sequence for you.

## How It Works

The bottom line is you get a mathematically sound training plan without having to do the manual math yourself.

1. Tell your agent your peak reps, your step increments, and how many peak sets you want.
2. The MCP calculates the full repetition sequence and total volume for you.
3. You get a clear list of reps to follow during your next session.

## Frequently Asked Questions

**What is the Pyramid Scheme Builder MCP?**
It is a tool that helps you calculate the exact repetition counts for pyramid-style workouts. It handles the math for your sets so you can plan your training volume accurately.

**How can I use this for my powerlifting prep?**
You can use it to map out your peaking blocks. By defining your peak reps and increments, the tool generates the full rep sequence for your heavy sets.

**Does this tell me which exercises to do?**
No, it doesn't suggest specific exercises. It focuses purely on the repetition math for the movements you have already chosen.

**How does it help me with my training volume?**
It calculates your total volume automatically. This helps you ensure you're hitting your weekly targets without having to manually add up every set.

**Can it check if my workout plan is correct?**
Yes, it can validate your parameters. If you have a specific goal in mind, it will check if the math for your rep increments and peak is sound.

**What is a pyramidal progression in lifting?**
It's a training method where the number of reps increases to a peak and then decreases. This MCP automates the math for those specific sets.

**What is a pyramid scheme in training?**
In this context, it refers to a set of repetitions that increases by a fixed amount until a peak is reached, then decreases back to the starting value.

**How do I use the sequence generator?**
Use the `generate_pyramidal_sequence` tool by providing your target peak reps and the step increment you want to use for each set.

**Can I repeat the top of the pyramid?**
Yes, by using the `peakSets` parameter in the generator, you can specify how many times to hold the maximum repetition count before starting the descent.