# Karaoke Scoring Simulator AI Agent Connect

> A deterministic simulator for Japanese karaoke scoring (DAM/JOYSOUND) based on pitch, rhythm, and vibrato.

## Overview
- **Category:** entertainment
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_rDByq2q8ZOmpKceeEWOFTqFppQtKQ0eLerbLTVXe/ai-agent-connect
- **Tags:** karaoke, scoring, music-tech, dam, joysound

## Description

This MCP server provides a precise simulation of professional Japanese karaoke scoring systems like DAM and JOYSOUND. It allows AI agents to evaluate singing performance by calculating deductions for pitch and rhythm errors, applying technical bonuses for vibrato, and scaling the final result based on song difficulty. Use `score_performance` to get a complete breakdown of metrics, or `validate_performance_inputs` to ensure singer data is within valid ranges before processing.

## Tools

### get_difficulty_multiplier
Retrieves the scaling factor associated with a specific song difficulty level

### score_performance
Calculates the final performance metrics and score based on singer accuracy and song difficulty

### validate_performance_inputs
Checks if a set of performance metrics is mathematically valid before processing

## Prompt Examples

**Prompt:** 
```
Calculate the score for a singer with 90% pitch accuracy, 85% rhythm accuracy, 4 vibrato instances, and a song difficulty of 3.
```

**Response:** 
```
The performance results are: pitch deduction of 5.0, rhythm deduction of 4.5, vibrato bonus of 2.0, and a final score of 93.
```

**Prompt:** 
```
What is the difficulty multiplier for a song with difficulty level 5?
```

**Response:** 
```
The multiplier for difficulty level 5 is 1.1.
```

**Prompt:** 
```
Check if these metrics are valid: pitch 105%, rhythm 90%, vibrato 2, difficulty 3.
```

**Response:** 
```
The metrics are invalid. The pitch accuracy percentage must be between 0 and 100.
```

## Frequently Asked Questions

**How is the final score calculated?**
The score starts at 100, subtracts deductions for pitch and rhythm accuracy, adds a vibrato bonus (up to 10), and applies a multiplier based on the song difficulty level.

**Can I validate my input data first?**
Yes, you can use the `validate_performance_inputs` tool to check if the pitch, rhythm, vibrato, and difficulty values are within the required mathematical ranges.

**What is the maximum vibrato bonus?**
The vibrato bonus is calculated as the number of vibrato instances multiplied by 0.5, with a maximum possible bonus of 10.