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?

Ö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?"
• "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):

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

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

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 zammı, net maaşa toplam oranın uygulanmasıyla yaklaşık hesaplanır. Kişiye özel kalemler (aile/çocuk yardımı, vergi dilimi, Ocak 2026'daki 1.000 TL taban aylık artışı) nedeniyle gerçek tutar birkaç yüz TL farklı olabilir. Unvana göre tam memur bordrosu henüz yoktur.
• 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 tam memur bordrosu (katsayılar, gösterge, ek gösterge, tazminatlar)
• 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