Türkiye Business Days & Public Holidays

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

사용해야 할까요

품질 및 안전성

A
설명 품질
95%
스키마 완전성
100%
이름 품질
100%
오염 위험
100%
권한 일치
100%
프로토콜 준수
100%

도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.

컨텍스트 비용

~2,108토큰 (도구 정의)
~4.6 KB일반적인 응답 크기
중간 정도의 주의 영향 (128k 컨텍스트의 1.65%)

이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.

설치

원클릭 설치

`claude_desktop_config.json` 파일에 다음을 추가하세요:

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

원격 엔드포인트

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

할 수 있는 일

도구 목록

도구 (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).

입력 스키마

{
  "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"
}

출력 스키마

{
  "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).

입력 스키마

{
  "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"
}

출력 스키마

{
  "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).

입력 스키마

{
  "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"
}

출력 스키마

{
  "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).

입력 스키마

{
  "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"
}

출력 스키마

{
  "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
}

커뮤니티

이 서버 평가하기

증거

최근 관측

검증됨버전이 기록되지 않음도구 4개