# Calendarific MCP MCP > Calendarific lets you pull global holiday data directly into your workflow. It tracks public holidays, religious observances, and local dates across over 230 countries. You can check specific regions, filter by type like National or Religious, and find details for any given day to plan scheduling anywhere. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** public-holidays, global-data, regional-data, scheduling, date-time, api-integration ## Description Use this MCP to orchestrate global planning without manual lookups. Need to know if a client's office in Thailand is closed next month? Or maybe you need the national holiday list for Brazil for 2025? This connector pulls accurate public, religious, and local holiday data from around the world right into your conversation with your AI client. Instead of opening dozens of country websites, you just ask. You can pinpoint holidays by state or region, narrow results down by type, or even check availability for a single day. When you connect this to Vinkius, it makes global scheduling and resource planning happen through natural language prompts. It’s simple: tell your agent where you need dates, and it handles the complexity of international observance. ## Tools ### get_account_info Checks the current status and authentication details of your integration connection. ### list_supported_countries Provides a complete list of all supported countries and their corresponding ISO codes for use in queries. ### list_holidays_by_location Lists observed holidays, limiting the results to a specific state or region within a country. ### list_holidays_by_type Filters holiday data by category, such as national observances or religious dates. ### list_holidays Retrieves a list of holidays for an entire country over a specified year. ### list_supported_languages Lists all languages that the system can process when interpreting holiday data. ## Prompt Examples **Prompt:** ``` List all public holidays in Brazil for 2024. ``` **Response:** ``` I've retrieved the holidays for Brazil. There are several upcoming observances, including 'Carnaval' (Feb 12-13) and 'Tiradentes' (Apr 21). Would you like the full list? ``` **Prompt:** ``` Are there any holidays in New York (US-NY) on December 25th? ``` **Response:** ``` Yes, December 25th is 'Christmas Day' in New York, which is a federal and state holiday in the US. ``` **Prompt:** ``` Show me the religious holidays in Italy for 2024. ``` **Response:** ``` Retrieving religious holidays for Italy... Notable dates include 'Epiphany' (Jan 6), 'Easter Monday' (Apr 1), and 'All Saints' Day' (Nov 1). ``` ## Capabilities ### Check account status Verify the integration is working correctly by fetching basic account information. ### List country holidays Retrieve a full list of observed public, religious, and local holidays for any specific country within a given year. ### Filter by region Get holiday data scoped to a particular state or regional area, accounting for local rules. ### Discover holiday categories List holidays based on their type, such as National Observances or Religious dates. ### Check supported locations View a directory of all 230+ countries and the ISO codes needed for planning. ### Verify specific date availability Quickly check if an exact month or day falls on a holiday to confirm work status. ## Use Cases ### Scheduling an international team meeting A Project Manager needs to book a launch date that works for offices in both Germany and Australia. They ask their agent to check for holidays in both regions. The MCP uses `list_holidays_by_location` to return only the non-holiday dates, allowing them to select the optimal window. ### Planning a global sales campaign A Sales Director needs to know when their team's presence will be impacted by religious holidays across three different countries. They ask the agent to filter results using `list_holidays_by_type` (Religious), getting an immediate list they can share with logistics. ### Validating application dates A developer needs to ensure a user-submitted date for payment doesn't fall on a national holiday. They use the MCP to check the specific day, confirming work availability before allowing the transaction record to proceed. ## Benefits - Never miss a regional closure. By using `list_holidays_by_location`, you account for local variations that simple country-level checks ignore, keeping your planning accurate. - Streamline global scheduling by first checking `list_supported_countries`. This ensures the agent knows exactly which ISO codes to use, preventing ambiguous requests. - Verify dates instantly. Instead of reviewing a full year's list, you can ask for holidays on a specific month or day, confirming work status without extra steps. - Categorize your findings easily. Using `list_holidays_by_type` lets you separate national mandates from religious observances in one query. - Integrate scheduling logic into apps. Developers can use these tools to build date validation checks directly into their backend code, relying on the precision of the MCP. ## How It Works The bottom line is you get accurate, localized global holiday schedules without having to manually query multiple national calendars. 1. First, connect your Calendarific API key to the MCP via Vinkius and verify account credentials using `get_account_info`. 2. Next, prompt your agent with the scope you need: a country code, a specific region, or a desired holiday type. The agent then calls the relevant tool (e.g., filtering by location). 3. The MCP returns structured data detailing all observed holidays for that area and time frame, allowing you to confirm work availability. ## Frequently Asked Questions **How do I use the `list_holidays` tool with my agent?** You simply ask your agent to list holidays for a country and year. For example: 'List all public holidays in Canada for 2025.' The MCP handles the rest. **Can I check specific areas using `list_holidays_by_location`?** Yes, this is key. You can restrict holiday searches to a state or region within a country, which accounts for local rules that aren't visible at the national level. **What if I need to know what types of holidays exist? Use `list_holidays_by_type`.** The `list_holidays_by_type` tool lets you filter by category, such as distinguishing between a mandatory National day and a voluntary Religious observance. This keeps your planning clean. **How do I know what countries are supported? Check with `list_supported_countries`.** The agent can use the `list_supported_countries` tool to provide you with a master list of all 230+ available country codes and names. **How do I confirm that my API key is set up correctly? Run `get_account_info`.** This tool checks your connection status immediately. If you get a successful response, your integration works right out of the gate. It's the fastest way to verify credentials before running any complex searches. **If I only need holiday data for a specific day or month, should I use `list_holidays`?** Yes, you can refine your query using the date parameters within `list_holidays`. Instead of fetching an entire year's worth of data, this lets you pinpoint if a single date is a recognized holiday for that region. **What if I need to know which languages are supported? Check with `list_supported_languages`.** Running `list_supported_languages` returns the full list of language codes. This ensures your AI agent queries for holiday descriptions and metadata in the exact language you need. **What happens if I run `list_holidays` with an incorrect country code or year?** The system returns a clear error message detailing the invalid parameter. This instant feedback lets your agent correct the input right away, so you never waste time on bad data. **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.