Skip to content
MCP server

Türkiye Business Days & Public Holidays

Turkish public holidays and business-day arithmetic for 2022 to 2035, as an MCP server

Install
Pricing
Free
Platforms
API
Runs
Remotely
Version
1.0.0
Listing updated
3 days ago

Similar MCP servers

About Türkiye Business Days & Public Holidays

Türkiye Business Days & Public Holidays is a free MCP server for productivity. It runs as a hosted remote server, so there is nothing to install locally.

Business-day questions in Turkey are fiddly because some holidays are half days. This server encodes that: the eves of Republic Day and the religious holidays count as a holiday from 13:00, and a half_days setting lets callers treat them as working or non-working days. Holiday data covers Law 2429 and the Diyanet religious dates from 2022 to 2035.

Three calendars are available. The standard one is Monday to Friday minus official holidays, public_sector also removes announced administrative leave from 2026, and tcmb follows the days the central bank publishes exchange-rate bulletins.

The same host also runs sibling endpoints for central-bank exchange rates and checksum validation of Turkish IBANs, tax numbers and national IDs, each with its own MCP path; this listing covers the calendar endpoint. It also offers plain REST routes for holidays, day checks, adding days and counting days.

Install

Run in a terminal

claude mcp add --transport http turkey-business-calendar https://foster-mcp.esakiz.workers.dev/calendar/mcp

Add to Settings → Connectors → Add custom connector

https://foster-mcp.esakiz.workers.dev/calendar/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "turkey-business-calendar": {
      "url": "https://foster-mcp.esakiz.workers.dev/calendar/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "turkey-business-calendar": {
      "type": "http",
      "url": "https://foster-mcp.esakiz.workers.dev/calendar/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "turkey-business-calendar": {
      "serverUrl": "https://foster-mcp.esakiz.workers.dev/calendar/mcp"
    }
  }
}

Add to Grok Bot desktop app → Connect apps → Add a custom connector

https://foster-mcp.esakiz.workers.dev/calendar/mcp

Enter a Name (for example "Türkiye Business Days & Public Holidays"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

Full Grok Bot setup guide

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "turkey-business-calendar": {
      "type": "http",
      "url": "https://foster-mcp.esakiz.workers.dev/calendar/mcp"
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

list_holidays
Lists the official public holidays for a year.
check_business_day
Checks whether a date is a business day.
add_business_days
Adds business days to a start date.
count_business_days
Counts business days between two dates.

What it does

Half-day aware
Eves of Republic Day and religious holidays are treated as half days, with a switch to count them as working or holiday.
Three calendars
Choose standard, public_sector or tcmb depending on whose working days you need.
Long coverage window
Holiday data runs from 2022 through 2035.
Date arithmetic
Add or subtract business days from a start date, or count business days between two dates.
REST alongside MCP
The same logic is also exposed as plain JSON endpoints.

Good for

  • Compute a payment due date that skips Turkish public holidays
  • Check whether a given date is a working day before scheduling a job
  • Count business days in a month for payroll or SLA reporting
  • List every public holiday in a year for a planning calendar

Pricing

Free

Free, no API key stated for the host

Prices change. Check foster-mcp.esakiz.workers.dev before you buy.

Türkiye Business Days & Public Holidays FAQ

How are half days handled?

Eves of Republic Day and the religious holidays are holidays from 13:00; the half_days option lets you treat them as working or holiday.

Which years are covered?

2022 through 2035.

Does adding days count the start date?

No. The start date is not counted, and negative values move backwards.

Is an API key needed?

The host describes its services as free with no API key.

Is Türkiye Business Days & Public Holidays free?

Yes. Türkiye Business Days & Public Holidays is free to use.

How do I add Türkiye Business Days & Public Holidays to Claude Code?

Run this command in your terminal: claude mcp add --transport http turkey-business-calendar https://foster-mcp.esakiz.workers.dev/calendar/mcp

What are the best alternatives to Türkiye Business Days & Public Holidays?

The closest alternatives to Türkiye Business Days & Public Holidays are WorkdayAPI, World Business Calendar, World Public Holidays, Holiday Calendar and Public Holidays & Business Days (200+ countries).

Where this comes from

  • Description: written from the project's website.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers