How to Use the Calendarific Alternative MCP in Windsurf

Q: How do I add the Calendarific Alternative to Windsurf?

Open your /.codeium/windsurf/mcpconfig.json file and add the MCP Server configuration under the mcpServers key. Alternatively, use the Settings UI under Cascade to add the URL. Cascade automatically detects the tools once you save.

Q: Do I need to manually configure country codes?

You do not have to. You can ask Cascade to run listsupportedcountries first, and it will figure out the correct ISO codes to use for your holiday queries.

Get global holiday schedules directly into Windsurf Cascade so your workspace planning never hits a calendar blind spot.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Calendarific Alternative MCP to Windsurf

Create your Vinkius account to connect Calendarific Alternative to Windsurf 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 Calendarific Alternative with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Cascade maps global holiday schedules instantly

The `list_supported_countries` tool lets Windsurf check where your remote developers live before planning a sprint. This keeps your workspace aligned with regional schedules. From there, the agent calls `get_holidays` to pull specific dates for the current year. Your plan updates itself without you copy-pasting from a browser.

Autonomous sprint planning with this MCP Server

Running `get_holidays` allows Cascade to spot upcoming launch conflicts directly in your codebase. The agent checks if the target date is a bank holiday in London or Tokyo. It reads the output and flags conflicts right inside your workspace. You avoid scheduling deployments on days when nobody is online to fix bugs.

Localized project timelines

The `get_holidays` tool handles tracking different religious and national events for global clients. Cascade runs queries for multiple regions in a single pass. You get a clean list of off-days that Cascade writes directly into your markdown roadmaps. No manual research, just accurate dates served directly to your IDE.

Setup guide

Set up Calendarific Alternative MCP in Windsurf

Prerequisites

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

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Calendarific Alternative MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Calendarific Alternative payment history." If connected, Cascade will call the Calendarific Alternative tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "calendarific-alternative-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 Calendarific. 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 Calendarific Alternative 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 Calendarific Alternative MCP in Windsurf

Open your `~/.codeium/windsurf/mcp_config.json` file and add the MCP Server configuration under the `mcpServers` key. Alternatively, use the Settings UI under Cascade to add the URL. Cascade automatically detects the tools once you save.

Yes, Cascade can plan multi-step actions using this MCP Server. It will read your roadmap, query `get_holidays` for the relevant countries, and rewrite the schedule files to avoid conflicts.

Web scraping is fragile and requires writing custom parsers for every country. This server provides clean, structured JSON directly to Cascade through the MCP standard, making date lookups fast and reliable.

You do not have to. You can ask Cascade to run `list_supported_countries` first, and it will figure out the correct ISO codes to use for your holiday queries.

The server only processes country codes and year integers to fetch holiday calendars. This basic input data is processed in a secure, ephemeral sandbox, so your internal project timelines and team locations are never stored or exposed.

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