turkiye-veri-mcp
This server provides a unified MCP interface to access official Turkish statistical data from TÜİK (Turkish Statistical Institute) and TCMB EVDS (Central Bank Electronic Data Delivery System), with comprehensive search, retrieval, transformation, and export capabilities.
TÜİK Data (no API key required): Browse 19 statistical themes and their tables, search table names, describe SDMX dataflows (dimensions/codelists), preview and download SDMX datasets as tidy CSV, download 'istab' Excel files, and convert complex Excel layouts into tidy long format.
TCMB EVDS Data (free API key required): List main categories, explore datagroups, search ~52,000 series by name with local caching, list series within datagroups, fetch all series in a datagroup with auto-chunking, and retrieve multiple series with frequency conversion, aggregation (avg/min/max/first/last/sum), and formula transformations (percent change, year-over-year, difference, moving average/sum). Export any series as tidy CSV.
Utilities: View tool call usage statistics for the server instance.
General Features: All catalogs are fetched live (no hardcoded lists) so new data appear automatically. Supports both Turkish and English for labels and search. Data can be exported in tidy CSV format ready for analysis pipelines.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@turkiye-veri-mcp Download USD/TRY monthly average exchange rate from EVDS as CSV."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
istabExcel 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 |
| 19 istatistik temasını listeler |
| Temadaki tabloları listeler ( |
| Tüm temalarda arama: Türkçe karakter duyarsız ( |
| Veriyi indirmeden boyutları, verisi olan kodları (tr/en etiketli), dönem aralığını ve gözlem sayısını verir |
| Veri akışını önizler; |
| Aynı seçimi tidy CSV olarak yazar |
|
|
|
|
| Bu sunucu örneğinin araç çağrısı sayacı |
EVDS (ücretsiz EVDS_API_KEY gerekir):
Araç | Ne yapar |
| Kategori ağacı (3 düzey) |
| Veri gruplarını listeler/arar (sayfalı; birim, kaynak, son güncelleme) |
| Bir veri grubundaki serileri kodlarıyla listeler (sayfalı) |
| Seri üst verisi: birim, frekans, ilk/son gözlem, varsayılan agregasyon, kaynak |
| Seri adına/koduna göre arama (TR+EN, Türkçe karakter duyarsız; dizin arka planda kurulur) |
| Bir veri grubunun tüm serilerini tek seferde çeker |
| Çoklu seri; frekans + agregasyon + formül, |
| Aynı parametrelerle CSV yazar |
BDDK (anahtar gerektirmez):
Araç | Ne yapar |
| 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 |
| FinTürk il bazında veri: 7 tablo × 7 grup × 81 il + yurt dışı, 2007-12'den bugüne çeyreklik; |
| Aylık Bülten'in 17 tablosu (bilanço, kâr-zarar, krediler, mevduat, sermaye yeterliliği, rasyolar…), TL/USD |
| Haftalık Bülten'in 9 tablosu (2014'ten bugüne) |
| Haftalık Bülten'de tek kalemin zaman serisi |
| Günlük Bülten'in son günü; tek kalemin son ~7 iş günü |
| Finansal kiralama, faktoring, finansman ve varlık yönetim şirketleri |
HMB (anahtar gerektirmez):
Araç | Ne yapar |
| İl bazında genel bütçe geliri (Tahakkuk/Tahsilat), aylık kümülatif, 2004'ten bugüne — |
| İl × kategori bütçe tabloları: |
| Genel bütçe vergi gelirlerinden mahalli idare ve fonlara aktarılan paylar |
| Muhasebat sitesindeki tüm istatistik bölümlerini, klasörleri ve dosyaları gezer |
| Herhangi bir HMB dosyası: mizan, bilanço, borç, bütçe tabloları vb. doğrulanarak tidy tabloya çevrilir; doğrulanamayan gerekçesiyle reddedilir ve |
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 listturkiye-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/mcpCursor — 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-mcpWindows'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-mcpDosyayı ö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; eskinsiws.tuik.gov.trservisi (HTTP 401) kullanılmaz. Her indirme TÜİK'in bildirdiği gözlem sayısıyla karşılaştırılır. Portalistabindirmelerini 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,
ToolErrorolmayan 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_OBSERVATIONSortam 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–T6veT8iç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/varsayimlaralanları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 zamantuik_download_table_fileile 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_seriesdizini 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_fileil 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-Keybaş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_pathsunucunun 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_datasessizce 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 üretirRapor, 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 üretirTema 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 toolsevds_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
Scored across 16 tools
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).
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.
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.
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
Anahtarsız Türkiye verisi (TÜİK, TCMB), 81 il, ham seriler; Ortak Alan yazıları ve kurlar.
Unofficial access to CBRT/TCMB daily exchange rates: latest, history since 1996, conversion.
Search and query 1,500+ OECD statistical datasets via SDMX. Keyless.
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.
Related MCP Servers
- AlicenseBqualityDmaintenanceProvides 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.61MIT
- AlicenseAqualityDmaintenanceEnables querying Turkish economic data (inflation, FX rates, policy rates, etc.) from TCMB EVDS via curated tools, preventing LLM hallucination.6MIT
- FlicenseNot gradedqualityDmaintenanceEnables 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.-
- AlicenseNot gradedqualityCmaintenanceEnables browsing, searching, and pulling time series from Statistics Korea's KOSIS database, covering ~100,000 tables on population, prices, employment, trade, and industry.93 npmMIT