Supercharge your AI with Calendarific. Manage Global Dates, No Matter the Time Zone.
Works with every AI agent you already use
…and any MCP-compatible client
Connect to your AI in seconds.
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.
What your AI can do
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.
Verify the integration is working correctly by fetching basic account information.
Retrieve a full list of observed public, religious, and local holidays for any specific country within a given year.
Get holiday data scoped to a particular state or regional area, accounting for local rules.
List holidays based on their type, such as National Observances or Religious dates.
View a directory of all 230+ countries and the ISO codes needed for planning.
Quickly check if an exact month or day falls on a holiday to confirm work status.
Ask an AI about this
Compatible AI Apps
OAuth 2.0 CompatibleWaiting for input…
Calendarific: 6 Tools
These tools let you check account status, list country-wide or location-specific holidays, filter by type, and get supported country/language lists.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using Calendarific on VinkiusGet 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...
List Holidays By Location
Lists observed holidays, limiting the results to a specific state or region within a...
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.
Connect to your AI in seconds. Security and governance baked right in.
Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Calendarific, then connect any of our 5,000+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,000+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Calendarific. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This connection provides 6 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.
Manually tracking international holidays is a massive headache.
Right now, planning anything that crosses borders means jumping between dozens of national government websites. You open one tab for Brazil's observances, another for Japan’s national days, and then you have to check if your specific office location in São Paulo has local variations. It's copy-pasting dates, comparing calendars, and constantly double-checking the source.
With this MCP, you just ask your agent: 'What are the working days in Rio de Janeiro for Q3?' The system handles the cross-referencing—it knows to check not only Brazil’s main holiday list but also any local exceptions specific to that region. You get a clean, consolidated answer instantly.
The `list_holidays` tool gives you complete control over date discovery.
Instead of just getting a raw list, the MCP lets you narrow down your search. You can ask for holidays only by type (like National), or limit it to specific regions using `list_holidays_by_location`. This eliminates wasted data and focuses on exactly what matters.
You stop manually filtering massive datasets in Excel. The answer is precise, structured, and ready for your next step, whether that’s updating a database entry or confirming a presentation date.
What your AI can actually do with this
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.
019d7567-8bdf-725e-a2b0-85320da2405d Here's how it actually works
The bottom line is you get accurate, localized global holiday schedules without having to manually query multiple national calendars.
First, connect your Calendarific API key to the MCP via Vinkius and verify account credentials using get_account_info.
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).
The MCP returns structured data detailing all observed holidays for that area and time frame, allowing you to confirm work availability.
Who is this actually for?
Operations managers who spend hours cross-referencing international office calendars. Travel planners who need guaranteed availability for client trips. Developers building multi-region SaaS platforms that depend on accurate date logic.
Needs to confirm if a key international site is observing a holiday before scheduling a kickoff meeting or sending a project deadline.
Must check the regional holiday calendar for multiple destinations to ensure travel dates avoid public closures and optimize resource allocation.
Requires a reliable way to validate date inputs in code, ensuring logic never calculates a working day on an official holiday.
What Changes When You Connect
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.
See it in action
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.
The honest tradeoffs
Only checking country names
Asking 'What are the holidays in Mexico?' might give a general list that includes dates specific only to Oaxaca, but your team is based in Guadalajara.
Always use list_holidays_by_location and specify the state or region. This provides granular detail so you don't accidentally schedule work during a local closure.
Relying on calendar screenshots
Manually cross-referencing yearly calendar images is slow, prone to human error, and requires multiple browser tabs open.
Use the MCP to retrieve all required data programmatically. Start with list_supported_countries to confirm your region's code, then call list_holidays for the full year.
Assuming language support is enough
Just knowing a country supports Spanish doesn't mean the holiday data you receive will be relevant or correctly formatted for your system’s needs.
Use list_supported_languages first. This confirms not only that the locale is supported but also helps guide your agent to interpret the retrieved metadata accurately.
When It Fits, When It Doesn't
You should use this MCP if accuracy and regional specificity are non-negotiable parts of your workflow—think payroll, global logistics, or complex scheduling. Use it when you need to know why a date is unavailable (is it national? religious? local?). Don't use it if you only need a rough estimate or if you already have reliable data piped from a single source; in those cases, manual review or simpler spreadsheet tools are fine. However, if your system handles operations across multiple time zones and countries, this MCP is essential for guaranteeing data integrity against the known global calendar.
Questions you might have
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.
We've already built the connector for Calendarific. Just plug in your AI agents and start using Vinkius.
No hosting. No infrastructure. No complex setup.
All 6 tools are live and waiting.
You're up and running in seconds.
Vinkius gives your AI agents access to the full catalog of app connectors, all fully managed, secure, and enterprise-ready. One subscription, every tool you need.
Built, hosted, and secured by Vinkius. You just connect and go.