Skip to main content
Glama
turkiye-veri-mcp
by ahmthamza

Türkiye Veri MCP

Türkiye'nin dört resmi veri kaynağını tek MCP (Model Context Protocol) sunucusunda birleştirir — 30 araç:

  • TÜİK — Türkiye İstatistik Kurumu'nun veri portalı (veriportali.tuik.gov.tr) ve veri tarayıcısı (databrowser2.tuik.gov.tr): 19 tema, 515 SDMX veri akışı (boyut/kod filtresiyle, her kırılım ve dönem) ve 1.700'den fazla istab Excel tablosu.

  • TCMB EVDS — Merkez Bankası Elektronik Veri Dağıtım Sistemi (v3): 154 kategori, 680 veri grubu, 54 binden fazla seri; frekans dönüşümü, agregasyon ve formüller dahil API'nin tüm özellikleri. 1000 satır sınırı otomatik sayfalanır.

  • BDDK — Bankacılık Düzenleme ve Denetleme Kurumu'nun beş etkileşimli bülteni: FinTürk (il bazında, çeyreklik), Aylık Bülten (17 tablo, 2002'den bugüne), Haftalık Bülten, Günlük Bülten ve banka dışı mali kuruluşlar (finansal kiralama, faktoring, finansman, varlık yönetim).

  • HMB — Hazine ve Maliye Bakanlığı Muhasebat istatistikleri: il bazında genel bütçe geliri (2004+), il × kategori bütçe tabloları (Konsolide 1990–2003, Merkezi Yönetim 2004+, Mahalli İdareler 2006+), vergi gelirlerinden aktarılan paylar ve sitenin yayımladığı diğer tüm dosyalar.

One MCP server for Turkish official data — TUIK statistics, TCMB EVDS series, BDDK banking bulletins and HMB budget statistics, with province-level breakdowns EVDS doesn't have, plus tidy CSV export for research pipelines.

Sorumluluk reddi: Bu proje TÜİK, TCMB, BDDK veya HMB ile bağlantılı, onlar tarafından onaylanmış veya desteklenen bir proje değildir. Akademik araştırma amaçlı bağımsız bir araçtır.

Ortak ilke: araçlar doğrulayamadığı sayıyı sessizce döndürmez; ya kaynakla karşılaştırıp not düşer ya da açık bir hata verir. Her araç sohbette küçük bir önizleme gösterir; çoğu output_path ile tam tabloyu CSV olarak yazar.

Araçlar

TÜİK (anahtar gerektirmez):

Araç

Ne yapar

tuik_list_themes

19 istatistik temasını listeler

tuik_list_tables

Temadaki tabloları listeler (dataflow / istab / database)

tuik_search_tables

Tüm temalarda arama: Türkçe karakter duyarsız (isgucu → İşgücü), çok kelimeli, resource_type filtresi

tuik_describe_dataflow

Veriyi indirmeden boyutları, verisi olan kodları (tr/en etiketli), dönem aralığını ve gözlem sayısını verir

tuik_get_data

Veri akışını önizler; filters="SEX=2;...", start/end sunucuda uygulanır

tuik_download_data

Aynı seçimi tidy CSV olarak yazar

tuik_download_table_file

istab dosyasını (Excel) indirir

tuik_get_table_data

istab Excel'ini tidy uzun formata çevirir; tidy_confidence döndürür

usage_stats

Bu sunucu örneğinin araç çağrısı sayacı

EVDS (ücretsiz EVDS_API_KEY gerekir):

Araç

Ne yapar

evds_categories

Kategori ağacı (3 düzey)

evds_datagroups

Veri gruplarını listeler/arar (sayfalı; birim, kaynak, son güncelleme)

evds_series_list

Bir veri grubundaki serileri kodlarıyla listeler (sayfalı)

evds_series_info

Seri üst verisi: birim, frekans, ilk/son gözlem, varsayılan agregasyon, kaynak

evds_search_series

Seri adına/koduna göre arama (TR+EN, Türkçe karakter duyarsız; dizin arka planda kurulur)

evds_get_datagroup_data

Bir veri grubunun tüm serilerini tek seferde çeker

evds_get_data

Çoklu seri; frekans + agregasyon + formül, last_n, format="long", output_path

evds_download_data

Aynı parametrelerle CSV yazar

BDDK (anahtar gerektirmez):

Araç

Ne yapar

bddk_metadata

Her bültenin tablo, grup (taraf) kodu, para birimi ve dönem listesini siteden canlı okur — önce bunu çağırın; grup kodları bültenden bültene farklıdır

