# Calendarific MCP for AI Agents AI Agent Connect > Calendarific MCP gives your AI agent access to public, bank, and religious holidays in over 200 countries. Use it to check regional availability, plan international travel, or schedule global meetings without manual research. It handles the heavy lifting of finding local dates so you don't have to. ## Overview - **Category:** lifestyle - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_R4cMekmSDiSSDuWvKyGG20vgUjQK3k5YIM5N6BZg/ai-agent-connect - **Tags:** holidays, calendar, global-data, public-holidays, scheduling ## Description The Calendarific MCP gives your AI agent access to public, bank, and religious holidays in over 200 countries. This integration changes how you handle international logistics by removing the need to jump between different websites to check regional dates. Instead of manually searching for 'holidays in Japan' and copying them into a spreadsheet, you just ask your agent to do it. You can pull holiday lists for specific years, filter them by month, or see which countries are supported. It even provides details on whether a day is a national, religious, or bank holiday. When you use this through the Vinkius catalog, your agent becomes a reliable coordinator for global timelines. It ensures your project plans account for local realities, helping you avoid the headache of missing a regional shutdown or a major festival. This means your team stays on track regardless of where they are based, and your clients get accurate information on availability. You stop worrying about hidden dates and start focusing on the actual work. It turns a tedious research task into a simple conversation that keeps your operations moving forward without the friction of manual data entry. ## Tools ### get_holidays Fetch all public and bank holidays for a specific country and year to check regional availability. Use this to see full yearly calendars for any nation. ### list_supported_countries Get a full list of supported countries and their ISO codes for global operations. This ensures you have the correct codes for every region. ## Prompt Examples **Prompt:** ``` What are the bank holidays in the UK for May 2024? ``` **Response:** ``` I found two bank holidays for the UK in May 2024: * **Early May Bank Holiday**: May 6 * **Spring Bank Holiday**: May 27 Would you like to know about any other months? ``` **Prompt:** ``` Check if there are any holidays in Japan on November 3rd. ``` **Response:** ``` Yes, November 3rd is **Culture Day (Bunka no Hi)** in Japan. It's a national holiday dedicated to promoting culture and the arts. I can check other dates for you if needed. ``` **Prompt:** ``` List all countries supported by Calendarific. ``` **Response:** ``` The system supports over 200 countries and regions. Here are a few examples with their ISO codes: * Afghanistan (AF) * Brazil (BR) * Canada (CA) * France (FR) * Zimbabwe (ZW) I can give you the code for any specific country you need. ``` ## Capabilities ### Fetch country holiday lists Pull all public and bank holidays for any country and year in one go. ### Filter dates by month Narrow down holiday results to specific months or days for tighter scheduling. ### Get supported country codes Retrieve a full list of supported countries and their ISO codes for data mapping. ### Identify holiday types See whether a specific date is a national, religious, or bank holiday. ### Compare regional calendars Look at holiday dates across multiple countries to find the best overlap for meetings. ## Use Cases ### Scheduling a global sprint A project manager asks the agent to find all bank holidays in the UK and France for 2025 to set a team deadline. ### Planning a multi-country tour A travel agent asks for a list of all public holidays in Italy to ensure a tour doesn't hit a major shutdown. ### Regional marketing An e-commerce lead asks for religious holidays in India to avoid running a sale on an observant day. ### Logistics auditing An operations lead asks the agent to compare holidays in Brazil and Mexico to align shipping dates. ## Benefits - Stop manually searching for holidays. Use `get_holidays` to pull entire yearly calendars for any country in seconds. - Avoid scheduling conflicts. Your agent can check specific dates to ensure you aren't booking a meeting on a national holiday. - Simplify international logistics. Get all supported countries and ISO codes with `list_supported_countries` for easy data mapping. - Plan better marketing. Identify religious and national holidays to time your regional campaigns more effectively. - Improve team coordination. Compare calendars between different countries to see where your team's working hours will overlap. ## How It Works The bottom line is your agent handles the global calendar research so you can focus on actual planning. 1. Subscribe to the Connector on Vinkius and grab your API key from the Calendarific website. 2. Add your API key to your AI client configuration. 3. Ask your agent to find holidays for specific countries or dates. ## Frequently Asked Questions **Can Calendarific MCP find holidays for my specific country?** Yes, it supports over 200 countries including major regions across every continent. Your agent can pull the full list of public and bank holidays for any of those locations. **Does it include religious holidays?** Yes, the data includes religious observances alongside national and bank holidays. This helps you avoid scheduling conflicts during important cultural events. **Can I check holidays for a specific year?** You can ask your agent to pull holidays for any specific year. This is great for long-term project planning or multi-year travel itineraries. **How do I get the API key for this Connector?** You can get your free API key directly from the Calendarific website. Once you have it, just add it to your AI client to start querying. **Can I use this for international business travel?** That is a primary use case. Your agent can identify bank holidays in your destination to ensure you aren't planning travel during a national shutdown. **Is this for my personal calendar?** No, this Connector is for retrieving public holiday data. It won't sync your personal appointments or private events. **Can it tell me the type of holiday?** Yes, it provides details on whether a day is a national, religious, or bank holiday. This helps you understand the context of a regional closure. **Can I see all holidays in Brazil for 2024?** Yes! Use the `get_holidays` tool with the country 'BR' and the year 2024. It will return a full list of public and bank holidays. **How do I find the ISO code for a country?** Use the `get_countries` tool. It returns a comprehensive list of all supported countries along with their 2-letter ISO codes (e.g., 'US', 'FR', 'JP'). **Does this include religious holidays like Easter?** Yes. Calendarific tracks national, bank, and religious holidays. You can identify the type of holiday in the metadata returned by the tools.