How do I use turkiye-mcp?

This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.

turkiye-mcp

by YusufSizmaz

Overview Schema Source Related Servers Discussions Admin

Remote

🇹🇷 turkiye-mcp

Türkiye'nin güncel kamu verileri, yapay zekâ asistanınızın içinde.

Döviz, borsa, deprem, Resmî Gazete, hava, nöbetçi eczane, akaryakıt, şehir verileri, namaz vakitleri… Tek bir MCP sunucusu · tipli TypeScript kütüphanesi · her yanıtta kaynak ve zaman.

9 kategori · 32 kaynak (24 resmî) · 31 MCP aracı

⚡ Kurulum

claude mcp add turkiye -- npx -y github:YusufSizmaz/turkiye-mcp

Claude Desktop, Cursor, VS Code ve diğer MCP istemcileri için:

{ "mcpServers": { "turkiye": { "command": "npx", "args": ["-y", "github:YusufSizmaz/turkiye-mcp"] } } }

Node.js 20+ yeterli; anahtar veya kayıt gerekmez. İstemciyi yeniden başlatıp sorun: “Bugün Resmî Gazete'de neler var?”

Related MCP server: evds-mcp-server

📚 Araçlar

💱 Finans & Piyasalar · 🌍 Deprem & Afet · 📜 Resmî Yayınlar · 🌤️ Hava & Çevre · ⛽ Enerji & Akaryakıt · 💊 Sağlık · 🏙️ Şehir Verileri · 🗺️ Coğrafya · 📅 Takvim & Vakitler

💱 Finans & Piyasalar

Döviz kurları, altın, BIST hisseleri ve endeksleri, kripto paralar, KAP bildirimleri ve TCMB EVDS serileri.

Araç	Ne yapar	Örnek soru
`finans_get_exchange_rates`	TCMB döviz kurları	“Dolar ve euro bugün kaç TL?”
`finans_get_kap_disclosures`	KAP bildirimleri	“KAP'a son düşen bildirimler neler?”
`finans_search_kap_companies`	KAP şirket/fon arama	“Aselsan'ın hisse kodu ne?”
`finans_get_gold_prices`	Altın ve değerli metal fiyatları	“Gram altın ve çeyrek altın şu an kaç TL?”
`finans_get_stock_history`	BIST hisse fiyat geçmişi	“THYAO son bir ayda nasıl gitti?”
`finans_get_crypto_prices`	Kripto para fiyatları (TL)	“Bitcoin şu an kaç TL?”
`finans_get_evds_series`	TCMB EVDS zaman serileri	“TÜFE endeksi (TP.FG.J0) son 12 ayda nasıl değişti?”
`finans_get_bist_index`	BIST endeks bileşenleri	“BIST 30'da hangi hisseler var?”

Kaynaklar: 🏛️ TCMB · 🏛️ KAP · 🌐 Truncgil · 🌐 İş Yatırım · ✅ BtcTurk · ✅ Paribu · 🏛️ TCMB EVDS 🔑 · 🏛️ Borsa İstanbul
Parametreler, uç noktalar ve kod örnekleri →

🌍 Deprem & Afet

AFAD ve Kandilli Rasathanesi'nden son depremler.

Araç	Ne yapar	Örnek soru
`deprem_get_recent`	Son depremler	“Son 24 saatte 4'ten büyük deprem oldu mu?”

Kaynaklar: 🏛️ AFAD · 🏛️ Kandilli Rasathanesi
Parametreler, uç noktalar ve kod örnekleri →

📜 Resmî Yayınlar

Resmî Gazete'nin günlük sayıları ve Mevzuat Bilgi Sistemi'nde kanun, yönetmelik ve tebliğ araması.

Araç	Ne yapar	Örnek soru
`resmi_gazete_get_issue`	Resmî Gazete günlük sayı	“Bugünkü Resmî Gazete'de neler var?”
`resmi_mevzuat_search`	Mevzuat arama	“Kişisel verilerle ilgili yönetmelikler hangileri?”

Kaynaklar: 🏛️ Resmî Gazete · 🏛️ Mevzuat Bilgi Sistemi
Parametreler, uç noktalar ve kod örnekleri →

🌤️ Hava & Çevre

MGM anlık hava durumu ve tahminleri, Ulusal Hava Kalitesi İzleme Ağı ölçümleri.

Araç	Ne yapar	Örnek soru
`hava_get_current`	Anlık hava durumu (MGM)	“Kadıköy'de hava şu an nasıl?”
`hava_get_forecast`	Hava tahmini (MGM)	“İzmir'de hafta sonu hava nasıl olacak?”
`hava_get_air_quality`	Hava kalitesi	“Ankara'da hava kalitesi nasıl?”

Kaynaklar: 🏛️ MGM · 🏛️ Ulusal Hava Kalitesi Ağı 🇹🇷
Parametreler, uç noktalar ve kod örnekleri →

⛽ Enerji & Akaryakıt

İl/ilçe bazında akaryakıt pompa fiyatları ve EPİAŞ elektrik piyasası verileri.

