# Calendarific MCP for AI Agents AI Agent Connect > Calendarific lets you pull global holiday data for 230+ countries directly into your AI agent. You can check public, religious, and local holidays by country, region, or type. It's built for anyone who needs to plan across borders without digging through multiple websites. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_l1UKd1aDzxlrDprsCz8S1H4eO9YTZT5Fr3lY2TJK/ai-agent-connect - **Tags:** public-holidays, global-data, regional-data, scheduling, date-time, api-integration ## Description This Calendarific MCP lets you pull global holiday data directly into your AI agent to manage international schedules and travel plans. Instead of constantly checking different government websites or manual calendars, you can just ask your agent for the specific dates of public, religious, or local holidays across 230+ countries. It handles the heavy lifting of regional variations, so you don't have to worry about a holiday in one state being different from another. You'll find it's a lot easier to coordinate team availability or logistics when you have a reliable source for global dates. Vinkius makes it simple to connect this data to your existing workflow, giving you a single point of truth for international dates. Whether you're building a travel itinerary or just trying to figure out if a specific office is closed, this tool puts that information right in your chat interface. ## Tools ### get_account_info Check if your connection to the service is active. This ensures your API key is working correctly. ### list_holidays_by_location Find holidays for a specific state or region within a country. This is useful for identifying local variations. ### list_holidays_by_type Filter holidays by categories like national or religious. This helps you narrow down the specific types of dates you need. ### list_holidays Get all holidays for a specific country and year. This provides a complete overview of the yearly calendar. ### list_supported_languages See which languages the data is available in. Use this to check for specific regional language support. ### list_supported_countries Get a full list of all countries and their ISO codes. Use this to see which nations are covered. ## Prompt Examples **Prompt:** ``` List all public holidays in Brazil for 2024. ``` **Response:** ``` I've pulled the 2024 holiday list for Brazil. Notable dates include: * **Carnaval** (Feb 12-13) * **Tiradentes** (Apr 21) Would you like the full list of all dates? ``` **Prompt:** ``` Are there any holidays in New York (US-NY) on December 25th? ``` **Response:** ``` Yes, December 25th is **Christmas Day** in New York. It is recognized as both a federal and state holiday in the US. ``` **Prompt:** ``` Show me the religious holidays in Italy for 2024. ``` **Response:** ``` Here are the religious holidays for Italy in 2024: * **Epiphany** (Jan 6) * **Easter Monday** (Apr 1) * **All Saints' Day** (Nov 1) Would you like more details on any of these? ``` ## Capabilities ### List holidays by country Get a full list of public and religious dates for any specific nation. ### Filter by region See holidays for specific states or provinces to account for local variations. ### Filter by holiday type Separate national, religious, and local observances into distinct lists. ### Browse supported countries Access a directory of over 230 countries and their ISO codes. ### Get holiday metadata Retrieve detailed descriptions and specific observance regions for each date. ### Verify account status Check the status of your integration to ensure everything is working. ## Use Cases ### Planning a team offsite in Brazil A user asks for public holidays in Brazil for 2024 to avoid booking travel during Carnival or other major closures. ### Managing a global dev team A project manager checks if the Tokyo office is closed for a local holiday before assigning a sprint deadline. ### Building a travel app A developer asks the agent for a list of all countries to populate a dropdown menu in their new application. ### Organizing a religious event A user filters for religious holidays in Italy to ensure an event doesn't conflict with local observances. ## Benefits - Stop manual searching. Use list_holidays to get dates for any country instantly without opening new tabs. - Handle regional nuances. Use list_holidays_by_location to see state-specific dates that often get missed. - Organize by category. Use list_holidays_by_type to separate religious and national days for cleaner planning. - Faster logistics. Get metadata and descriptions for better planning of shipping and travel routes. - Global coverage. Access data for over 230 countries in one place for consistent international oversight. ## How It Works The bottom line is you get instant access to global holiday data without leaving your chat window. 1. Subscribe to the Calendarific MCP on Vinkius. 2. Enter your Calendarific API Key in the configuration. 3. Ask your AI client for holidays in any country or region. ## Frequently Asked Questions **Can I use Calendarific MCP to find holidays in my specific state?** Yes, you can get holidays for specific states or regions to make sure you aren't missing local variations. **Does the Calendarific MCP cover all countries?** It provides holiday data for over 230 countries, including both public and religious dates. **Can I filter holidays by type?** Yes, you can ask for specific types like national holidays or religious observances to keep your results relevant. **How does Calendarific MCP help with international project management?** It lets you quickly check if international offices are closed, so you don't schedule meetings on local holidays. **Can I get descriptions for the holidays?** Yes, the Connector provides metadata including descriptions and the specific regions where the holidays are observed. **Is the data from Calendarific MCP updated for the current year?** Yes, you can query holidays for specific years to ensure your planning is accurate for the current or upcoming calendar. **How do I list all the holidays for a specific country in 2024?** Simply ask the agent to `list_holidays` and provide the Country code (e.g., 'US' or 'BR') and the year '2024'. It will retrieve the full list from Calendarific. **Can I filter holidays by type, like only religious holidays?** Yes! Use the `list_holidays_by_type` tool and provide the country, year, and type (e.g., 'religious'). Your agent will return only the matching observances. **How do I see which countries are supported by Calendarific?** Use the `list_supported_countries` tool. It will retrieve the complete directory of over 230 countries currently available in the Calendarific API.