# Bicycle Speed Calculator AI Agent Connect

> Bicycle Speed Calculator is a specialized MCP that handles cycling math. It lets your AI client calculate speed using metric or imperial units, handle complex time inputs like minutes and seconds, and compare different performance levels. It's built to turn raw ride data into clear velocity metrics without you needing to pull out a calculator.

## Overview
- **Category:** utilities
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_583QTZ4hoGv3n593q8chrS2sNuvvKaHf8IOP84RC/ai-agent-connect
- **Tags:** cycling, speed, velocity, fitness, conversion

## Description

You can stop manually calculating your pace after a long ride. This MCP gives your AI client the specific math tools needed to turn distance and time into accurate speed readings. Whether you track your rides in kilometers or miles, you can feed that data directly to your agent to get your velocity in km/h or mph. 

If your ride data is messy, like a duration measured in hours, minutes, and seconds, the MCP handles that complexity for you. You don't have to convert everything to decimals first. You just provide the raw duration, and the tool does the heavy lifting. You can also use it to see how your current pace stacks up against other speeds, making it easy to track progress or understand relative performance. It's a simple way to add a layer of cycling-specific intelligence to any MCP-compatible client you already use.

## Tools

### calculate_speed_from_imperial
This tool calculates your cycling speed when you provide distance in miles and time in standard units.

### calculate_speed_from_metric
This tool determines your velocity when you input distance in kilometers and time in standard units.

### calculate_speed_from_time_units
This tool computes speed by taking a specific combination of hours, minutes, and seconds as the duration.

### get_speed_comparison
This tool compares different speed values to show you how your performance relates to other levels.

## Prompt Examples

**Prompt:** 
```
I rode 20 kilometers in 0.5 hours. What was my speed?
```

**Response:** 
```
Your speed was 40 km/h (24.85 mph).
```

**Prompt:** 
```
I traveled 10 miles in 1 hour. How fast was I?
```

**Response:** 
```
Your speed was 16.09 km/h (10 mph).
```

**Prompt:** 
```
Calculate my speed for 5 km covered in 15 minutes.
```

**Response:** 
```
Your speed was 20 km/h (12.43 mph).
```

## Capabilities

### Metric Conversions
Your agent uses this to calculate speed when you provide distances in kilometers.

### Imperial Conversions
Your agent uses this to calculate speed when you provide distances in miles.

### Granular Time Math
Your agent uses this to process durations that include specific minutes and seconds.

### Performance Benchmarking
Your agent uses this to compare your current speed against other performance metrics.

## Use Cases

### Post-Ride Analysis
Input your total distance and time to find your average speed immediately.

### Training Progress
Compare your recent speeds to previous rides to see how your fitness is changing.

### Unit Conversion
Convert a mile-based ride into km/h or a kilometer-based ride into mph.

### Precise Timing
Calculate speed using exact durations down to the second.

## Benefits

- Eliminates manual math for distance and time conversions.
- Handles complex time inputs like minutes and seconds automatically.
- Provides both metric and imperial speed outputs.
- Allows for direct performance comparisons.

## How It Works

The MCP connects your AI client to specialized cycling math tools.

1. Connect the MCP to your client like Claude or Cursor via Vinkius.
2. Provide your ride distance and time to your AI agent.
3. The agent selects the correct tool based on your units.
4. The MCP performs the calculation and returns the speed.

## Frequently Asked Questions

**How do I use this MCP with Claude?**
You connect to the Vinkius-hosted MCP once, and then your Claude client can call the speed calculation tools directly during your chat.

**Can I use miles and kilometers?**
Yes. The MCP includes specific tools for both metric and imperial distance inputs.

**Does it handle minutes and seconds?**
Yes. One of the tools is specifically designed to calculate speed using a combination of hours, minutes, and seconds.

**What kind of speed results do I get?**
The tools provide speed results in both km/h and mph.

**Do I need to host this myself?**
No. Vinkius hosts and manages the MCP, so it is ready to use as soon as you connect your client.

**What units of speed are provided?**
The tools provide speed in both kilometers per hour (km/h) and miles per hour (mph).

**Can I calculate speed using minutes and seconds?**
Yes, you can use `calculate_speed_from_time_units` to provide a duration in hours, minutes, and seconds.

**How do I compare two different cycling speeds?**
You can use the `get_speed_comparison` tool to see the ratio and difference between two speeds in km/h.