turkiye-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_exchange_ratesA | Official indicative exchange rates (TRY per unit) from the Central Bank of the Republic of Türkiye (TCMB). Latest bulletin by default, or any past date since 1996 (weekends/holidays fall back to the previous bulletin). |
| convert_currencyA | Convert an amount between TRY and any currency in the TCMB bulletin (or between two foreign currencies via TRY) using official TCMB rates for a date. |
| get_recent_earthquakesA | Latest earthquakes from AFAD (Disaster and Emergency Management Authority) or Kandilli Observatory (Boğaziçi University). Times are returned in UTC and Türkiye local time. |
| get_public_holidaysA | Official public holidays for a year (2024-2035), including Ramazan/Kurban Bayramı dates from Diyanet's official tables and half-day eves (arife). Works offline. |
| check_dateA | Tells whether a date in Türkiye is a weekend, a public holiday (full or half day) or a business day. Works offline. |
| add_business_daysA | Add (or subtract, with a negative number) N Turkish business days to a date, skipping weekends and full-day public holidays. Useful for legal, payment and delivery deadlines. |
| count_business_daysA | Count Turkish business days after |
| list_provincesA | All 81 provinces (il) of Türkiye with plate codes and district counts. Works offline. |
| get_provinceA | Look up a province by name (any casing, with or without Turkish characters) or plate code, and get its districts (ilçe). Works offline. |
| find_districtA | Find which province a district (ilçe) belongs to. Handles names that exist in several provinces. Works offline. |
| validate_tcknA | Check the checksum of a Turkish national ID number (T.C. Kimlik No). Offline; the number is never sent anywhere. |
| validate_vknA | Check the checksum of a Turkish tax ID (10-digit VKN; 11-digit input is checked as a TCKN). Offline. |
| validate_ibanA | Validate a Turkish IBAN (mod-97) and identify the bank from the TCMB participant list. Offline. |
| get_prayer_timesA | Daily prayer times (imsak, güneş, öğle, ikindi, akşam, yatsı) for a province or district, computed with the Diyanet method via the free Aladhan API. |
| get_weatherA | Current weather and a short daily forecast for a province or district, from Open-Meteo (free, no key). |
| turkish_textA | Correct Turkish upper/lower/title case (i/İ, ı/I), ASCII transliteration and URL slugs. LLMs often get the dotted/dotless i wrong; use this instead. |
| amount_to_wordsA | Write a number or money amount in Turkish words, as required on invoices, cheques and contracts, e.g. 1250.50 -> "Bin İki Yüz Elli Türk Lirası Elli Kuruş". |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 17 tools
Each tool has a clearly distinct purpose across finance, disaster data, holidays, geography, validation, prayer, weather, and text utilities. The closest pairs (get_exchange_rates vs convert_currency, check_date vs business-day tools, list_provinces vs get_province vs find_district) are still easily distinguished by their descriptions.
Most tools follow a predictable snake_case verb_noun pattern (get_exchange_rates, validate_iban, add_business_days, etc.). Two tools, turkish_text and amount_to_words, use noun phrases instead, which is a minor but notable deviation.
At 17 tools, the set is slightly above the typical 3-15 sweet spot, but the server explicitly covers many Türkiye-specific domains and each tool earns its place. It does not feel bloated or redundant despite being a bit heavy.
The surface covers core operations well: exchange rates and conversion, earthquake retrieval, holiday/business-day calculations, province/district lookup, TCKN/VKN/IBAN validation, prayer times, weather, and Turkish text formatting. Minor gaps exist, such as postal-code lookup or deeper earthquake/weather detail, but agents can work around them.