# Time Duration Adder AI Agent Connect

> Time Duration Adder MCP gives your AI client the ability to perform high-precision temporal arithmetic. It handles the messy parts of calendar math, like leap years and varying month lengths, so your agent can accurately project future dates, calculate past timestamps, or measure the exact duration between two points in time.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_plK86nBBJ8R1YLwTu44wl8rwufzKTGFwpD63FEoC/ai-agent-connect
- **Tags:** time, date, timestamp, calendar, arithmetic

## Description

Calculating dates is surprisingly difficult for most AI models. They often stumble on leap years, the different number of days in each month, or how time rolls over at midnight. This MCP fixes that by providing a set of specialized tools for temporal math. You can use it to project deadlines, calculate elapsed time, or verify that a timestamp is formatted correctly. Instead of guessing, your agent uses these tools to get exact answers. It works by applying specific durations to existing timestamps, ensuring that every calculation respects the actual calendar. Whether you need to find out what date falls three months from now or how many hours have passed since a specific event, this MCP provides the mathematical backbone to make it happen reliably.

## Tools

### add_duration
This tool calculates a new timestamp by adding a specific amount of time to a starting date.

### get_time_difference
This tool measures the exact amount of time that has passed between two specific timestamps.

### subtract_duration
This tool finds a past timestamp by removing a set duration from a starting date.

### validate_timestamp
This tool checks if a string follows a valid and recognizable date or time format.

## Prompt Examples

**Prompt:** 
```
What is the date 3 months and 5 days after 2023-01-15T10:00:00Z?
```

**Response:** 
```
2023-04-20T10:00:00Z
```

**Prompt:** 
```
How much time is between 2024-01-01T00:00:00Z and 2024-02-01T12:30:00Z?
```

**Response:** 
```
1 month, 0 days, 12 hours, 30 minutes, 0 seconds
```

**Prompt:** 
```
Subtract 2 years from 2025-05-20T08:00:00Z.
```

**Response:** 
```
2023-05-20T08:00:00Z
```

## Capabilities

### Temporal Arithmetic
Your agent adds or subtracts years, months, days, hours, minutes, and seconds from any timestamp.

### Calendar Awareness
The MCP automatically accounts for leap years and the specific number of days in each month.

### Interval Measurement
It calculates the exact duration between two different points in time.

### Format Validation
The agent can check if a date string is valid before attempting to use it in a calculation.

## Use Cases

### Deadline Projection
An agent calculates exactly when a project will be due based on a start date and a set number of working days.

### Historical Auditing
Your agent determines the exact time elapsed between two log entries to track system uptime.

### Subscription Management
Calculate the exact expiration date for a user after adding a specific number of months to their sign-up date.

### Data Cleaning
Use the validation tool to filter out malformed date strings from a messy dataset.

## Benefits

- Eliminates errors caused by leap years and varying month lengths.
- Provides exact time differences instead of approximations.
- Ensures date strings are valid before processing.
- Handles complex date rollovers automatically.

## How It Works

Connecting this MCP to your client gives your agent immediate access to precise time math tools.

1. Connect your MCP-compatible client to Vinkius.
2. The agent identifies the available time tools.
3. You provide a natural language request involving dates or durations.
4. The agent calls the appropriate tool to perform the math.
5. The tool returns a precise, formatted timestamp or duration.

## Frequently Asked Questions

**Does this MCP handle leap years?**
Yes. The math logic automatically accounts for leap years and the specific number of days in every month.

**What time units can I add or subtract?**
You can use years, months, days, hours, minutes, and seconds.

**How do I use this with Claude or Cursor?**
You connect to the Vinkius catalog once, and the tools become available to your AI client immediately.

**Can it check if a date is valid?**
Yes, the validate_timestamp tool checks if a string is a recognizable and valid date/time format.

**Can I find the difference between two dates?**
Yes, the get_time_difference tool measures the exact interval between two timestamps.

**How does the tool handle month rollovers?**
The tool automatically adjusts for month length. If you add one month to August 31st, it will return September 30th to ensure a valid date.

**Can I calculate the difference between two specific dates?**
Yes, you can use the `get_time_difference` tool to find the exact elapsed time in years, months, days, hours, minutes, and seconds.

**Does it support leap years?**
Yes, all calculations respect leap year rules, including February 29th.