# Tempo Tap Analyzer MCP

> Tempo Tap Analyzer quantifies rhythmic timing, BPM, and groove stability from raw tap sequences. This MCP lets you analyze any set of millisecond timestamps to derive precise musical metrics. You can assess whether a performance sounds human or robotic, determine underlying patterns like ternary rhythms, and calculate average beats per minute instantly. Stop guessing about rhythm; start measuring it.

## Overview
- **Category:** analysis
- **Price:** Free
- **Tags:** tempo, bpm, rhythm, groove, musicology, timing

## Description

This MCP gives musicians and musicologists the data they need to quantify groove and analyze rhythm structure. If you have raw timing information—a list of millisecond taps from a performance or sequence—this connector turns that messy data into actionable musical metrics. You can use your agent to assess the precision of any rhythm, determining if it has a steady, machine-like feel or natural human variation. Need to know what kind of beat structure is at play? It detects complex patterns like binary and ternary subdivisions. Plus, you can calculate average BPM and interval details from those tap timestamps.

When working with raw performance data, having instant access to this level of detail changes everything. Instead of running multiple calculations in a spreadsheet or guessing the pattern by ear, your agent handles it all. You connect once through Vinkius and gain immediate access to these specialized audio analysis tools.

## Tools

### analyze_timing_stability
Checks a given rhythm sequence to see how stable the timing is overall.

### identify_rhythmic_subdivision
Finds and names the repeating rhythmic pattern or subdivision in your tap data (like Ternary or Binary).

### calculate_tempo_metrics
Takes tap timestamps and calculates the average BPM, along with detailed interval measurements.

## Prompt Examples

**Prompt:** 
```
Calculate the BPM for these taps: [0, 500, 1000, 1500]
```

**Response:** 
```
The average BPM is 120. The intervals are all 500ms.
```

**Prompt:** 
```
How stable is this rhythm: [480, 520, 490, 510]?
```

**Response:** 
```
The timing stability is high, indicating a very precise and robotic rhythm.
```

**Prompt:** 
```
What subdivision is present in these intervals: [500, 750, 500, 750]?
```

**Response:** 
```
The detected subdivision is Ternary, with a high confidence score.
```

## Capabilities

### Determine overall rhythm speed
Calculate average BPM and precise interval details from a sequence of tap timestamps.

### Assess performance precision
Analyze the stability of a rhythmic sequence to judge if it sounds highly mechanical or naturally variable.

### Identify underlying beat patterns
Detect specific rhythmic structures, such as Binary, Ternary, or Quaternary subdivisions, present in the taps.

## Use Cases

### Evaluating a live performance recording
An audio engineer records a drum solo. Instead of manually reviewing the waveform for consistency, they ask their agent to run analyze_timing_stability on the tap data. The MCP confirms the timing is highly stable but suggests slight deviations would give it more 'human feel' for mixing.

### Analyzing ethnic drumming patterns
A musicologist has raw tap data from a specific cultural rhythm. They use identify_rhythmic_subdivision to confirm if the pattern is genuinely Ternary, providing concrete evidence for their academic paper.

### Designing a beat-matching game module
A sound designer needs to hit exactly 128 BPM. They use calculate_tempo_metrics on a sample rhythm and confirm the average interval is precisely 500ms, guaranteeing perfect timing for their synth patch.

### Comparing rhythmic complexity
A composer inputs two different tap sequences into the MCP. They run both through identify_rhythmic_subdivision and see one is Binary while the other is Quaternary, helping them structure a more complex piece.

## Benefits

- Stop relying on ear training. Use calculate_tempo_metrics to get precise average BPM and interval details, turning subjective listening into hard numbers.
- Assess human performance quality instantly. analyze_timing_stability tells you if a track sounds highly natural or unnervingly mechanical, letting you fix timing issues before mixing.
- Decode complex beats without guessing. identify_rhythmic_subdivision detects underlying structures like Ternary or Quaternary rhythms, giving context to your tap data.
- Streamline analysis for music theory. You can run multiple tests on the same sequence—calculating tempo while simultaneously identifying subdivisions—all in one chat session.
- Focus on creation, not calculation. By offloading the math (BPM, intervals, patterns) to this MCP, you spend less time troubleshooting spreadsheets and more time making music.

## How It Works

The bottom line is that you feed it raw timing numbers and get back musically structured metrics.

1. Provide your agent with a series of millisecond timestamps representing the tap sequence.
2. Select the analysis mode—whether you want to measure tempo, check stability, or find subdivisions.
3. Your MCP returns structured data including average BPM, interval breakdowns, and pattern classifications.

## Frequently Asked Questions

**How does Tempo Tap Analyzer calculate BPM?**
It calculates BPM by using calculate_tempo_metrics on your tap timestamps. It doesn't just use the start and end times; it processes every interval between taps to determine a true average beat rate.

**Can I tell if a rhythm is human or machine-made with this MCP?**
Yes, you can. Running analyze_timing_stability assesses the sequence for precision. High stability suggests robotic timing, while natural variation indicates a more organic performance.

**What kinds of patterns can identify_rhythmic_subdivision find?**
It detects common rhythmic structures like Binary, Ternary, and Quaternary subdivisions. This helps categorize the underlying beat pattern in your data.

**Does Tempo Tap Analyzer need specific file formats?**
No, it requires raw millisecond timestamps as input. You'll feed these numerical values directly into the MCP through your agent.

**Is this for professional musicology research?**
Absolutely. The level of detail in interval measurements and pattern identification makes it suitable for deep academic analysis of musical performance data.