bddk_get_data

FinTürk il bazında veri: 7 tablo × 7 grup × 81 il + yurt dışı, 2007-12'den bugüne çeyreklik; donem_bitis ile zaman serisi

bddk_aylik_bulten

Aylık Bülten'in 17 tablosu (bilanço, kâr-zarar, krediler, mevduat, sermaye yeterliliği, rasyolar…), TL/USD

bddk_haftalik_bulten

Haftalık Bülten'in 9 tablosu (2014'ten bugüne)

bddk_haftalik_seri

Haftalık Bülten'de tek kalemin zaman serisi

bddk_gunluk_bulten

Günlük Bülten'in son günü; tek kalemin son ~7 iş günü

bddk_bdmk_bulten

Finansal kiralama, faktoring, finansman ve varlık yönetim şirketleri

HMB (anahtar gerektirmez):

Araç

Ne yapar

hmb_get_data

İl bazında genel bütçe geliri (Tahakkuk/Tahsilat), aylık kümülatif, 2004'ten bugüne — il_kodu: "01"-"81", "00" = Merkez muhasebe birimleri (ulusal toplam değildir)

hmb_get_karsilastirma

İl × kategori bütçe tabloları: gider/gelir/vergi/denge ve mahalli_*; 1990'dan bugüne

hmb_get_paylar

Genel bütçe vergi gelirlerinden mahalli idare ve fonlara aktarılan paylar

hmb_list_tables / hmb_list_files

Muhasebat sitesindeki tüm istatistik bölümlerini, klasörleri ve dosyaları gezer

hmb_get_file

Herhangi bir HMB dosyası: mizan, bilanço, borç, bütçe tabloları vb. doğrulanarak tidy tabloya çevrilir; doğrulanamayan gerekçesiyle reddedilir ve ham_path ile ham dosya olarak kaydedilir

Related MCP server: evds-mcp-server

Kurulum

