Türkiye Business Days & Public Holidays
Turkish public holidays and business-day arithmetic for 2022 to 2035, as an MCP server
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://foster-mcp.esakiz.workers.dev/calendar/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"turkey-business-calendar": {
"url": "https://foster-mcp.esakiz.workers.dev/calendar/mcp"
}
}
}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/mcpEnter a Name (for example "Türkiye Business Days & Public Holidays"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.
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.