# Timezone Offset Difference AI Agent Connect

> Timezone Offset Difference MCP handles the math behind UTC offsets. It lets your AI client calculate signed hour differences, find the absolute gap between time zones, and convert minute counts into standard offset strings. It also validates that your offset strings follow the required format.

## Overview
- **Category:** utilities
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_K3wekC6XZeHZEYLlBspYlGs6Q42kBakK7cmCjbbI/ai-agent-connect
- **Tags:** timezone, utc, offset, time-calculation, temporal

## Description

Calculating the exact difference between time zones is a common headache when building scheduling logic or managing global data. This MCP gives your AI client the specific tools needed to handle UTC offset math without guesswork. You can find the signed hour difference between two specific offsets or determine the total magnitude of time separating them. If you have a raw number of minutes from UTC, the MCP converts that into a standard offset string. It also acts as a validator to ensure any offset strings you work with follow the strict ±HH:mm pattern. Instead of your agent trying to do mental math on time zones, it uses these tools to get exact, formatted results every time.

## Tools

### get_relative_offset_shift
This tool calculates the signed hour difference between two specific UTC offsets.

### validate_offset_format
Use this to check if a string follows the required ±HH:mm UTC offset format.

### get_absolute_hour_gap
This tool finds the total magnitude of hours that separate two UTC offsets.

### get_offset_from_total_minutes
This tool converts a total count of minutes from UTC into a standard ±HH:mm string.

## Prompt Examples

**Prompt:** 
```
What is the hour difference between +02:00 and -05:00?
```

**Response:** 
```
-7
```

**Prompt:** 
```
How many hours separate UTC+00:00 and UTC+09:00?
```

**Response:** 
```
9
```

**Prompt:** 
```
Convert 150 minutes into a UTC offset string.
```

**Response:** 
```
+02:30
```

## Capabilities

### Signed Offset Math
Your agent calculates the direction and magnitude of time shifts between zones.

### Absolute Gap Calculation
The AI finds the total number of hours separating two different offsets.

### Minute to String Conversion
Your client turns raw minute counts into properly formatted UTC strings.

### Format Validation
The MCP checks that offset strings match the ±HH:mm standard.

## Use Cases

### Global Scheduling
The agent calculates the exact hour difference between two users in different parts of the world.

### Data Normalization
Convert raw minute offsets from a database into readable UTC strings.

### Input Validation
Ensure that user-provided time zone strings meet the required technical format.

### Time Gap Analysis
Determine the total magnitude of time between two specific geographic regions.

## Benefits

- Eliminates manual math errors in time zone calculations.
- Standardizes offset strings into the ±HH:mm format.
- Provides a way to validate temporal data formats instantly.

## How It Works

Connecting this MCP to your AI client gives it immediate access to temporal math tools.

1. Connect your MCP-compatible client to Vinkius.
2. The tools become available to your agent automatically.
3. Ask your agent to perform a specific time zone calculation.
4. The agent invokes the necessary tool to get the exact result.

## Frequently Asked Questions

**What format does this MCP use for offsets?**
The MCP uses and validates the strict ±HH:mm UTC offset format.

**Can I use this with Claude or Cursor?**
Yes, this MCP works with any MCP-compatible client including Claude, Cursor, and Windsurf.

**Does it handle signed differences?**
Yes, the get_relative_offset_shift tool specifically calculates the signed hour difference.

**How do I convert minutes to an offset?**
You can use the get_offset_from_total_minutes tool to turn minutes into a standard string.

**Is there a way to check if an offset string is valid?**
Yes, the validate_offset_format tool checks if a string follows the required pattern.

**How do I calculate the shift between two time zones?**
You can use the `get_relative_offset_shift` tool by providing the source and target offsets in the ±HH:mm format.

**What format should the UTC offset be in?**
Offsets must follow the strict ±HH:mm format, such as '+05:30' or '-08:00'. You can use `validate_offset_format` to check your strings.

**Can I find the absolute distance between two offsets?**
Yes, use the `get_absolute_hour_gap` tool to get the non-negative number of hours separating two time zones.