Download PDFMarkdown Version
ClaudeChatGPTPerplexityGeminiMicrosoft CopilotRaycastMeta AIGrokZ.aiQwenKimi
DeepSeekMistralCursorVS CodeWindsurfJetBrainsClineLovableVercel AI SDKLangChain

Use Holiday API with your AI.

Connect your account once and let the AI you already use work with it, without building another integration. Manage global holidays. audit public and federal holidays via AI.

Included with plan

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

ChatGPTClaudeCursorPerplexityGeminiMicrosoft CopilotRaycastMeta AI

Complete set · 5 capabilities

The complete Holiday API capability set.

These are the exact actions your AI can choose when you ask it to work with Holiday API.

Capability set01 / 02

01-03

3 capabilities in this set.

Part of 5 available through Holiday API.

  1. 01

    Get holidays

    Get public holidays for a country and year

  2. 02

    Get next workday

    Get the date after a number of workdays from a start date

  3. 03

    Get workdays count

    Count the number of workdays between two dates

Capability set02 / 02

04-05

2 capabilities in this set.

Part of 5 available through Holiday API.

  1. 04

    List supported countries

    List all countries supported by Holiday API

  2. 05

    List supported languages

    List all languages supported by Holiday API

Observed, not estimated

851ms average. Fast in production.

Holiday API is checked daily against the live service.

Daily averagePeak 1100ms
Aug 23Today
Fastest day
708ms
Slowest day
1100ms
14-day trend
Improving-30%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 5 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of Holiday API, so you can see the experience inside your AI.

It does not authenticate your account with Holiday API. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

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"
    }
  }
}
  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Step-by-step instructions for each client are in the guide. How to connect

FAQ

Questions Holiday API owners ask.

  • 01

    How do I find my Holiday API Key?

    Log in to your Holiday API dashboard, and you will find your API Key on the main page. Copy and paste it below.

  • 02

    Does the agent support historical years?

    Yes. Holiday API provides historical data. Depending on your plan, you can query holidays for past years to audit previous events.

  • 03

    Can the agent calculate the number of workdays?

    Yes. The get_workdays_count capability allows your agent to calculate the exact number of non-holiday business days between two dates for any country.

Explore

More in Productivity

Suggestions