Skip to main content
Glama
TurkActuary MCP

TurkActuary MCP

by afsharid

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
PYTHONPATHYesPath to the repository's src directory, e.g. <repo>/src.
ACTUARYLLM_ROOTYesPath to the repository root, e.g. <repo>.
ACTUARYLLM_CACHENoOptional cache directory for computed embeddings.
ACTUARYLLM_SEARCHNoOptional search profile: auto, v5, or v2. v5 uses hybrid BM25 plus embeddings; v2 uses BM25 only.
ACTUARYLLM_EMBED_URLNoOptional embedding model URL; only 127.0.0.1 or localhost are allowed.
ACTUARYLLM_EMBED_MODELNoOptional embedding model name, e.g. text-embedding-qwen3-embedding-4b.

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

Araç kullanımı:

  • Mevzuat ya da kavram sorusunda önce mevzuat_ara ile kaynak getir; cevabı getirilen parçalara dayandır ve parça kimliğiyle atıf yap ([kimlik]). Madde numarasını yalnız sonuçtaki maddeler alanından yaz; tahmin etme. Gerekirse belge_getir ile parçanın tamamını oku.

  • Sayısal hesabı kendin yapma; uygun hesap aracını çağır ve varsayımları (dönem, oran, ödeme zamanı, paid/incurred) yaz.

  • Oranlar ondalık verilir: 0.10 = %10. Hasar üçgenleri kümülatiftir.

  • Korpus 2026-10-18 erişimli konsolide mevzuat kopyası ve özgün öğretici notlardır; güncel hüküm için resmi kaynağı doğrula.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{}
prompts
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
mevzuat_araA

Türkiye sigortacılık mevzuatı (5684 sayılı Kanun, yönetmelikler, tebliğler; konsolide, erişim 2026-10-18), seçilmiş Yargıtay tazminat kararları (destekten yoksun kalma, iş göremezlik; künyeli) ve öğretici notlarda arama (embedding sunucusu varsa BM25 + anlamsal karma v5, yoksa BM25 v2). Parça kimliği, başlık, kaynak, kapsanan madde numaraları (maddeler) ve metin döner. Atıfta madde numarasını yalnız 'maddeler' alanından al; tahmin etme.

belge_getirA

Parça kimliğiyle (ör. mevzuat-5684_consolidated:3 ya da edu_risk_pool) tam metni getirir.

is_goremezlikA

Sürekli/geçici iş göremezlik tazminatı (Yargıtay uygulaması: TRH 2010 bakiye ömür kaza tarihindeki yaşa göre, bilinen dönem iskontosuz, bilinmeyen dönem %10 artış/%10 iskonto progresif rant, 60 yaşa kadar aktif sonra pasif; indirim sırası kusur → hatır → müterafik → SGK → önceki ödemeler). Dönem tablosu, varsayımlar ve karar kimlikleri döner. Bilirkişi raporu yerine geçmez.

destekten_yoksun_kalmaA

Destekten yoksun kalma tazminatı, hak sahibi başına (Yargıtay uygulaması: TRH 2010, progresif rant, pay sistemi destek 2/eş 2/çocuk 1/ana-baba 1; çocuk desteği erkek 18, kız 22, yüksek öğrenim 25; eşin evlenme ihtimali indirimi: verilmezse kadın eş için AYİM tablosu, 18 yaş altı çocuk başına 5 puan). pasif_donem_destegi zorunludur (kararlarda açık kural yok). Bilirkişi raporu yerine geçmez.

asgari_ucretA

Türkiye aylık asgari ücreti (16 yaş üstü; ÇSGB tabloları, 2008–2026): tarih aralığındaki dönemler, brüt ve net. Çıktıdaki gelir_donemleri tazminat araçlarına doğrudan verilebilir. 2022 öncesi için agi_dahil seçilmelidir (asgari geçim indirimi; kararlarda açık kural yok).

present_valueC

Açık dönemlik oranla net bugünkü değer.

annuityC

Dönem sonu veya başı sabit ödeme annüitesi.

life_insurance_pvC

Verilen qx ile ölüm döneminin sonunda ödenen süreli hayat teminatı.

chain_ladderA

Açık paid/incurred bazında kümülatif Chain Ladder; saf IBNR varsayılmaz. tail_factor isteğe bağlıdır; kullanıcı vermediyse gönderme (varsayılan 1, en az 1). Sonucun adını reserve_interpretation alanından al: paid bazında toplam ödenmemiş rezervdir, IBNR diye adlandırma.

bornhuetter_fergusonA

Kazanılmış prim ve a-priori hasar oranlarıyla BF tahmini. tail_factor isteğe bağlıdır; kullanıcı vermediyse gönderme (varsayılan 1, en az 1). Sonucun adını reserve_interpretation alanından al: paid bazında toplam ödenmemiş rezervdir, IBNR diye adlandırma.

portfolio_metricsC

Tutarlı kapalı kohort için frekans, şiddet, saf prim ve hasar oranı.

life_annuity_pvC

Verilen qx ile yaşam koşullu süreli annüite (dönem sonu veya başı).

xl_layer_recoveryB

Olay başı hasar fazlası katmanından tahsilat; isteğe bağlı reinstatement ile agregat sınır.

credibility_estimateC

Bühlmann tipi güvenilirlik ağırlığı (k açıkça verilir).

earned_exposureC

Poliçe tarihlerinden dönem içinde kazanılmış maruziyet (yıl).

poisson_glmC

Maruziyet ofsetli log bağlantılı Poisson frekans GLM'i (kategorik faktörler, göreli katsayılar).

gamma_severity_glmC

Hasar adediyle ağırlıklı log bağlantılı gamma şiddet GLM'i (kategorik faktörler).

life_cashflow_projectionC

Ölüm ve iptal çıkışlı dönemlik hayat poliçesi nakit akışı ve bugünkü değerler.

combined_ratioB

Aynı kazanılmış esasta hasar (LAE dahil), gider ve bileşik oran.

Prompts

Interactive templates invoked by user choice

NameDescription
turkactuaryTurkActuary sistem talimatı ve araç kullanım rehberi.

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

B3.2/5.0

Scored across 19 tools

Disambiguation4/5

Each tool targets a distinct calculation or resource: reserving (chain_ladder vs bornhuetter_ferguson), life contingencies (life_insurance_pv vs life_annuity_pv vs life_cashflow_projection), and compensation (is_goremezlik vs destekten_yoksun_kalma) are separated by clear wording. The main soft spot is the cluster of present-value/annuity/life-contingent tools, where an agent must read carefully to pick the right one, but descriptions do resolve it.

Naming Consistency4/5

All names use uniform snake_case with predictable noun or verb_noun forms, so structure is readable and consistent. The deviation is language mixing — Turkish names (mevzuat_ara, is_goremezlik, destekten_yoksun_kalma, asgari_ucret) alongside English ones (present_value, chain_ladder, combined_ratio) — which is stylistic rather than structural.

Tool Count4/5

19 tools is slightly on the heavy side, but the scope genuinely spans legal lookup, damages computation, reserving, life contingencies, GLM pricing and exposure — each area needs its few tools. No obvious filler; a couple of niche items (credibility_estimate, earned_exposure) could arguably have been folded in, but nothing is gratuitous.

Completeness5/5

The surface covers the full lifecycle of the stated domain: legal search plus full-text retrieval, per-head damages, reserving (CL and BF), frequency/severity GLMs, annuity and life contingencies, XL recovery, credibility and combined ratio. Inputs chain across tools (asgari_ucret output feeds compensation tools), so there are no dead ends; only optional extras like stochastic reserving or triangle preparation are absent.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues