io.github.omercebeci/hesapnokta

Yapay zekâ ve geliştiriciler için HesapNokta

Ücretsiz, üyeliksiz ve API anahtarsız bir MCP sunucusu: Türkiye'ye özgü 43 hesap ve veri aracı.

Sitedeki hesapları yapay zekâ asistanınızdan ya da kendi yazdığınız ajandan çağırabilirsiniz. Sonuçlar sitedeki hesap motorlarından, güncel resmî oran ve tavanlarla gelir.

MCP sunucusuStreamable HTTPsalt okunur
araç, hepsi salt okunur
43
ücret, anahtar gerekmez
0 TL
YZ testi, araçlarla
50/50
en düşük model
YZ testi, araçsız
28/50
en iyi model

Sunucu bilgileri

Adres
https://www.hesapnokta.com/mcp
Taşıma
Streamable HTTP (durumsuz, JSON-RPC)
Kimlik doğrulama
Yok
MCP Registry adı
io.github.omercebeci/hesapnokta
Araçlar
43, hepsi salt okunur
Açık veri paketi
/veri/guncel.json
Değişiklik akışı
degisiklikler.json · degisiklikler.xml
Günlük denetim
Durum raporu
Makine özeti
/llms.txt

HesapNokta, Türkiye'ye özgü ve mevzuata bağlı hesapları (maaş, tazminat, vergi, kira artışı, askerlik, sınav puanı, tarih) güncel resmî oran ve tavanlarla yapar. Dil modelleri bu tür hesaplarda eski oranları kullanabildiği ya da işlem hatası yapabildiği için sonucu hesap motorundan almak daha güvenilirdir.

Asistanınıza eklemek

Claude
Ayarlar → Bağlayıcılar → Özel bağlayıcı ekle. Ad “HesapNokta”, URL yukarıdaki sunucu adresi.
ChatGPT
Geliştirici modu açık bir hesapta Ayarlar → Uygulamalar → Uygulama oluştur. Aynı URL, kimlik doğrulama “Yok”.
Diğer MCP istemcileri
Cursor, VS Code ya da kendi ajanınız: uzak sunucu olarak aynı adresi ekleyin.

Ekledikten sonra asistana günlük dille sorabilirsiniz: “Brüt maaşım 60.000 TL, net ne kadar ele geçer?”, “5 Kasım 2026 celbiyle askere gidiyorum, ne zaman terhis olurum?”

Doğrudan çağırmak

Sunucu durumsuzdur; oturum açmadan tek bir POST isteğiyle araç çağrılabilir.initialize cevabındaki Mcp-Session-Id başlığı isteğe bağlıdır; geri gönderilirse yalnız anonim kullanım sayımında istemci adıyla eşleştirme için kullanılır. Araçların adları ve girdi şemaları tools/list yöntemiyle alınır.

curl -s https://www.hesapnokta.com/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"kdv_hesapla",
                 "arguments":{"tutar":1000,"oran":20}}}'

Her cevapta sonuçla birlikte kaynak.url alanı döner: hesabın ayrıntısını, yöntemini ve dayandığı resmî kaynağı gösteren HesapNokta sayfasıdır. Sonucu kullanıcıya sunarken bu bağlantıyı kaynak göstermenizi rica ederiz.

Araçlar

HesapAraç adı
Maaş ve çalışma hayatı
Brüt-net maaşbrut_net_maas_hesapla
Kıdem ve ihbar tazminatıkidem_ihbar_tazminati_hesapla
İşten ayrılma alacaklarıisten_ayrilma_alacaklari_hesapla
İşveren maliyetiisveren_maliyeti_hesapla
İşsizlik maaşıissizlik_maasi_hesapla
Yıllık izinyillik_izin_hesapla
Fazla mesaifazla_mesai_hesapla
Asgari ücret zammıasgari_ucret_zammi_hesapla
Memur ve emekli zammımemur_emekli_zammi_hesapla
Emeklilik tarihiemeklilik_tarihi_hesapla
Rapor parasırapor_parasi_hesapla
Vergi, kira, miras ve finans
Kira artışıkira_artis_hesapla
Kira geliri vergisikira_geliri_vergisi_hesapla
Miras payımiras_payi_hesapla
KDVkdv_hesapla
Tapu harcıtapu_harci_hesapla
Kredi taksitikredi_hesapla
Kredi erken kapatmakredi_erken_kapatma_hesapla
Mevduat faizimevduat_faizi_hesapla
Kredi kartı asgari ödemekredi_karti_asgari_odeme_hesapla
Döviz çeviricidoviz_cevir
Enflasyon etkisienflasyon_etkisi_hesapla
Paranın bugünkü değeriparanin_bugunku_degeri_hesapla
Trafik cezası erken ödemetrafik_cezasi_erken_odeme_hesapla
E-ticaret
Kâr marjıkar_marji_hesapla
Kargo desikargo_desi_hesapla
Askerlik ve sınavlar
Askerlik terhis tarihiaskerlik_terhis_tarihi_hesapla
YKS puanı ve sıralamasıyks_puani_hesapla
LGS puanılgs_puani_hesapla
Sınav netisinav_neti_hesapla
Vize-final ortalamasıvize_final_ortalamasi_hesapla
Tarih, zaman ve günlük hesaplar
Gün sayacıgun_sayaci_hesapla
İş günüis_gunu_hesapla
Yaklaşan önemli günleryaklasan_onemli_gunler
Tarih farkıtarih_farki_hesapla
Yaşyas_hesapla
Saat farkısaat_farki_hesapla
Yüzdeyuzde_hesapla
Vücut kitle indeksivucut_kitle_indeksi_hesapla
Gebelik haftasıgebelik_haftasi_hesapla
Güncel veriler
Güncel resmî oran ve tutarlarguncel_veri_getir
Güncel döviz kuru (TCMB)doviz_kuru_getir
Güncel enflasyon oranı (TÜFE, TÜİK)enflasyon_orani_getir

Araçların açıklamaları ve örnek sorular için sunucunun kurulum sayfasına bakabilirsiniz.

Açık veri paketi

Hesapların dayandığı güncel resmî değerler (asgari ücret, gelir vergisi dilimleri, SGK oranları, kıdem tazminatı tavanı, kira artış üst sınırı, KDV, tapu harcı ve benzerleri) tek bir JSON dosyası olarak da açıktır: https://www.hesapnokta.com/veri/guncel.json

Her kayıt yalnız bir sayı değildir; değerin birimini, ait olduğu dönemi, ilan edilmişse geçerlilik bitiş tarihini, yasal dayanağını, okunduğu resmî kaynağı ve son doğrulama tarihini de taşır. Böylece bir yapay zekâ değerin nereden geldiğini ve hâlâ geçerli olup olmadığını da bilir. Aynı kayıtlar MCP sunucusunda guncel_veri_getir aracıyla tek tek alınabilir; MCP kaynağı olarak da (resources/list, resources/read) bağlama eklenebilir. Paket yalnız Türkiye'yi kapsar; ücretsizdir ve kaynak gösterilerek kullanılabilir. Bağlayıcı olan, her kaydın kaynağında belirtilen resmî metindir.

Araç cevaplarının _meta alanında, sonucun hangi veri sürümüyle üretildiği de yer alır; aynı sürüm ve aynı girdi her zaman aynı sonucu verir.

Bir değer değiştiğinde (yeni yılın asgari ücreti, her ay güncellenen kira artış üst sınırı, yeni kıdem tazminatı tavanı) değişiklik eski ve yeni hâliyle, tarihiyle birlikte değişiklik günlüğüne yazılır: degisiklikler.json ve RSS akışı degisiklikler.xml. Paketi her gün indirmek yerine akışı izleyebilirsiniz; guncel_veri_getir aracı da her kaydın son değişikliklerini döner.

Yapay zekâ Türkiye hesaplarında ne kadar doğru?

Maaş, kıdem tazminatı, vergi, kira, kredi ve tarih konularında 50 soruluk bir deneme seti hazırladık ve her soruyu yapay zekâ modellerine iki kez sorduk: bir kez yalnız kendi bilgisiyle, bir kez de bu sayfadaki araçlar bağlıyken. Doğru cevaplar sitedeki hesap motorlarından gelir; yayımlamadan önce her soruyu resmî kaynaklardaki oran ve tutarlarla (asgari ücret, SGK tavanı, kıdem tavanı, TÜİK kira oranı, stopaj, KKDF/BSMV, Diyanet takvimi) elle yeniden hesapladık.

ModelAraçsızHesapNokta araçlarıyla
Gemini Flash-Lite (gemini-flash-lite-latest)28 / 5050 / 50
Gemini 3.1 Flash-Lite (önizleme)25 / 5050 / 50

Modeller kendi bilgisiyle en çok maaş ve bordro sorularında yanıldı: net maaşı ve işveren maliyetini 2024 ya da 2025 yılının asgari ücret ve oranlarıyla hesapladılar, Kasım 2026 kira artış üst sınırını da bilmediler. Gün ve süre hesaplarında araçsız da iyiydiler. Araçlar bağlıyken her soruda doğru aracı seçip sonucu değiştirmeden aktardılar.

Sonuçlar küçük ve ücretsiz kotayla çalışan 2 modele aittir, her soru bir kez sorulmuştur; büyük modellerin sonucu farklı olabilir. Soru seti ve her modelin tek tek cevapları açıktır: /veri/hesap-testi/deneme-50.json, /veri/hesap-testi/sonuclar/gemini-flash-lite-latest.json, /veri/hesap-testi/sonuclar/gemini-3.1-flash-lite-preview.json. Test tarihi: 2026-11-12.

Test her ay tekrarlanır; aylık geçmiş, konu dağılımı ve yöntem: Yapay zekâ doğruluk testi. Araçlarımızın kendisi de her gün, doğru cevabı resmî kaynaktan hesaplanmış örneklerle deneniyor: Durum raporu.

Hukuk, mali müşavirlik, İK ya da emlak alanında bir asistan veya hesap yazılımı geliştiriyorsanız ürününüzü de aynı yöntemle test edebiliriz: Ürününüzün hesap doğruluğu testi.

Tarayıcıda çalışan ajanlar

Hesaplayıcı sayfalarının bir bölümü, tarayıcı içi yapay zekâ ajanları için WebMCP araçları da yayımlar: ajan formu elle doldurmak yerine hesabı doğrudan araçla yapabilir. Sayfalarda ayrıca hesabın yöntemini ve kaynağını anlatan yapılandırılmış veri (JSON-LD) bulunur. Kısa bir makine özeti /llms.txt adresindedir.

Sitenize ya da uygulamanıza eklemek

Kodsuz yol için kira artışı hesaplayıcısı tek satırlık bir gömme koduyla sitenize eklenebilir: Hesaplayıcıyı sitenize ekleyin. Başka bir hesaplayıcının gömülebilir sürümüne, yüksek hacimli kullanıma ya da kendi markanızla sunulan bir hesap aracına ihtiyacınız varsa İletişim sayfasından ne için kullanacağınızı kısaca yazın; hangi aracın önce hazırlanacağına bu taleplere bakarak karar veriyoruz.

Koşullar ve sınırlar

Sonuçlar bilgilendirme amaçlıdır; hukuki, mali veya tıbbi tavsiye değildir. Gönderilen girdiler yalnız hesap için kullanılır ve saklanmaz; yalnız hangi aracın kaç kez çağrıldığı anonim olarak sayılır. Aşırı yoğun otomatik kullanım hizmetin sürekliliği için sınırlandırılabilir. Ayrıntı: Kullanım Koşulları ve Gizlilik Politikası. Hata bildirimi ve yeni araç isteği için İletişim sayfasını kullanabilirsiniz.