zam-hesap-mcp

Claude'a "emekli maaşım Temmuz'da ne kadar olur?" diye sorduğunuzda tahmin değil, kuruşu kuruşuna hesap.

Türkiye'de maaş, asgari ücret, emekli ve memur zammı, kıdem-ihbar tazminatı, yıllık izin ve fazla mesai hesaplarını yapan bir MCP sunucusu. Claude Desktop, Claude Code, Cursor ve MCP destekleyen diğer yapay zekâ asistanlarıyla çalışır.

⚠️ Sonuçlar bilgilendirme amaçlıdır, resmi bordro veya SGK hesabı yerine geçmez.

Neden?

Yapay zekâ modelleri Türk vergi ve SGK hesaplarında sık hata yapar: vergi dilimleri kümülatif, asgari ücret istisnası her ay değişir, oranlar yılda bir-iki kez güncellenir. Bu sunucu hesabı modele bırakmaz; model araçları çağırır, rakamlar koddan gelir.

Neler hesaplanıyor?

Araç	Ne yapar
brutten_nete	Brüt ücretten net ücret (SGK, işsizlik, gelir ve damga vergisi, asgari ücret istisnası); çalışan emekli (SGDP), engellilik indirimi, BES ve sendika aidatı dahil
netten_brute	İstenen net ücret için gereken brüt ücret
yillik_bordro	12 aylık bordro tablosu ve yıllık toplamlar
isveren_maliyeti	Brüt ücretin işverene maliyeti (teşviksiz / 2 puan / imalat 5 puan / emekli çalışan SGDP)
asgari_ucret	Asgari ücretin brüt, net ve işveren maliyeti
asgari_ucret_senaryosu	"%25 zam gelirse?" gibi senaryolar: birden çok oran veya açıklanan net tutar için brüt, net, işveren maliyeti
emekli_zammi	SSK / Bağ-Kur emeklisinin zamlı aylığı; en düşük aylık desteği alanlar için asıl aylık üzerinden hesap
emekli_zam_senaryosu	Gelecek emekli zammı için karşılaştırma: "%10, %15, %20 gelirse?"
memur_maasi	Unvana göre memur maaşı (şimdilik öğretmen, uzman öğretmen, başöğretmen): derece/kademe, kıdem, aile yardımı, 5510/5434 kesintileri ile kalem kalem brüt ve net
memur_zammi	Memur maaşı ve memur emeklisi (4/c) zammı
memur_zam_senaryosu	Gelecek memur zammı: oranlarla ya da toplu sözleşme + enflasyon senaryolarıyla (enflasyon farkı dahil)
tis_zammi	Belediye, kamu veya özel sektör işçisinin toplu sözleşme zammı: yeni brüt ve net
kamu_isci_protokolu	Kamu işçisi çerçeve protokolü zam oranları
kumulatif_enflasyon	Aylık enflasyonlardan birikimli oran (zam tahmini için)
kidem_tazminati	Kıdem tazminatı (tavan, küsurat, damga vergisi); ileri tarihli çıkış için tahmini tavan
ihbar_tazminati	İhbar süresi ve tazminatı (gelir ve damga vergisi dahil)
hizmet_suresi	İki tarih arası çalışma süresi
yillik_izin	Yıllık izin gün sayısı (yaş ve yer altı kuralları dahil)
izin_ucreti	Kullanılmayan izin ücreti, brüt ve net
fazla_mesai	Fazla mesai ücreti (%50 / %25 zamlı)
tatil_mesaisi	Bayram ve genel tatilde çalışma ek ödemesi
guncel_parametreler	Kullanılan tüm oranlar ve kaynakları

Örnek sorular

• "Emekli aylığım 21.000 TL, Temmuz zammından sonra ne kadar olur?"
• "En düşük emekli aylığını alıyorum (20.000 TL), asıl aylığım 15.000 TL. Temmuz'da ne alacağım?"
• "Brüt 50.000 TL maaşın Ocak ve Aralık'taki neti ne?"
• "Eline net 60.000 TL geçmesi için brüt kaç olmalı?"
• "Emekliyim ama asgari ücretle çalışıyorum, elime ne geçer? İşverene maliyetim ne?"
• "2. derece engelliyim, brüt 50.000 TL maaşım var, engellilik indirimiyle netim ne olur?"
• "Maaşımdan BES kesiliyor, brüt 60.000 TL, elime net ne geçer?"
• "Bordrom doğru mu? Kasım 2023, ücret kazançları 20.328,30 TL, kümülatif matrah 160.107,36 TL"
• "Asgari ücretli bir çalışanın işverene maliyeti ne?"
• "Asgari ücrete %25, %30 ya da %35 zam gelirse net ne olur?"
• "Enflasyon önümüzdeki 6 ay ayda %2 olursa emekli zammı yüzde kaç olur?"
• "Memurum, net maaşım 62.000 TL, Temmuz zammıyla ne olur?"
• "7/1 derecede, 6 yıllık öğretmenim, 2010'da başladım, evliyim eşim çalışmıyor, 1 çocuğum var. Maaşım kalem kalem ne?"
• "Uzman öğretmen olursam maaşım ne kadar artar?"
• "Ocak'ta enflasyon %8, %10 ya da %12 çıkarsa memur zammı ne olur? Toplu sözleşme %5, önceki dönem %7."
• "Emekli aylığım 25.000 TL, Ocak'ta %10, %13, %15 zam gelirse ne alırım?"
• "Belediyede işçiyim, brüt 40.000 TL, TİS'te %10 ve %6 zam var, yeni netim ne?"
• "2019 Mart'ta girdim, bu ay çıkarıldım, giydirilmiş brütüm 55.000 TL. Kıdem ve ihbar ne kadar?"
• "8 yıllık çalışanım, kaç gün yıllık iznim var?"

Kurulum

uv kurulu olmalı.

Claude Desktop

claude_desktop_config.json dosyasına ekleyin (Windows: %APPDATA%\Claude\claude_desktop_config.json, macOS: ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "zam-hesap": {
      "command": "uvx",
      "args": ["zam-hesap-mcp"]
    }
  }
}

Claude Desktop'ı yeniden başlatın. Microsoft Store'dan kurulan Claude'da dosya %LOCALAPPDATA%\Packages\Claude_...\LocalCache\Roaming\Claude\claude_desktop_config.json konumundadır; en kolayı Claude'da Ayarlar → Developer → Edit Config ile açmaktır.

Güncelleme için: uv cache clean zam-hesap-mcp ve Claude'u yeniden başlatın.

Claude Code

claude mcp add zam-hesap -- uvx zam-hesap-mcp

Gerçek bordroyla doğrulama

Hesaplar gerçek işyeri bordrolarıyla kalem kalem karşılaştırılmıştır (yalnızca tutarlar):

Kalem	Kasım 2023	Ağustos 2026	2026 kamu işçisi (sendikalı)
SGK işçi	2.845,96 ✅	7.713,16 ✅	13.570,52 ✅
İşsizlik işçi	203,28 ✅	550,94 ✅	969,32 ✅
Gelir vergisi (istisna sonrası)	1.882,87 ✅	2.762,46 ✅	17.031,77 ✅
Damga vergisi (istisna sonrası)	52,47 ✅	167,46 ✅	485,02 ✅
Net ödenecek	15.343,72 ✅	43.900,00 ✅	62.370,31 ✅

✅ = zam-hesap sonucu bordroyla kuruşu kuruşuna aynı.

Memur (öğretmen) maaşı, gerçek bir Şubat 2026 KBS öğretmen bordrosuyla (7/1, 5510) karşılaştırılmıştır: 9 kazanç kalemi, malullük-yaşlılık ve GSS primleri ve gelir vergisi matrahı (20.698,26) birebir aynıdır. Derece/kademe, uzman/başöğretmen ve 5434 (Emekli Sandığı) senaryoları memurlar.net maaş robotunun kazanç ve kesenek tutarlarıyla da doğrulanmıştır.

Kendi bordronuzu kontrol etmek için brutten_nete aracına şunları verin:

