# Calendar & Holiday Engine AI Agent Connect

> Calculate exact dates for global holidays across Gregorian, Islamic, Hebrew, Chinese, and Hindu calendars.

## Overview
- **Category:** utilities
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_QjSKggQJHu9raCtEmHkfqTFaoKRductNOiRw2Gvz/ai-agent-connect
- **Tags:** holidays, calendars, temporal, global, precision

## Description

This MCP server provides high-precision temporal calculations for global holidays. It bridges AI agents to multiple calendrical systems, including Gregorian, Islamic (Hijri), Hebrew (Lunisolar), Chinese (Lunisolar), and Hindu calendars. Use `get_holidays_by_year` to retrieve a full list of dates for any year between 1583 and 9999, or `get_holiday_details` to find specific metadata for a single event. The engine also supports `check_holiday_proximity` to determine the temporal distance to upcoming or past holidays relative to a specific date.

## Tools

### check_holiday_proximity
Answers how many days remain until the next upcoming holiday or how many days have passed since the last one

### get_holiday_details
Provide the exact name of the holiday.

Provides deep metadata for a specific holiday occurring in a specific year

### get_holidays_by_year
You can optionally provide a country code to filter for public holidays.

Returns a complete list of all holidays for a specific year across all supported calendar systems and countries

## Prompt Examples

**Prompt:** 
```
What holidays are there in 2025 in the USA?
```

**Response:** 
```
In 2025, the USA has holidays such as New Year's Day on January 1st, Martin Luther King Jr. Day on January 20th, and Memorial Day on May 26th.
```

**Prompt:** 
```
How many days until Christmas 2024?
```

**Response:** 
```
Christmas is on December 25th, 2024.
```

**Prompt:** 
```
When is Eid al-Fitr in 2025?
```

**Response:** 
```
Eid al-Fitr in 2025 is expected to fall around March 30th.
```

## Frequently Asked Questions

**What is the supported year range?**
The engine supports any year from 1583 to 9999.

**Can I check if a holiday is a public holiday?**
Yes, by providing a valid ISO 3166-1 alpha-2 country code, the tools will indicate if the holiday is officially recognized in that territory.

**Which calendar systems are supported?**
The engine supports Gregorian, Christian-Movable, Hijri, Hebrew, Chinese, Hindu, and Secular calendar systems.