Türkiye Business Days & Public Holidays
Türkiye public holidays (incl. half-day eves, Diyanet dates) and business-day math, 2022–2035.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"turkey-business-calendar": {
"url": "https://foster-mcp.esakiz.workers.dev/calendar/mcp"
}
}
}Remote endpoints
https://foster-mcp.esakiz.workers.dev/calendar/mcpstreamable-httpWhat it can do
Tool inventory
Tools (4)
🟢list_holidays(year)
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).
Input Schema
{
"type": "object",
"properties": {
"year": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "Year, 2022–2035"
}
},
"required": [
"year"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"year": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"holidays": {
"type": "array",
"items": {
"type": "object",
"properties": {
"date": {
"type": "string"
},
"name_tr": {
"type": "string"
},
"name_en": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"national",
"general",
"religious"
]
},
"portion": {
"type": "string",
"enum": [
"full",
"afternoon"
]
},
"starts_at": {
"type": [
"string",
"null"
]
}
},
"required": [
"date",
"name_tr",
"name_en",
"type",
"portion",
"starts_at"
],
"additionalProperties": false
}
},
"full_days_on_weekdays": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"administrative_leave": {
"type": "array",
"items": {
"type": "object",
"properties": {
"date": {
"type": "string"
},
"portion": {
"type": "string",
"enum": [
"full",
"morning"
]
},
"reason_en": {
"type": "string"
}
},
"required": [
"date",
"portion",
"reason_en"
],
"additionalProperties": false
}
},
"notes": {
"type": "array",
"items": {
"type": "string"
}
},
"source": {
"type": "string"
},
"disclaimer": {
"type": "string"
}
},
"required": [
"year",
"holidays",
"full_days_on_weekdays",
"administrative_leave",
"notes",
"source",
"disclaimer"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢check_business_day(date, calendar, half_days)
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).
Input Schema
{
"type": "object",
"properties": {
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Date, YYYY-MM-DD"
},
"calendar": {
"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).",
"type": "string",
"enum": [
"standard",
"public_sector",
"tcmb"
]
},
"half_days": {
"default": "working",
"description": "Count half-day eves as working days or as holidays.",
"type": "string",
"enum": [
"working",
"holiday"
]
}
},
"required": [
"date"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"date": {
"type": "string"
},
"weekday": {
"type": "string"
},
"business_day": {
"type": "boolean"
},
"day_off": {
"type": "string",
"enum": [
"none",
"afternoon",
"full"
]
},
"holidays": {
"type": "array",
"items": {
"type": "object",
"properties": {
"date": {
"type": "string"
},
"name_tr": {
"type": "string"
},
"name_en": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"national",
"general",
"religious"
]
},
"portion": {
"type": "string",
"enum": [
"full",
"afternoon"
]
},
"starts_at": {
"type": [
"string",
"null"
]
}
},
"required": [
"date",
"name_tr",
"name_en",
"type",
"portion",
"starts_at"
],
"additionalProperties": false
}
},
"administrative_leave": {
"type": "array",
"items": {
"type": "object",
"properties": {
"portion": {
"type": "string",
"enum": [
"full",
"morning"
]
},
"ends_at": {
"type": [
"string",
"null"
]
},
"reason_tr": {
"type": "string"
},
"reason_en": {
"type": "string"
},
"source": {
"type": "string"
},
"applies_to": {
"type": "string",
"const": "public_sector"
}
},
"required": [
"portion",
"ends_at",
"reason_tr",
"reason_en",
"source",
"applies_to"
],
"additionalProperties": false
}
},
"calendar": {
"type": "string",
"enum": [
"standard",
"public_sector",
"tcmb"
]
},
"half_days": {
"type": "string",
"enum": [
"working",
"holiday"
]
},
"source": {
"type": "string"
},
"disclaimer": {
"type": "string"
}
},
"required": [
"date",
"weekday",
"business_day",
"day_off",
"holidays",
"administrative_leave",
"calendar",
"half_days",
"source",
"disclaimer"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢add_business_days(date, days, calendar, half_days)
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).
Input Schema
{
"type": "object",
"properties": {
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Start date, YYYY-MM-DD"
},
"days": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "Business days to add; negative to go back; non-zero"
},
"calendar": {
"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).",
"type": "string",
"enum": [
"standard",
"public_sector",
"tcmb"
]
},
"half_days": {
"default": "working",
"description": "Count half-day eves as working days or as holidays.",
"type": "string",
"enum": [
"working",
"holiday"
]
}
},
"required": [
"date",
"days"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"start_date": {
"type": "string"
},
"business_days": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"result_date": {
"type": "string"
},
"result_weekday": {
"type": "string"
},
"rule": {
"type": "string"
},
"calendar": {
"type": "string",
"enum": [
"standard",
"public_sector",
"tcmb"
]
},
"half_days": {
"type": "string",
"enum": [
"working",
"holiday"
]
},
"source": {
"type": "string"
},
"disclaimer": {
"type": "string"
}
},
"required": [
"start_date",
"business_days",
"result_date",
"result_weekday",
"rule",
"calendar",
"half_days",
"source",
"disclaimer"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢count_business_days(from, to, calendar, half_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).
Input Schema
{
"type": "object",
"properties": {
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Date, YYYY-MM-DD"
},
"to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Date, YYYY-MM-DD"
},
"calendar": {
"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).",
"type": "string",
"enum": [
"standard",
"public_sector",
"tcmb"
]
},
"half_days": {
"default": "working",
"description": "Count half-day eves as working days or as holidays.",
"type": "string",
"enum": [
"working",
"holiday"
]
}
},
"required": [
"from",
"to"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"from": {
"type": "string"
},
"to": {
"type": "string"
},
"calendar_days": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"business_days": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"rule": {
"type": "string"
},
"calendar": {
"type": "string",
"enum": [
"standard",
"public_sector",
"tcmb"
]
},
"half_days": {
"type": "string",
"enum": [
"working",
"holiday"
]
},
"source": {
"type": "string"
},
"disclaimer": {
"type": "string"
}
},
"required": [
"from",
"to",
"calendar_days",
"business_days",
"rule",
"calendar",
"half_days",
"source",
"disclaimer"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Community
Evidence