How to Use the Nager.Date MCP in Cline

Q: How does Cline handle errors if a country code is invalid?

If Cline passes an invalid code to getcountrydetails, the tool returns an error. Cline reads this error output, corrects the input code using listavailablecountries, and retries the action automatically.

Let Cline build holiday-aware features, write calendar components, and test dates using direct Nager.Date integration.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Nager.Date MCP to Cline

Create your Vinkius account to connect Nager.Date to Cline 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 Nager.Date with Cline

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build date-sensitive UI components with Cline

Tell Cline to build a holiday-aware checkout form or scheduling widget. The agent calls this MCP Server to fetch live regional data using `get_public_holidays`, then writes the React or Vue components directly into your workspace. Cline doesn't just mock the data. It writes integration tests using actual API payloads, runs the test suite in your VS Code terminal, and fixes any logic errors on the spot. You get working, production-ready code without manual typing.

Dynamic test suite validation with Cline

Stop manually writing static lists of test dates that break next year. Cline uses `is_holiday_today` to dynamically mock calendar states in your test suites, ensuring your date-calculation logic is always accurate. By querying `get_next_holidays` during code generation, your agent can write robust edge-case tests for leap years, regional holiday shifts, and weekend-to-weekday rollovers without needing manual inputs.

Automated international localization checks

When localizing an application, managing country codes is a headache. Cline calls `list_available_countries` to get the supported ISO codes, then matches them against your database schema to flag missing regional configurations. Your agent can automatically trigger `get_country_details` to verify border relationships and regional groupings, updating your translation files and localization tables in one autonomous sweep.

Setup guide

Set up Nager.Date MCP in Cline

Prerequisites

VS Code with Cline extension installed
Active Vinkius subscription with a valid endpoint token

1

Open Cline MCP settings

Click the Cline icon in the VS Code sidebar to open the Cline panel. Then click the MCP Servers icon (server stack) at the top-right corner of the panel.
2

Add a remote server

Click "Remote Servers" at the top, then click "Add Remote MCP". In the Name field, type nagerdate-mcp. In the URL field, paste your Vinkius endpoint: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp. Get your token from cloud.vinkius.com.
3

Enable the server

After saving, the server appears in the Cline MCP panel. Toggle the switch to enable it. The status indicator turns green when the connection is live.
4

Start using tools

Return to the Cline chat and ask: "Check my latest Nager.Date refund status." Cline will discover the available tools and request your approval before invoking each one — giving you full control over every action.

Cline MCP Settings

{
  "mcpServers": {
    "nagerdate-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 Nager.Date. 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 Nager.Date 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 Nager.Date MCP in Cline

Open the Cline sidebar and click the MCP icon. You can install it with one click from the marketplace or add the Vinkius remote server URL to your `cline_mcp_settings.json` file.

Yes. You can instruct Cline to write a caching layer. It will fetch holiday data using `get_public_holidays` and write a Redis or local storage mechanism to prevent hitting rate limits during peak usage.

No API keys are required for the public endpoints. Vinkius handles the connection and transport, allowing Cline to immediately call tools like `get_next_holidays_worldwide` out of the box.

If Cline passes an invalid code to `get_country_details`, the tool returns an error. Cline reads this error output, corrects the input code using `list_available_countries`, and retries the action automatically.

The integration only transmits standard ISO country codes, years, and dates. No user data or proprietary source code is ever sent to the public holiday API, and Vinkius runs the execution in a zero-trust MCP sandbox.

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