How to Use the Holiday API MCP in Cursor

Q: How does Holiday API in Cursor handle weekend math?

It skips them automatically. The agent uses getworkdayscount to pull the exact business days without writing custom loop logic.

Write accurate payroll and SLA calculation code using live Holiday API MCP Server data inside Cursor.

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 Cursor

Create your Vinkius account to connect Holiday API to Cursor 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 Cursor

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Generate SLA Logic with MCP Server Data

`get_next_workday` pulls live calendar math directly into your Cursor environment. When you write a shipping estimator, Agent mode queries the API to find the exact delivery date 10 business days out, skipping local holidays. You stop hardcoding weekend logic. The AI client writes your date-handling functions based on actual API responses, ensuring your code accounts for regional public schedules.

Build Accurate Payroll Systems

`get_workdays_count` calculates the exact number of billable days in a pay period between two dates. Cursor injects this real value into your test suites so you can verify your billing logic against actual calendar data. To test edge cases, the agent runs `get_holidays` to pull a specific country's federal schedule. You get working code that correctly reduces pay periods when national holidays occur.

Localize Calendar Components

`list_supported_countries` feeds the exact ISO codes into your frontend dropdowns. Cursor queries the list and generates the exact array of supported regions for your UI without you looking up the documentation. When building internationalized apps, `list_supported_languages` tells the agent which localizations are available. Your AI client writes the translation mapping functions using the actual supported language keys.

Setup guide

Set up Holiday API MCP in Cursor

Prerequisites

Cursor installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP Settings

Go to Cursor Settings → MCP or open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for "MCP: Add Server".
2

Add the Holiday API MCP

Cursor will create or open .cursor/mcp.json in your project root. Paste the JSON snippet on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Enable Agent mode

Open Composer (Cmd+I / Ctrl+I) and switch to Agent mode using the dropdown at the top. MCP tools are only available in Agent mode.
4

Verify the connection

Ask Cursor something like "List my recent Holiday API transactions." If the MCP tools are loaded correctly, Cursor will call the Holiday API tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/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 Cursor

Create an mcp.json file in your project root. Add the MCP server command and restart Agent mode.

Yes. The agent fetches real public holidays to generate accurate test cases for your date-parsing functions.

It skips them automatically. The agent uses get_workdays_count to pull the exact business days without writing custom loop logic.

The AI client needs the exact ISO format. Ask Agent mode to call list_supported_countries to get the correct identifiers.

The connection only transmits timestamp strings and ISO country codes to the MCP Server. Your proprietary source code never leaves your local machine during calendar queries.

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