Araç	Ne yapar	Örnek soru
`enerji_get_fuel_prices`	Akaryakıt fiyatları (Opet)	“Kadıköy'de benzin litresi kaç TL?”
`enerji_get_electricity_market`	Elektrik piyasası (EPİAŞ)	“Bugün elektrik piyasa takas fiyatı saatlik ne kadar?”

Kaynaklar: ✅ Opet · 🏛️ EPİAŞ 🔑
Parametreler, uç noktalar ve kod örnekleri →

💊 Sağlık

Eczacı odalarından bugünkü nöbetçi eczaneler (İstanbul, Yalova, Ankara, İzmir, Adana, Mersin). Yeni il adaptörlerine katkıya açık.

Araç	Ne yapar	Örnek soru
`eczane_get_on_duty`	Nöbetçi eczaneler	“Kadıköy'de bugün nöbetçi eczane hangisi?”

Kaynaklar: 🏛️ İstanbul Eczacı Odası · 🏛️ Ankara Eczacı Odası 🇹🇷 · 🏛️ İzmir BB · 🏛️ Adana Eczacı Odası · 🏛️ Mersin Eczacı Odası
Parametreler, uç noktalar ve kod örnekleri →

🏙️ Şehir Verileri

İstanbul trafik endeksi ve İSPARK; İzmir hal fiyatları, İZBAN/vapur saatleri ve kent rehberi; İBB ve İzmir açık veri portallarında arama.

Araç	Ne yapar	Örnek soru
`istanbul_get_traffic_index`	İstanbul trafik endeksi	“İstanbul'da trafik şu an nasıl?”
`istanbul_get_parking`	İSPARK boş otoparklar	“Kadıköy'de boş yeri olan İSPARK otoparkları hangileri?”
`opendata_search`	Belediye açık veri arama	“İBB açık veride baraj doluluk verisi var mı?”
`opendata_query`	Belediye açık veri tablosu sorgula	“Bu veri setinin son 10 kaydını getir”
`izmir_get_market_prices`	İzmir hal fiyatları	“İzmir halinde domatesin kilosu kaç lira?”
`izmir_get_izban_times`	İZBAN sefer saatleri	“Alsancak'tan Menemen'e bir sonraki İZBAN kaçta?”
`izmir_get_ferry_times`	İzmir vapur saatleri	“Karşıyaka'dan Konak'a vapur saatleri”
`izmir_find_places`	İzmir kent rehberi	“Bornova'daki afet toplanma alanları nerede?”

Kaynaklar: 🏛️ İBB Trafik 🇹🇷 · 🏛️ İSPARK 🇹🇷 · 🏛️ İzmir BB (hal) · 🏛️ İzmir BB (ulaşım) · 🏛️ İzmir BB (kent rehberi) · 🏛️ İBB Açık Veri 🇹🇷 · 🏛️ İzmir Açık Veri
Parametreler, uç noktalar ve kod örnekleri →

🗺️ Coğrafya

81 il, ilçe ve mahalle bilgileri: nüfus, yüzölçümü, rakım, bölge, plaka, telefon kodu, koordinat.

Araç	Ne yapar	Örnek soru
`cografya_get_provinces`	İl bilgileri	“Ankara'nın nüfusu ve yüzölçümü ne?”
`cografya_get_districts`	İlçeler	“İzmir'in en kalabalık ilçeleri hangileri?”
`cografya_get_neighborhoods`	Mahalleler	“Kadıköy'ün mahalleleri ve nüfusları”

Kaynaklar: 🌐 TurkiyeAPI
Parametreler, uç noktalar ve kod örnekleri →

📅 Takvim & Vakitler

Resmî tatiller ve dinî bayramlar; il/ilçe bazında namaz vakitleri (Diyanet verisi).

Araç	Ne yapar	Örnek soru
`takvim_get_holidays`	Resmî tatiller	“Bu yıl Kurban Bayramı ne zaman?”
`takvim_get_prayer_times`	Namaz vakitleri	“İstanbul'da bugün akşam ezanı kaçta?”

Kaynaklar: 🌐 Nager.Date · 🌐 Ezan Vakti 🇹🇷 · 🏛️ Diyanet 🔑
Parametreler, uç noktalar ve kod örnekleri →

🏷️ Kaynak rozetleri

	Anlamı
🏛️	Resmî — kamu kurumu, belediye, meslek odası (TCMB, AFAD, KAP, MGM, İBB…)
✅	Birinci taraf — şirketin kendi API'si (Opet, BtcTurk, Paribu)
🌐	Topluluk — üçüncü taraf kaynak (Truncgil, İş Yatırım, TurkiyeAPI…)
🔑	Ücretsiz anahtar ister — tanımlı değilse araç listede görünmez
🇹🇷	Yurt dışı IP'lerini engelliyor — Türkiye'den çalışır

Her yanıtın sonunda kaynak, rozet ve verinin çekildiği zaman yazar. Tüm kaynaklar her sabah canlı test edilir: durum sayfası →

⚙️ Ayarlar