• brut: bordrodaki SGK matrahı (ücret + yol parası gibi SGK'ya tabi ödemeler; ayni yemek hariç)
• ay ve yil
• onceki_kumulatif_matrah: "kümülatif gelir vergisi matrahı − bu ayın gelir vergisi matrahı"
• gv_istisna_tutari: gelir vergisi matrahı "SGK matrahı − SGK işçi − işsizlik işçi"den düşükse aradaki fark (ör. yol yardımı istisnası)
• sendika_aidati: bordrodaki sendika kesintisi (gelir vergisi matrahından düşülür)

Desteklenen dönemler

Veri	Değer (2026)
Asgari ücret (brüt / net)	33.030,00 TL / 28.075,50 TL
SGK işçi / işsizlik işçi	%14 / %1
SGK işveren / işsizlik işveren	%21,75 / %2
SGK tavanı	Asgari brüt × 9 = 297.270,00 TL
Gelir vergisi (ücret)	190 bin %15 · 400 bin %20 · 1,5 milyon %27 · 5,3 milyon %35 · üstü %40
Damga vergisi	‰7,59
Çalışan emekli (SGDP)	işçi %7,5 · işveren %24,75 (işsizlik primi yok)
Engellilik indirimi (aylık)	1. derece 12.000 TL · 2. derece 7.000 TL · 3. derece 3.000 TL
Otomatik BES	SGK'ya esas kazancın %3'ü (netten kesilir, vergiyi etkilemez)
Emekli zammı Ocak 2026	%12,19 (en düşük aylık 20.000 TL)
Emekli zammı Temmuz 2026	%17,76 (en düşük aylık 23.552 TL)
Memur / 4/c emekli zammı Ocak 2026	%18,60 + 1.000 TL taban aylık (en düşük 4/c aylığı 27.772 TL)
Memur / 4/c emekli zammı Temmuz 2026	%13,52 (%7 toplu sözleşme + %6,09 enflasyon farkı)
Kıdem tazminatı tavanı	Ocak–Haziran 64.948,77 TL · Temmuz–Aralık 73.729,87 TL
Kamu işçisi çerçeve protokolü	2026 ilk yarı %10 · ikinci yarı %6 (+ enflasyon farkı)
Memur katsayıları	Ocak–Haziran: 1,387871 / 22,722793 / 0,440141 · Temmuz–Aralık: 1,575512 / 25,794915 / 0,499649 (aylık / taban / yan ödeme)

Tüm değerler src/zam_hesap/veriler/2026.yaml dosyasında, kaynaklarıyla birlikte durur. Geçmiş bordroları kontrol etmek için 2023 maaş parametreleri de (2023.yaml) vardır; yıl içindeki iki asgari ücret dönemi dahil.

Varsayımlar ve sınırlar

• onceki_kumulatif_matrah verilmezse çalışanın yılbaşından beri her ay aynı brüt ücreti aldığı varsayılır.
• Yan haklar, teşvikli istihdam (işsizden istihdam vb.) ve AGİ dönemi gibi özel durumlar yoktur.
• memur_zammi net maaşa toplam oranı uygulayarak yaklaşık hesaplar; kesin hesap için memur_maasi kullanın.
• memur_maasi şimdilik öğretmen unvanlarını kapsar. Ek ders ücreti, fazla mesai, dil/makam tazminatı, lojman gibi kişiye özel ödemeler dahil değildir.
• Kıdem tazminatında küsurat ay/12 ve gün/365 olarak orantılanır. Tazminat hakkının doğup doğmadığı (istifa, haklı fesih vb.) araç tarafından değerlendirilmez.
• İhbar tazminatı ve izin ücretinde gelir vergisi, verilen kümülatif matraha göre hesaplanır (varsayılan 0, yani %15).

Yol haritası

• Memur ve memur emeklisi zammı
• Kıdem ve ihbar tazminatı
• Belediye / kamu işçisi TİS zammı
• Yıllık izin, izin ücreti, fazla mesai, tatil mesaisi
• Unvana göre memur maaşı: öğretmen, uzman öğretmen, başöğretmen
• Diğer unvanlar: polis, hemşire, genel idare memuru, zabıta…
• Engellilik indirimi, BES, SGDP (emekli çalışan)
• 2027 parametreleri (Ocak 2027'de)
• PyPI yayını (uvx zam-hesap-mcp)

Geliştirme

uv venv && uv pip install -e ".[test]"
uv run --no-sync pytest -q

Yeni bir zam döneminde yalnızca veriler/<yıl>.yaml güncellenir ve testlere o dönemin resmi örnekleri eklenir.

Hata bulursanız lütfen örnek bordro/hesapla birlikte issue açın.

Yayınlama (PyPI)

Paket PyPI'de yayındadır. Yeni sürüm için pyproject.toml sürümünü artırıp GitHub'da vX.Y.Z etiketli bir Release yayımlamak yeterlidir; publish.yml testleri çalıştırıp paketi yükler. İlk kurulumda yapılan bir kerelik ayar:

1. pypi.org hesabı açın.
2. Account → Publishing → Add a new pending publisher bölümüne şunları girin: proje adı zam-hesap-mcp, sahip iscorpitx, depo hakan-veli, workflow publish.yml, environment pypi.
3. GitHub'da Releases → Draft a new release ile vX.Y.Z etiketli bir sürüm yayımlayın. Testler geçerse paket otomatik yüklenir.

Lisans

MIT