İki yol var: hosted sunucuya bağlanmak (kurulum yok, aşağıdaki ilk bölüm) ya da kendi bilgisayarınızda çalıştırmak (bunun için uv gerekir — curl -LsSf https://astral.sh/uv/install.sh | sh). Anahtar gerektiren tek şey EVDS: evds3.tcmb.gov.tr'den ücretsiz API anahtarı alın (Benim Sayfam → Kayıt → Profilim → API Key). TÜİK, BDDK ve HMB araçlarının hiçbiri anahtar istemez.

En kolay yol — hazır hosted sunucuya bağlanmak

Kurulum gerektirmez, hiçbir platformda uvx/Python derdi yok. Sunucu zaten https://turkiye-veri-mcp.onrender.com/mcp adresinde çalışıyor. TÜİK, BDDK ve HMB araçları herkes için anahtarsız çalışır. EVDS araçları için dört platformun (Claude Code, Claude Desktop, claude.ai, Cursor) desteği farklı — aşağıda platform platform, hangisinin kendi anahtarınızı kullanmanıza izin verdiği net yazıyor.

Claude Code (Mac ve Windows) — kendi EVDS anahtarınızla

claude mcp add-json turkiye-veri '{"type":"http","url":"https://turkiye-veri-mcp.onrender.com/mcp","headers":{"X-Evds-Api-Key":"ANAHTARINIZ"}}'

Bu komut hem Mac'te hem Windows'ta (PowerShell dahil) harfi harfine aynı şekilde çalışır — claude mcp add --transport http ... --header ... biçimini kasıtlı kullanmadık, çünkü o komutta iki bilinen sorun var: Windows'ta -- sonrası parametreleri yanlış ayrıştırma hatası (anthropics/claude-code#15077) ve header'ın bazen sessizce kaydedilmediği ayrı bir hata (anthropics/claude-code#17069). add-json tek parça JSON aldığı için ikisini de atlıyor.

Kurulumdan sonra doğrulayın:

claude mcp list

turkiye-veri karşısında ✔ Connected görmelisiniz. Emin olamıyorsanız ~/.claude.json (Windows'ta %USERPROFILE%\.claude.json) dosyasını açıp headers alanının gerçekten yazıldığını kontrol edin.

Sunucu sahibinin paylaşılan kotasıyla bağlanmak için (kendi anahtarınızı hiç girmeden, ör. bir arkadaşınız zaten kendi anahtarıyla hosted sunucuyu çalıştırıyorsa):

claude mcp add-json turkiye-veri '{"type":"http","url":"https://turkiye-veri-mcp.onrender.com/mcp"}'

Bu, Mac'te doğrulanan add-json komutuyla aynı sözdizimi — sadece headers alanı çıkarılmış hali (o kısım ayrıca çalıştırılıp test edilmedi ama aynı kalıp olduğu için çalışması beklenir).

Claude Desktop — paylaşılan kota (kolay) ya da kendi anahtarınız (ek araç gerekir)

claude_desktop_config.json dosyası uzak (URL) sunucuları doğrudan kabul etmiyor — Desktop'ta iki yol var:

Kolay yol (paylaşılan kota): Uygulama içinde Settings → Connectors → Add custom connector ile https://turkiye-veri-mcp.onrender.com/mcp adresini ekleyin. EVDS araçları sunucu sahibinin anahtarını kullanır.

Kendi anahtarınızla (Node.js gerektirir): mcp-remote köprüsüyle claude_desktop_config.json'a ekleyin:

{
  "mcpServers": {
    "turkiye-veri": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://turkiye-veri-mcp.onrender.com/mcp", "--header", "X-Evds-Api-Key: ANAHTARINIZ"]
    }
  }
}

Claude web (claude.ai) — yalnızca paylaşılan kota

claude.ai'nin connector arayüzü şu anda özel header desteklemiyor (Anthropic'in kendi deposunda açık bir özellik talebi: anthropics/claude-ai-mcp#10). Yani web'den bağlananlar kendi EVDS anahtarını veremez, otomatik olarak sunucu sahibinin kotasını kullanır. Settings → Connectors → Add custom connector ile yalnızca URL'yi eklemeniz yeterli:

https://turkiye-veri-mcp.onrender.com/mcp

Cursor — paylaşılan kota ya da kendi EVDS anahtarınız

Cursor, MCP sunucularını bir mcp.json dosyasından okur: yalnızca o projede kullanmak için proje klasöründe .cursor/mcp.json, tüm projelerde kullanmak için ev dizininizde ~/.cursor/mcp.json (Windows'ta %USERPROFILE%\.cursor\mcp.json). İkisi birleştirilir; aynı ad ikisinde de varsa proje dosyası geçerli olur. Uzak (URL) sunucular url alanıyla eklenir, ek araç gerekmez.

Paylaşılan kota (anahtarsız): TÜİK, BDDK ve HMB araçları çalışır; EVDS araçları sunucu sahibinin anahtarını kullanır.

{
  "mcpServers": {
    "turkiye-veri": {
      "url": "https://turkiye-veri-mcp.onrender.com/mcp"
    }
  }
}

Kendi EVDS anahtarınızla: Cursor uzak sunucular için headers alanını destekliyor; anahtarınızı X-Evds-Api-Key başlığıyla gönderin.

{
  "mcpServers": {
    "turkiye-veri": {
      "url": "https://turkiye-veri-mcp.onrender.com/mcp",
      "headers": {
        "X-Evds-Api-Key": "ANAHTARINIZ"
      }
    }
  }
}

Proje dosyası git'e gidecekse anahtarı dosyaya yazmak yerine "X-Evds-Api-Key": "${env:EVDS_API_KEY}" yazıp anahtarı ortam değişkeni olarak tanımlayabilirsiniz (Cursor headers içindeki ${env:...} değişkenlerini çözer; değişkeni tanımladıktan sonra Cursor'ı yeniden başlatın).

Dosyayı kaydedip Cursor'ı yeniden başlatın. Bağlantıyı kontrol etmek için kenar çubuğunda Customize → MCPs bölümünü açın: turkiye-veri listede görünmeli ve anahtarı açık olmalı; sohbette ajan araçları (tuik_*, evds_* …) kullanabilmeli. Görünmüyorsa Output panelini açıp (Mac'te Cmd+Shift+U, Windows'ta Ctrl+Shift+U) açılır listeden MCP Logs'u seçin; bağlantı ve kimlik hataları orada yazar. Yanlış bir EVDS anahtarı bağlantıyı bozmaz: TÜİK/BDDK/HMB araçları çalışır, EVDS araçları "EVDS rejected the API key (HTTP 401)" hatası verir.

Hosted sunucu Render'ın ücretsiz katmanında çalışıyor: bir süre kullanılmayınca uykuya geçer, bu yüzden boşta kaldıktan sonraki ilk bağlantı bir dakikaya kadar sürebilir. İlk denemede zaman aşımı görürseniz biraz bekleyip tekrar deneyin.

Yerel alternatif (uv gerektirir): Sunucuyu kendi bilgisayarınızda stdio ile çalıştırmak için anahtarı env alanında verin:

{
  "mcpServers": {
    "turkiye-veri": {
      "type": "stdio",
      "command": "uvx",
      "args": ["--from", "git+https://github.com/ahmthamza/turkiye-veri-mcp", "turkiye-veri-mcp"],
      "env": {
        "EVDS_API_KEY": "ANAHTARINIZ"
      }
    }
  }
}

(Bu yapılandırma örnekleri Cursor'ın belgelerine göre yazıldı ve hosted sunucunun başlıklı/başlıksız bağlantısı gerçek bir MCP istemcisiyle doğrulandı; Cursor'ın kendisi içinde ayrıca denenmedi.)

Kendi bilgisayarınızda çalıştırmak (yerel kurulum)

Hosted sunucuyu kullanmak istemiyorsanız — ör. tamamen kendi EVDS kotanızı izole etmek için — uvx ile yerel kurulum hâlâ mümkün:

claude mcp add -e EVDS_API_KEY=ANAHTARINIZ turkiye-veri -- uvx --from git+https://github.com/ahmthamza/turkiye-veri-mcp turkiye-veri-mcp

Windows'ta bu komut -- hatasına takılırsa, .bat sarmalayıcı çözümü:

@echo off
set EVDS_API_KEY=ANAHTARINIZ
uvx --from git+https://github.com/ahmthamza/turkiye-veri-mcp turkiye-veri-mcp

Dosyayı ör. C:\turkiye-veri-mcp\run_turkiye.bat olarak kaydedip:

claude mcp add turkiye-veri C:\turkiye-veri-mcp\run_turkiye.bat

Örnek kullanım

TÜİK'te aylık işgücü veri akışını bul, kadınlar için işsizlik oranını 2014'ten itibaren çek.
EVDS'den USD/TRY'nin son 30 gözlemini getir; TÜFE'yi yıllık yüzde değişimle 2010'dan bugüne tufe.csv olarak kaydet.
BDDK'dan İstanbul'daki kamu bankalarının kredi hacmini 2020-3'ten 2026-9'a çeyreklik seri olarak çek.
BDDK Aylık Bülten'den sektörün takipteki alacaklarını son 24 ay için getir.
HMB'den Ankara'nın (il kodu 06) bu yılki bütçe gelirini aylık olarak göster.
1998 yılı için illere göre konsolide bütçe giderlerini karşılaştır, en yüksek 10 ili sırala.

Teknik notlar

  • TÜİK: veri akışları databrowser2.tuik.gov.tr'nin (TÜİK'in kendi veri tarayıcısının arka ucu) yapı, kod listesi ve SDMX-CSV indirme uçlarından gelir; eski nsiws.tuik.gov.tr servisi (HTTP 401) kullanılmaz. Her indirme TÜİK'in bildirdiği gözlem sayısıyla karşılaştırılır. Portal istab indirmelerini istemci başına 5 saniyede bir dosyayla sınırlar; araçlar bekler ve "lütfen bekleyiniz" sayfasını dosya diye kaydetmez.

  • EVDS: v3 API (evds3.tcmb.gov.tr); anahtar HTTP başlığında gönderilir, TCMB'nin gerektirdiği legacy SSL ayarı otomatik uygulanır. EVDS her yanıtı 1000 satırla sınırlar ve en yeni 1000'i sessizce döndürür; istemci geriye doğru sayfalayıp birleştirir.

  • BDDK: bültenlerin kendi arayüzlerinin kullandığı uçlar. Tablo, grup, dönem ve para birimi listeleri sayfalardan canlı okunur; gelen her yanıt istenen dönem/grup/tabloyla karşılaştırılır. TLS doğrulaması hiçbir koşulda kapatılmaz. İstekler arası 0,8 sn bekleme, çağrı başına 55 sn üst sınır.

  • HMB: muhasebat.hmb.gov.tr/portal/v2 (sayfa ağacı + dosya listeleme). Klasör kimlikleri çalışma anında siteden keşfedilir; yeni yıllar kod değişikliği olmadan görünür. Birim etiketi olmayan dosyalar yalnızca kardeş bir tabloyla doğrulanabiliyorsa kabul edilir.

  • Hata mesajları: MCP SDK 2.x, ToolError olmayan istisnaların metnini gizler; tüm araç hataları ToolError'a çevrilerek kullanıcıya iletilir.

  • Büyük veri: barındırılan küçük sunucularda bellek için TUIK_MAX_OBSERVATIONS ortam değişkeniyle TÜİK indirme sınırı düşürülebilir (varsayılan 2 milyon gözlem; render.yaml'da 300 bin).

  • Endpoint keşfinde Emrah Er'in tuikr R paketinden ve Fatih Mete'nin evds Python paketinden (her ikisi MIT) yararlanılmıştır. TÜİK DataBrowser2, BDDK ve HMB uçları tarayıcı DevTools ile keşfedilmiştir; dokümante bir kaynakları yoktur ve kurumlar arayüzlerini değiştirirse bozulabilir.

Testler

uv pip install pytest
pytest -m "not live"     # çevrimdışı birim testleri
pytest                    # + canlı testler (internet; EVDS için EVDS_API_KEY)

Lisans

MIT

Bilinen sınırlar

  • TÜİK: katalogdaki 515 veri akışının 508'i canlı doğrulandı; DF_UGOC_T1–T6 ve T8 için TÜİK sunucusunda veri yok. Önizleme 300 bin, indirme 2 milyon gözlemle sınırlı.

  • TÜİK istab tidy'leme best-effort'tur. Katalogdaki 1.746 tablonun indirilen 1.700'ünde ölçüldü: 459 yüksek, 1.152 orta, 19 kısmi güvenle çevrildi; 70'i (aynı etiketle iki farklı sayı veren 57 tablo, sayısal verisi olmayan 13 dosya) açık hatayla reddedildi. "yüksek" yalnızca yapısı tablonun kendisinden kurulan düz tablolar içindir; "orta" tablolarda yapı ya da dönem çıkarımla kurulmuştur ve neyin varsayıldığı yapi_cikarimi/varsayimlar alanlarında yazar. Kaynak hücreye kadar izlenen değerlerin %87'si tam doğrulandı; kalanlar yalnızca orta/kısmi tablolarda ve notla döner. 46 tablo ölçülmedi. Ham dosya her zaman tuik_download_table_file ile alınabilir.

  • MEDAS/Biruni veritabanları (100 kayıt) yalnızca bağlantı olarak listelenir: durum tutan bir web arayüzü, veri API'si yok.

  • TÜİK mikroverisi kapsam dışıdır (kurumsal başvuruyla dağıtılır).

  • EVDS: sunucu tarafı seri araması ve "son N gözlem" ucu yoktur; ikisi de istemci tarafında yapılır. evds_search_series dizini ilk kullanımda arka planda kurulur (yaklaşık 8 dakika), 7 günde bir yenilenir; dizin hazır değilken eşleşen veri grupları döner.

  • BDDK: Günlük Bülten'in geçmişi yayımlanmıyor (yalnızca son gün ve kalem başına son ~7 iş günü). Kredi kartı ücretleri bülteni (banka bazında ücret bilgisi) ve "Üç Aylık Temel Göstergeler" bağlı değil. FinTürk altın tablosu 2015-9'da başlar. Aylık Bülten'de 6 tablo yalnızca TL'dir.

  • HMB: hmb_get_file il dışı 4.360 dosyanın 4.008'ini doğrulayarak tabloya çevirir; kalan 352 dosya yalnızca ham dosya olarak iner: 137 PDF, birimi doğrulanamayan 73 dosya, 55 revizyon ölçüm tablosu, kendi toplamları tutmayan 39 mizan/bilanço ve dönemi/yılı belirsiz küçük gruplar. Altında ikinci bir tablo bulunan 19 "Önceki Yılla Karşılaştırmalı" denge dosyasında alttaki tablo okunmaz (uyarı verilir). Yayımcı hataları (ör. 2007 İl Özel İdareleri Mali Varlık "Ocak-Mart" sütunu 10 kat) dosyadaki gibi döner. İl dosyalarının toplamı ile Merkezi Yönetim il tablosu 2006'dan itibaren %0,3–1,3 farklıdır (HMB'nin iki ayrı yayını).

  • Hosted (paylaşılan) sunucuda EVDS anahtarı platforma göre değişir. Claude Code ve Cursor'da X-Evds-Api-Key başlığıyla kendi anahtarınızı gönderebilirsiniz (bkz. Kurulum). Claude web (claude.ai) özel başlık desteklemediği için web'den bağlananlar sunucu sahibinin kotasını paylaşır; yoğun/toplu sorgulardan kaçının.

  • Hosted sunucuda output_path sunucunun diskine yazar, sizin bilgisayarınıza değil; dosya çıktısı için yerel kurulum kullanın.

Kullanım istatistikleri

Barındırılan sunucu (turkiye-veri-mcp.onrender.com) kaba bir kullanım sayımı tutar. Her araç çağrısı için yalnızca zaman damgası ve araç adı kaydedilir. HTTP üzerinden gelen bağlantılarda ayrıca istemcinin kendini tanıttığı ad ve sürüm (ör. "claude-code 2.x") ile anonim bir ziyaretçi kimliği tutulur. Bu kimlik, IP adresinizin gizli bir tuzla alınmış ve kısaltılmış HMAC-SHA256 özetidir. Ham IP adresi, EVDS anahtarınız, gönderdiğiniz sorgular ve dönen veriler hiçbir zaman kaydedilmez ve günlüğe yazılmaz. X-Evds-Api-Key başlığı gönderirseniz, farklı anahtar sahiplerini saymak için anahtarın da yalnızca aynı şekilde özeti tutulur.

Toplu sayılar (kimlik ya da özet içermez) iki yerden görülebilir: usage_stats aracı ve herkese açık /stats adresi (/stats?days=30). Oturum sayısı, tekil ziyaretçi (toplam, gün gün ve istemci başına), istemci türü dağılımı ve araç bazında çağrı sayıları döner. İki istemci kullanan bir ziyaretçi her ikisinde de sayılır.

Bu sayılar bir tahmindir, kişi sayımı değildir: claude.ai bağlayıcıları Anthropic sunucuları üzerinden geldiği için birçok kişi aynı IP'yi paylaşabilir; tek kişi farklı ağlardan bağlanırsa birden çok sayılır; kendi bilgisayarında stdio ile çalıştıranların kullanımı bu sunucuya hiç ulaşmaz. Render ücretsiz katmanında disk kalıcı olmadığı için kayıt yeniden başlatmada sıfırlanır.

Ek kaba göstergeler: GitHub → repo → Insights → Traffic (ziyaretçi/klon sayısı) ve Render dashboard → Metrics (HTTP istek sayısı).

Yeni veri ve yeni seriler

Kod hiçbir seri veya tablo listesi barındırmaz; kataloglar her seferinde kaynaktan sorgulanır. Bu nedenle:

  • Mevcut bir serinin yeni gözlemi (ör. yeni ay TÜFE'si) bir sonraki çağrıda gelir.

  • Yeni eklenen seri/tablo/tema kod değişikliği olmadan görünür; katalog önbellekleri en fazla 1 saatlik, EVDS arama indeksi en fazla 7 günlüktür.

  • Kod değişikliği yalnızca kaynak yapısını değiştirirse gerekir — TÜİK portal adreslerini değiştirirse, bir dataflow kaldırılırsa ya da istab dosyaları yeni bir şablonla yayınlanmaya başlarsa. Bu durumda tuik_get_table_data sessizce yanlış veri döndürmez, hata verip ham dosyaya yönlendirir.

Kapsam denetimi

Kaynaklarda ne olduğu ve MCP'nin ne kadarını sunduğu iddia değil, ölçümdür. Canlı sayım için:

turkiye-veri-audit            # COVERAGE.md üretir

Rapor, TÜİK portalındaki tüm kaynakları üç erişim katmanına ayırıp tema tema sayar (A: SDMX tidy, B: istab dosya, C: MEDAS/Biruni — yalnızca link) ve EVDS'nin kategori/veri grubu/seri toplamlarını canlı API'den doğrular. Portallar değiştikçe raporu yeniden üretin.

istab sondası

istab katmanının ne kadarının tidy'lenebilir olduğunu ölçmek için:

turkiye-veri-probe --per-theme 8   # ISTAB_PROBE.md üretir

Tema başına örneklem indirip dosyaları yapılarına göre sınıflandırır (clean / multiheader / multisheet / crosstab / nontabular) ve parser yazıldığı takdirde ulaşılabilecek tavanı raporlar.

Available Tools

16 tools
evds_categoriesA

List TCMB EVDS main categories (exchange rates, interest rates, inflation, balance of payments, surveys...).

Args: lang: 'TR' or 'ENG'.

Inputs: lang. Returns: result

evds_datagroupsA

List or search EVDS datagroups (thematic bundles of series).

Provide category_id to list one category's datagroups, query to search all datagroup names, or neither to list everything (truncated).

Args: category_id: A category id from evds_categories (optional). query: Substring to search in datagroup names (optional). lang: 'TR' or 'ENG'.

Inputs: lang, query, category_id. Returns: result

evds_download_dataA

Fetch EVDS series and write them as a tidy CSV file (for analysis pipelines). Same parameters as evds_get_data.

Args: series: EVDS series codes. start: Start date (dd-mm-yyyy or yyyy-mm-dd). output_path: Where to write the CSV (e.g. 'data/usd_try.csv'). end: End date (defaults to start). frequency: Target frequency name or code 1-8. aggregation: avg/min/max/first/last/sum. formula: Transformation name or code 0-8.

Inputs: start (required), series (required), output_path (required), end, +3 more. Returns: result

evds_get_dataA

Fetch one or more EVDS series with full API features and preview in chat.

Args: series: EVDS series codes, e.g. ['TP.DK.USD.A.YTL', 'TP.FG.J0']. start: Start date (dd-mm-yyyy or yyyy-mm-dd). end: End date (defaults to start). frequency: Target frequency: gunluk/isgunu/haftalik/ayda2/aylik/ ceyreklik/altiaylik/yillik (or codes 1-8). Empty = series default. aggregation: How to aggregate when reducing frequency: avg, min, max, first, last, sum. formula: Transformation: duzey, yuzde_degisim, fark, yillik_yuzde, yillik_fark, yilsonu_yuzde, yilsonu_fark, hareketli_ortalama, hareketli_toplam (or codes 0-8). Empty = level. max_rows: Rows in the preview (default 50).

Inputs: start (required), series (required), end, formula, +3 more. Returns: result

evds_get_datagroup_dataA

Fetch every series in an EVDS datagroup at once (auto-chunked).

Mirrors the website's 'download the whole datagroup' action. Large groups and long spans are split into several requests and stitched back together, so EVDS response limits do not silently truncate the result.

Args: datagroup_code: Datagroup code from evds_datagroups (e.g. 'bie_dkdovytl'). start: Start date (dd-mm-yyyy or yyyy-mm-dd). output_path: Optional CSV path for the full table. end: End date (defaults to start). frequency: Target frequency name or code 1-8. aggregation: avg/min/max/first/last/sum. formula: Transformation name or code 0-8. max_rows: Rows in the preview (default 30).

Inputs: start (required), datagroup_code (required), end, formula, +4 more. Returns: result

evds_search_seriesA

Search EVDS series by name across every datagroup.

EVDS has no server-side series search, so the first call walks all datagroups once (a few minutes) and caches the index locally; later searches are instant. Multiple words are ANDed.

Args: query: Words to look for, e.g. 'konut fiyat' or 'issizlik'. lang: 'TR' or 'ENG'. limit: Maximum hits to return (default 50). refresh: Rebuild the index now instead of using the cache. The index also rebuilds itself automatically once it is a week old, so newly published TCMB series appear without any manual step.

Inputs: query (required), lang, limit, refresh. Returns: result

evds_series_listA

List all series in an EVDS datagroup with codes and start dates.

Args: datagroup_code: Datagroup code from evds_datagroups (e.g. 'bie_dkdovytl'). lang: 'TR' or 'ENG'.

Inputs: datagroup_code (required), lang. Returns: result

tuik_describe_dataflowA

Describe a TUIK SDMX dataflow: dimensions, codelists, key template.

Use before tuik_get_data when a dataflow refuses key='ALL' or to build a narrower key. The SDMX key joins one code per non-time dimension with dots, in position order; an empty slot means 'all' (e.g. 'TR..2021').

Args: dataflow_id: Three-part SDMX id, e.g. 'TR,DF_ADNKS_T26,1.0'. lang: Label language for codelists ('tr' or 'en').

Inputs: dataflow_id (required), lang. Returns: result

tuik_download_dataA

Download a full TUIK SDMX dataset and write it as a tidy CSV file.

Args: dataflow_id: Three-part SDMX id, e.g. 'TR,DF_ADNKS_T26,1.0'. output_path: Where to write the CSV (e.g. 'data/adnks_t26.csv'). key: SDMX key path ('ALL' or dot-separated codes). start: Optional start period. end: Optional end period.

Inputs: dataflow_id (required), output_path (required), end, key, +1 more. Returns: result

tuik_download_table_fileA

Download an 'istab' table file (usually Excel) from the TUIK portal.

Args: url: The url field of an istab row from tuik_list_tables/tuik_search_tables. output_path: Where to save the file (e.g. 'data/table.xlsx').

Inputs: url (required), output_path (required). Returns: result

tuik_get_dataA

Fetch observations from a TUIK SDMX dataflow (all dimensions, full time span unless narrowed) and preview them in chat.

Args: dataflow_id: Three-part SDMX id, e.g. 'TR,DF_ADNKS_T26,1.0'. key: SDMX key path ('ALL' or dot-separated codes like 'TR..2021'). start: Optional start period (e.g. '2010' or '2020-01'). end: Optional end period. max_rows: Rows to include in the preview (default 50).

Inputs: dataflow_id (required), end, key, start, +1 more. Returns: result

tuik_get_table_dataA

Download an 'istab' Excel table and convert it to tidy long format.

Handles TUIK's common layouts (title/footnote rows, year-per-sheet workbooks, crosstabs with label columns and period headers). Output columns: the table's own label columns plus 'donem' and 'deger'. Layouts vary, so check tidy_confidence; tuik_download_table_file always gets you the raw file instead.

Args: url: The url field of an istab row from tuik_list_tables/tuik_search_tables. output_path: Optional CSV path; if given, the tidy table is written there. max_rows: Rows to include in the preview (default 50).

Inputs: url (required), max_rows, output_path. Returns: result

tuik_list_tablesA

List tables under a TUIK theme: SDMX 'dataflow' entries (use dataflow_id with tuik_get_data/tuik_download_data) or 'istab' file downloads (use url with tuik_download_table_file).

Args: theme_id: Theme id from tuik_list_themes (e.g. '11'). lang: 'tr' or 'en'. resource_type: 'dataflow', 'istab', 'database' (legacy MEDAS/Biruni, link only), or 'all' (default: all three).

Inputs: theme_id (required), lang, resource_type. Returns: result

tuik_list_themesA

List TUIK statistical themes (top-level categories) with their ids.

Args: lang: 'tr' for Turkish names, 'en' for English.

Inputs: lang. Returns: result

tuik_search_tablesA

Search TUIK table names across all themes (case-insensitive substring).

Args: query: Search text, e.g. 'işgücü' or 'tüketici fiyat'. lang: Language of table names to search in ('tr' or 'en').

Inputs: query (required), lang. Returns: result

usage_statsA

Show how much this MCP server has been used (this instance's log).

Counts tool calls, not people: one session calling several tools logs several lines. On a hosted free-tier deployment the count resets on redeploy/restart, so treat it as a rough activity signal, not a durable total. Anthropic does not expose per-connector usage to server owners, so this local counter is the closest available substitute.

Args: days_recent: Size of the "recent" window in days (default 7).

Inputs: days_recent. Returns: result

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 16 tools

    Disambiguation4/5

    The tools are mostly distinct, with clear separation between TUIK and EVDS domains. The main potential confusion is between get_data and download_data variants, but descriptions clarify preview vs. file output. Some similar names like tuik_get_data vs. tuik_get_table_data could cause misselection, but the underlying resources differ (SDMX vs. istab).

    Naming Consistency4/5

    TUIK tools follow a consistent verb_noun pattern (list_*, search_*, describe_*, get_*, download_*). EVDS tools mix noun-only names (categories, datagroups) with verb_noun names (search_series, get_data, download_data), and 'series_list' is a noun phrase. This is a minor inconsistency that does not severely hinder readability.

    Tool Count4/5

    With 16 tools, the server is slightly above the typical 3-15 range, but the breadth of functionality for two distinct national statistical data sources justifies the count. Each tool serves a specific purpose, and none are redundant, though a few could arguably be consolidated.

    Completeness5/5

    The server delivers end-to-end coverage for both TUIK and EVDS: discovery (categories/themes/datagroups), search, metadata (dataflow description), and multiple retrieval formats (preview, CSV download, raw files). No major operations are missing for a read-only statistical data access server.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Provides access to Turkish Central Bank (TCMB) exchange rates with current and historical data since 1996, currency conversion, rate history statistics, and multi-currency comparisons with smart caching.
      6
      1
      MIT
    • 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.
      6
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables querying TÜİK (Turkish Statistical Institute) indicators via 92 topics and 400+ indicators, with cached metadata for fast responses and optional live download of real Excel reports through a Playwright-powered ZK Widget API.
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables browsing, searching, and pulling time series from Statistics Korea's KOSIS database, covering ~100,000 tables on population, prices, employment, trade, and industry.
      93 npm
      MIT