Ortam değişkeni	Ne işe yarar
`TURKIYE_MCP_CATEGORIES`	Yalnız seçilen kategoriler, ör. `finans,deprem` (araç listesini kısaltır)
`TCMB_EVDS_KEY`	TCMB EVDS serileri — ücretsiz anahtar
`EPIAS_USERNAME` · `EPIAS_PASSWORD`	EPİAŞ elektrik piyasası — ücretsiz üyelik
`DIYANET_EMAIL` · `DIYANET_PASSWORD`	Namaz vakitleri doğrudan Diyanet API'sinden — kayıt

📦 Kütüphane olarak

import { afad, eczane, mgm, tcmb } from "turkiye-mcp";   // npm i github:YusufSizmaz/turkiye-mcp

const kurlar = await tcmb.getRates();
const depremler = await afad.getEarthquakes({ saat: 24, minBuyukluk: 4 });
const hava = await mgm.getCurrent("İzmir", "Bornova");
const nobetci = await eczane.getOnDuty({ il: "Ankara", ilce: "Çankaya" });
// her biri → { veri, kaynak: { ad, rozet, url, alinmaZamani }, not? }

🛠️ Geliştirme

npm install && npm test   # kayıtlı gerçek yanıtlarla unit testler
npm run test:live         # tüm kaynaklara canlı istek
npm run readme            # bu sayfadaki araç listesini yeniden üretir

Yeni kaynak veya yeni il için nöbetçi eczane eklemek: CONTRIBUTING.md

⚖️ Sorumluluk reddi

Veriler kaynaklardan olduğu gibi alınır; turkiye-mcp hiçbir kurumla bağlantılı değildir. Finansal veriler yatırım tavsiyesi değildir, deprem bilgisi resmî uyarıların yerini tutmaz, nöbetçi eczaneyi gitmeden önce telefonla teyit edin.

turkiye-mcp is an MCP server and typed TypeScript library giving AI assistants live, source-attributed access to Turkish public data: Central Bank FX, KAP disclosures, Borsa Istanbul indices, earthquakes (AFAD, Kandilli), the Official Gazette and legislation search, weather and air quality, on-duty pharmacies, fuel prices, Istanbul and İzmir city data, prayer times and holidays. Every result carries its source, a trust badge and a timestamp; all sources are checked daily (status page). Install: claude mcp add turkiye -- npx -y github:YusufSizmaz/turkiye-mcp. Tool names are English; outputs are Turkish.

Lisans

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

VeriApi.ProA
io.github.veriapipro
Turkey data API for AI agents: 40 tools + search/call for 230+ endpoints. Addresses (provinces, districts, postal codes, boundaries), validation (IBAN, tax ID/VKN, TCKN, phone, barcode), tax and salary calculators, Official Gazette, exchange rates, gold, crypto, economic indicators, prayer times, holidays and business days, weather, air quality, earthquakes, dam levels, fuel prices, EV charging, power outages, tolls, pharmacies on duty, football standings. Turkish JSON, free plan.
Data Platforms Developer Tools Finance
471
https://api.veriapi.pro/v1/mcp
ServiceBox APIs
io.servicebox
Turkish data APIs as MCP tools: pharmacies, fuel, FX, gold, crypto, weather, prayer times, news.
Finance Weather Services Open Data
1
https://mcp.servicebox.io/mcp
Public Data Ukraine McpA
io.github.varvararatta
Public Data Ukraine Mcp connects AI agents to real public APIs via MCP. Tools include
Government Data Open Data
52
https://public-data-ukraine-mcp.mcpize.run/mcp
NS Pros Data API
io.github.ocean1547-ui
The world's public data, one API. License-cleared public data sources for agents, via MCP and REST.
Open Data Search
1
https://api.nspros.ca/mcp

Related MCP Servers

turkey-data-mcp
Finance Location Services Open Data
bodyegypt
A
license
A
quality
C
maintenance
MCP server for live Turkey data — gold & silver prices, official TCMB exchange rates, fuel pump prices, prayer times and the Kandilli earthquake feed.
Updated 16 days ago (2026-10-26 15:57 UTC)
7
73 npm
1
MIT
evds-mcp-server
Finance Government Data
denizcakiroglu322
A
license
A
quality
D
maintenance
Enables querying Turkish economic data (inflation, FX rates, policy rates, etc.) from TCMB EVDS via curated tools, preventing LLM hallucination.
Updated 5 months ago (2026-06-26 13:08 UTC)
6
MIT
turkiye-energy-mcp
Energy Government Data
emresoykan
A
license
Not graded
quality
C
maintenance
An MCP server that provides verified official Turkish electricity system data (from TEİAŞ and EÜAŞ) via tools for querying generation, installed capacity, demand, and import/export, enabling natural language access to energy statistics.
Updated a day ago (2026-11-10 10:47 UTC)
MIT
VeriTR
Government Data Open Data Search
ulascan54
A
license
A
quality
C
maintenance
MCP server that unifies official Turkish open data sources into a single interface, letting AI agents query and compare normalized indicators like population, inflation, and GDP through natural language.
Updated 3 months ago (2026-08-24 19:40 UTC)
10
MIT