Holiday API Connector for AI agents.
5 live capabilities
Plan international schedules and calculate global workdays with precision.
Waiting for input…
Why people use Holiday API
Holiday API for Automated Global Logistics Scheduling
With this Connector, your agent does the research for you. You can ask for a project timeline or a shipping window, and it pulls the data instantly. You get a finished schedule without the manual data entry.
What Vinkius changes
That you get instant, accurate holiday data for any country without ever opening a second tab.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Payroll Compliance Audit
An HR manager needs to know if a specific date in France is a public holiday for payroll.
- Real-world use case 02
International Shipping Windows
A logistics lead needs to know how many working days are between now and December 1st in Japan.
- Real-world use case 03
Group Travel Booking
A travel agent wants to know the next available workday for a group booking in Brazil.
Complete set · 5capabilities
The complete Holiday API capability set.
These are the exact actions your AI can choose when you ask it to work with Holiday API.
01—03
3 capabilities in this set.
Part of 5 available through Holiday API.
- 01 Capability
Get next workday
Tells you the date of the next business day starting from a specific point. This helps you set deadlines that automatically skip over weekends and public holidays.
- 02 Capability
Get workdays count
Gives you the total number of workdays between two dates. Use this to see how much actual time you have for a project in any country.
- 03 Capability
List supported countries
Shows every country currently supported by the API. This lets you know if the data you need is available before you start your search.
04—05
2 capabilities in this set.
Part of 5 available through Holiday API.
- 04 Capability
List supported languages
Lists the languages the API uses for holiday names. This helps you understand how the data will appear in your results.
- 05 Capability
Get holidays
Returns all public holidays for a specific country and year. This is your main capability for auditing any regional calendar instantly.
Set up in minutes
One URL. Then ask Holiday API to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Holiday API from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_SMxFPybnCSX99kH0d7ecnowVLqRi196StERNKHpz/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it Holiday API, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable Holiday API for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_SMxFPybnCSX99kH0d7ecnowVLqRi196StERNKHpz/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the Holiday API URL.
- Step 03
Save and start
Save the connection and enable Holiday API in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"holiday-api": {
"url": "https://edge.vinkius.com/vk_preview_SMxFPybnCSX99kH0d7ecnowVLqRi196StERNKHpz/mcp"
}
}
}- Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using Holiday API
Open Agent mode in chat and ask: "Using Holiday API, help me...". 5 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"holiday-api": {
"url": "https://edge.vinkius.com/vk_preview_SMxFPybnCSX99kH0d7ecnowVLqRi196StERNKHpz/mcp"
}
}
}- Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using Holiday API
Ask Copilot: "Using Holiday API, help me...". 5 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"holiday-api": {
"url": "https://edge.vinkius.com/vk_preview_SMxFPybnCSX99kH0d7ecnowVLqRi196StERNKHpz/mcp"
}
}
}- Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using Holiday API
Open Cascade and ask: "Using Holiday API, help me...". 5 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"holiday-api": {
"url": "https://edge.vinkius.com/vk_preview_SMxFPybnCSX99kH0d7ecnowVLqRi196StERNKHpz/mcp"
}
}
}- Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using Holiday API
Ask Cline: "Using Holiday API, help me...". 5 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add holiday-api --transport http "https://edge.vinkius.com/vk_preview_SMxFPybnCSX99kH0d7ecnowVLqRi196StERNKHpz/mcp"- Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using Holiday API
Ask Claude: "Using Holiday API, show me...". 5 tools are ready
Where the request belongs
Work Holiday API can move forward.
This is for the logistics manager, HR head, or travel planner who handles international schedules and needs to know exactly when people are working without manual research.
Logistics Manager
Mapping out shipping routes and delivery windows that need to avoid regional holidays across different continents.
HR Specialist
Verifying global public holidays to ensure payroll cycles and employee time off are compliant with local laws.
Travel Planner
Identifying peak holiday periods and local events to help coordinate large group bookings and itineraries.
Operations Lead
Coordinating cross-functional teams by identifying operational windows and avoiding holiday-related downtime.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsNager.Date
Manage public holidays worldwide. audit global events and calendars via AI.
Calendarific
Access global holiday data via Calendarific. track public, religious, and local holidays across 230+ countries directly from any AI agent.
Business Day Calculator
Calculate workdays, holidays, and business day ranges across 50+ countries.
Business Timezone & Holiday Scheduler
Eradicate LLM scheduling errors. Calculate exact business days skipping global public holidays and convert precise timezones flawlessly.
BR Business Days Calculator
Stop LLMs from calculating SLAs incorrectly. An local, deterministic engine that adds business days while perfectly avoiding weekends and Brazilian national holidays.
Deadline Calculator
Calculate precise end dates by adding calendar or business days, accounting for weekends and regional holidays.
Bring your own AI
Change the model, client or framework. Keep Holiday API connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about Holiday API.
The practical details behind the request, access and result.
Can Holiday API find holidays for every country?
Yes, the Connector provides access to public and federal holiday data for over 200 countries worldwide.
Can I use it to see if a date is a workday?
Yes, you can ask your agent to find the next available business day from any date, and it will skip over weekends and public holidays.
Does it work for past years?
Yes, you can query holidays for specific years to audit past events or plan for future ones.
How does it help with payroll?
It allows you to quickly verify if a specific date is a public holiday in a different country, helping you ensure payroll compliance for international employees.
Can I see which languages are supported?
Yes, you can ask your agent to list the supported languages to see how the holiday names will appear in your results.
Is there a limit on how many countries I can check?
There is no specific limit. You can query data for any of the 200+ countries supported by the catalog.
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.
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.
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.
One connection away
Give your agent a direct line to Holiday API.
Connect Holiday API once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available