How to Use the Holiday API MCP in VS Code Copilot

Q: Does Holiday API in VS Code Copilot handle forward projections?

Yes. Copilot calls getnextworkday to project exact delivery dates based on specific regional calendars.

Q: How do I fix invalid region errors with Holiday API in VS Code Copilot?

Prompt Copilot to run listsupportedcountries. It will replace your hardcoded strings with the correct ISO formats.

Standardize global date math and holiday logic for your entire engineering team via this MCP Server in VS Code Copilot.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Holiday API MCP to VS Code Copilot

Create your Vinkius account to connect Holiday API to VS Code Copilot and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Holiday API with VS Code Copilot

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Standardize SLA Math via MCP Server

`get_workdays_count` standardizes how your team calculates business days across the codebase. Copilot Chat queries the API to find the exact number of working days between two timestamps, ignoring weekends and national holidays. Instead of every developer writing their own date-math loops, the AI client relies on the API. It calls `get_next_workday` to generate forward-looking deadlines that actually respect local labor laws.

Validate Regional Holiday Logic

`get_holidays` fetches the exact public calendar for a target year and country. Your team uses this in VS Code to verify that automated payroll scripts are correctly identifying off-days for distributed employees. This prevents silent failures in your billing code. Copilot pulls the real dates, allowing you to write integration tests that prove your system handles sudden regional bank holidays correctly.

Configure Global Support Arrays

`list_supported_countries` outputs the definitive list of valid ISO codes for the API. Copilot uses this to populate your configuration files, ensuring no one commits an unsupported region code to the repository. For localization tasks, `list_supported_languages` provides the exact language keys the API accepts. Your agent drafts the mapping dictionaries using real data, eliminating translation errors in your calendar UI.

Setup guide

Set up Holiday API MCP in VS Code Copilot

Prerequisites

VS Code 1.99 or later with GitHub Copilot extension
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and run "MCP: Add Server". Select HTTP (Streamable) as the server type. VS Code will create .vscode/mcp.json in your workspace.
2

Add the Holiday API MCP

Paste the JSON snippet shown on the right into your .vscode/mcp.json. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Switch to Agent mode

Open Copilot Chat (Cmd+Shift+I / Ctrl+Shift+I) and switch to Agent mode using the dropdown. MCP tools are only available in Agent mode — they do not appear in Edit or Ask modes.
4

Verify the connection

In the Copilot Chat input, type # to list available tools. You should see the Holiday API tools listed. Try asking: "List my recent Holiday API transactions" and Copilot will invoke them automatically.

.vscode/mcp.json

{
  "mcpServers": {
    "holiday-api-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Holiday API. 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.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Holiday API now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Holiday API MCP in VS Code Copilot

Commit a .vscode/mcp.json file to your repository. Every developer pulling the repo gets the MCP tools automatically.

You don't need to mock them. Copilot fetches live data to write your tests and validate your date logic.

Yes. Copilot calls get_next_workday to project exact delivery dates based on specific regional calendars.

Prompt Copilot to run list_supported_countries. It will replace your hardcoded strings with the correct ISO formats.

The MCP integration only exchanges year integers and region codes. Your enterprise codebase and internal developer communications remain securely sandboxed from the external calendar service.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript