# Türkiye Business Days & Public Holidays

> Türkiye Business Days & Public Holidays is a free MCP server for productivity. Turkish public holidays and business-day arithmetic for 2022 to 2035, as an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API
- **Website:** https://foster-mcp.esakiz.workers.dev/llms.txt
- **MCP Registry name:** io.github.foster-ops/turkey-business-calendar
- **Categories:** [productivity](https://ai-powered.com/categories/productivity), [legal and government](https://ai-powered.com/categories/legal-and-government), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-16

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
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.

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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.

## Alternatives

- [WorkdayAPI](https://ai-powered.com/mcp/workdayapi): WorkdayAPI is a freemium MCP server for developer tools.
- [World Business Calendar](https://ai-powered.com/mcp/world-business-calendar): World Business Calendar is an open-source MCP server for productivity.
- [World Public Holidays](https://ai-powered.com/mcp/world-public-holidays): World Public Holidays is a free MCP server for productivity.
- [Holiday Calendar](https://ai-powered.com/mcp/holiday-calendar): Holiday Calendar is an open-source MCP server for productivity.
- [Public Holidays & Business Days (200+ countries)](https://ai-powered.com/mcp/public-holidays-and-business-days-200-countries): Public Holidays & Business Days (200+ countries) is a paid MCP server for productivity.
- [UAE Calendar Oracle](https://ai-powered.com/mcp/uae-calendar-oracle): UAE Calendar Oracle is a paid MCP server for productivity.
- [Canada Business Calendar MCP](https://ai-powered.com/mcp/canada-business-calendar-mcp): Canada Business Calendar MCP is a freemium MCP server for productivity.
- [Date Calculator](https://ai-powered.com/mcp/date-calculator): Date Calculator is a free MCP server for productivity.

---
Source: https://ai-powered.com/mcp/turkiye-business-days-and-public-holidays
