Türkiye Business Days & Public Holidays

Working

io.github.foster-ops/turkey-business-calendarv1.0.0 GitHub verified

Türkiye public holidays (incl. half-day eves, Diyanet dates) and business-day math, 2022–2035.

Utilities

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

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

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

add_business_days Read-only

Returns the date that is N business days after (or before, if N is negative) a start date in Türkiye, e.g. for payment terms or legal deadlines. The start date is not counted. Türkiye's official calendar (Law 2429 holidays plus Diyanet's religious holidays), covering 2022-01-01 to 2035-12-31. Business days are Monday–Friday minus official holidays. Eves of Republic Day and the religious holidays are half days (holiday from 13:00).

datestring, required

Start date, YYYY-MM-DD

daysinteger, required

Business days to add; negative to go back; non-zero

calendarstring

standard: general business days. public_sector: also excludes announced administrative leave (from 2026). tcmb: days the central bank publishes exchange rates (no bulletin on eves).

half_daysstring

Count half-day eves as working days or as holidays.

Tools (4)

add_business_days

read-only

Argument	Type	Description
date*	string	Start date, YYYY-MM-DD
days*	integer	Business days to add; negative to go back; non-zero
calendar	string	standard: general business days. public_sector: also excludes announced administrative leave (from 2026). tcmb: days the central bank publishes exchange rates (no bulletin on eves).
half_days	string	Count half-day eves as working days or as holidays.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "date",
    "days"
  ],
  "properties": {
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Start date, YYYY-MM-DD"
    },
    "days": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "Business days to add; negative to go back; non-zero"
    },
    "calendar": {
      "enum": [
        "standard",
        "public_sector",
        "tcmb"
      ],
      "type": "string",
      "default": "standard",
      "description": "standard: general business days. public_sector: also excludes announced administrative leave (from 2026). tcmb: days the central bank publishes exchange rates (no bulletin on eves)."
    },
    "half_days": {
      "enum": [
        "working",
        "holiday"
      ],
      "type": "string",
      "default": "working",
      "description": "Count half-day eves as working days or as holidays."
    }
  }
}

check_business_day

Tells whether a date is a business day in Türkiye, which holiday falls on it and whether only the afternoon is off. Türkiye's official calendar (Law 2429 holidays plus Diyanet's religious holidays), covering 2022-01-01 to 2035-12-31. Business days are Monday–Friday minus official holidays. Eves of Republic Day and the religious holidays are half days (holiday from 13:00).

read-only

Argument	Type	Description
date*	string	Date, YYYY-MM-DD
calendar	string	standard: general business days. public_sector: also excludes announced administrative leave (from 2026). tcmb: days the central bank publishes exchange rates (no bulletin on eves).
half_days	string	Count half-day eves as working days or as holidays.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "date"
  ],
  "properties": {
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Date, YYYY-MM-DD"
    },
    "calendar": {
      "enum": [
        "standard",
        "public_sector",
        "tcmb"
      ],
      "type": "string",
      "default": "standard",
      "description": "standard: general business days. public_sector: also excludes announced administrative leave (from 2026). tcmb: days the central bank publishes exchange rates (no bulletin on eves)."
    },
    "half_days": {
      "enum": [
        "working",
        "holiday"
      ],
      "type": "string",
      "default": "working",
      "description": "Count half-day eves as working days or as holidays."
    }
  }
}

count_business_days

Counts business days between two dates in Türkiye, both dates included. Türkiye's official calendar (Law 2429 holidays plus Diyanet's religious holidays), covering 2022-01-01 to 2035-12-31. Business days are Monday–Friday minus official holidays. Eves of Republic Day and the religious holidays are half days (holiday from 13:00).

read-only

Argument	Type	Description
to*	string	Date, YYYY-MM-DD
from*	string	Date, YYYY-MM-DD
calendar	string	standard: general business days. public_sector: also excludes announced administrative leave (from 2026). tcmb: days the central bank publishes exchange rates (no bulletin on eves).
half_days	string	Count half-day eves as working days or as holidays.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "from",
    "to"
  ],
  "properties": {
    "to": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Date, YYYY-MM-DD"
    },
    "from": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Date, YYYY-MM-DD"
    },
    "calendar": {
      "enum": [
        "standard",
        "public_sector",
        "tcmb"
      ],
      "type": "string",
      "default": "standard",
      "description": "standard: general business days. public_sector: also excludes announced administrative leave (from 2026). tcmb: days the central bank publishes exchange rates (no bulletin on eves)."
    },
    "half_days": {
      "enum": [
        "working",
        "holiday"
      ],
      "type": "string",
      "default": "working",
      "description": "Count half-day eves as working days or as holidays."
    }
  }
}

list_holidays

Lists all public holidays of a year in Türkiye, with Turkish/English names, type, half-day eves and announced administrative leave. Türkiye's official calendar (Law 2429 holidays plus Diyanet's religious holidays), covering 2022-01-01 to 2035-12-31. Business days are Monday–Friday minus official holidays. Eves of Republic Day and the religious holidays are half days (holiday from 13:00).

read-only

Argument	Type	Description
year*	integer	Year, 2022–2035

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "year"
  ],
  "properties": {
    "year": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "Year, 2022–2035"
    }
  }
}