• VALIDATION
  • CONFLICTS
  • SUPPORT
  • HUMAN

How to audit global holiday schedules with your AI

Connect the Holiday API once. After that, your agent handles the heavy lifting of looking up dates and regional closures across the globe.

Ask AI about this page

Short answer

How can I check holiday dates for different countries using AI?

Your agent pulls specific public and federal holiday lists for any supported country to check dates and regional closures. You get a clear view of when offices or markets will be closed.

The outcomes.

Where the data lands.

The AI processes the holiday data and organizes it into these specific results.

VALIDATION

Verified date lists

The AI pulls specific holiday dates for a country. You get a clean list of when things are closed.

CONFLICTS

Identified scheduling gaps

The agent compares your dates against regional holidays. It flags where a holiday hits a planned workday.

SUPPORT

Country availability check

The AI checks which nations are supported. It tells you if the data you need is available.

HUMAN

Manual review required

The AI provides the raw holiday data. You decide how to adjust your specific business calendar.

The workflow

What your AI does when the request arrives.

The agent follows a logical path to find and confirm the dates you need.

  1. Check availability

    The agent first confirms which countries have holiday data available in the system.

    list_supported_countries

  2. Fetch holiday data

    Once the country is confirmed, the agent pulls the specific public and federal holiday lists.

    get_holidays

  3. Compare dates

    The agent looks at the retrieved dates to find specific closures or upcoming holidays.

    get_holidays

  4. Report findings

    The agent presents the final list of dates and closures for your review.

    get_holidays

Try it

Copy these to start.

Use these prompts to kick off the task with your agent.

Starting points

Swap out the country names and specific dates to match your needs.

Holiday API Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_SMxFPybnCSX99kH0d7ecnowVLqRi196StERNKHpz/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Holiday API capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "holiday-api-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_SMxFPybnCSX99kH0d7ecnowVLqRi196StERNKHpz/mcp"
    }
  }
}
Copy into chat04

  • Which countries can you pull holiday data for?

  • Get the federal holiday list for Japan for 2025.

  • Check if there are any public holidays in Brazil next month.

  • List all holidays in Germany to help me audit my project timeline.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Holiday API once, then ask.

Just follow the link to connect. Your credentials stay encrypted and private. You can find the full technical details on the Connector page.

Connect Holiday API to your AI

FAQ

Common questions

  • 01

    Can the AI change my Google Calendar?

    No. The AI only reads holiday data from the API. You must manually update your own calendars.

  • 02

    Does it support every country in the world?

    No. The AI can only pull data for countries included in the supported list.

  • 03

    Can the AI predict future holidays?

    Yes, as long as the API has the data for those future dates.

  • 04

    Can the AI delete holiday entries?

    No. The AI is a read-only connection to the holiday data.

  • 05

    Can I ask for specific regional holidays?

    Yes, the agent can pull the specific lists provided by the API for a given country.

  • More questions about Holiday API? The Connector page answers them. See everything the Holiday API Connector can do

Connect Holiday API to Claude, Cursor, ChatGPT & more