# Calendarific MCP for AI Agents MCP

> Calendarific gives your AI agent access to worldwide holiday intelligence. It instantly retrieves public, bank, and religious holidays for over 200 countries, allowing you to plan international logistics, coordinate global meeting schedules, or audit regional availability with a simple conversation.

## Overview
- **Category:** lifestyle
- **Price:** Free
- **Tags:** holidays, calendar, global-data, public-holidays, scheduling

## Description

Scheduling across borders is a nightmare if you don't know the local rules. This MCP gives your agent instant access to deep global calendar data. You can ask for all public and bank holidays in any country—like knowing exactly when India observes Diwali, or which dates count as federal holidays in Canada. Your agent handles the complexity of cross-border scheduling by pulling holiday lists for specific countries and years, filtering results down to a single month, or just listing every supported nation's ISO code. You don't need to consult dozens of local government websites; you just talk to your AI client. Connecting this capability through Vinkius means your agent can act as a dedicated global calendar coordinator right where you work.

## Tools

### get_holidays
Gets a detailed list of public and bank holidays for a specific country and year.

### list_supported_countries
Lists all countries and regions the calendar can track, including their ISO codes.

## Prompt Examples

**Prompt:** 
```
What are the public and religious holidays in Brazil for 2025?
```

**Response:** 
```
**🇧🇷 Brazil Holidays: 2025**

Here's a summary of major recognized days:

*   **Jan 1:** New Year's Day (Public)
*   **Apr 21:** Earth Day (National)
*   **May 1:** Workers' Day (Public)
*   **Sep 7:** Independence Day (Public)

Need to check for specific dates or a different year?
```

**Prompt:** 
```
List all countries you can track and their codes.
```

**Response:** 
```
We support over 200 regions! Here are some examples, including the ISO code:

| Country | Code |
| :--- | :--- |
| Canada | CA |
| Australia | AU |
| Germany | DE |
| Japan | JP |

I can give you the list for any specific region you're working with.
```

**Prompt:** 
```
Are there any bank holidays in the UK during May 2024?
```

**Response:** 
```
**🇬🇧 UK Holidays: May 2024**

I found two notable holidays for that month:

*   🗓️ **May 6th:** Early May Bank Holiday (Bank)
*   🗓️ **May 27th:** Spring Bank Holiday (Bank)

You can schedule around these dates, or I can check other months too.
```

## Capabilities

### Identify global working days by country and year
Your agent fetches all public and bank holidays for any given country within a specified year.

### List supported countries and their codes
It provides a list of every nation and region the calendar can track, along with their specific ISO codes.

## Use Cases

### Scheduling a virtual team meeting across Asia and Europe
A PM needs to find three non-holiday dates for a global kickoff call. They ask the agent, specifying the countries (e.g., Japan, France) and the year. The agent runs `get_holidays` for both locations and suggests only times when both teams are actually working.

### Launching an e-commerce campaign in a new market
An e-commerce manager wants to time a sale around a major local festival. They use the agent to query holidays for that country, identifying a key religious holiday date and adjusting the marketing calendar accordingly.

### Planning an international sales trip
A travel planner needs to ensure their client doesn't travel during a national bank holiday. They prompt the agent with the destination and dates, which uses `get_holidays` to immediately flag any local closures.

### Building a universal data governance system
An operations team needs a list of all possible regions for a new product. They use the agent's ability to call `list_supported_countries`, gathering every required ISO code into a single dataset.

## Benefits

- Avoid scheduling conflicts: Use the `get_holidays` function to confirm that a meeting date isn't also a local bank holiday in another country.
- Improve global planning accuracy: With access to over 200 countries, you can confidently plan campaigns or launches knowing the exact regional availability.
- Save research time: Instead of checking multiple government websites, simply ask your agent to list all supported nations using `list_supported_countries` and get the ISO codes instantly.
- Support diverse regions: The MCP handles religious holidays as well as national ones, giving you deep cultural intelligence for market entry strategies.
- Automate scheduling audits: You can ask the agent to compare holiday calendars between two different countries to flag potential overlaps or gaps.

## How It Works

The bottom line is that your agent talks to the global calendar data and gives you clear, actionable dates back.

1. Subscribe to this MCP on Vinkius.
2. Enter your Calendarific API key into your client's settings.
3. Ask your AI agent a natural language question, such as 'What are the bank holidays in Australia for 2025?'

## Frequently Asked Questions

**How does the Calendarific MCP help me plan an international project timeline?**
The calendar helps you coordinate across borders by flagging local holidays. You simply ask it to get the holidays for all involved countries and years, so your agent only suggests dates when everyone is actually working.

**Can I use Calendarific MCP to check bank holidays in different states?**
Yes, you can query specific country calendars. It provides details on public and bank holidays across many nations, letting you account for regional variations when scheduling meetings or events.

**What kinds of countries does the Calendarific MCP support?**
It supports a massive list of over 200 global regions. You can ask it to list all supported nations and receive their official ISO codes instantly for your records.

**Is Calendarific MCP better than just using Google Calendar for multiple countries?**
Yes, because this tool is designed for AI agents. Instead of manually adding data or cross-referencing multiple calendars, you ask the agent a single question and get accurate, structured holiday data back from hundreds of sources.

**How do I use Calendarific MCP to plan marketing campaigns?**
You tell the agent which country and date range you're targeting. It checks for any major religious or national holidays within that window, allowing you to shift your campaign launch dates to maximize visibility.