TurkActuary MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PYTHONPATH | Yes | Path to the repository's src directory, e.g. <repo>/src. | |
| ACTUARYLLM_ROOT | Yes | Path to the repository root, e.g. <repo>. | |
| ACTUARYLLM_CACHE | No | Optional cache directory for computed embeddings. | |
| ACTUARYLLM_SEARCH | No | Optional search profile: auto, v5, or v2. v5 uses hybrid BM25 plus embeddings; v2 uses BM25 only. | |
| ACTUARYLLM_EMBED_URL | No | Optional embedding model URL; only 127.0.0.1 or localhost are allowed. | |
| ACTUARYLLM_EMBED_MODEL | No | Optional 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_araile kaynak getir; cevabı getirilen parçalara dayandır ve parça kimliğiyle atıf yap ([kimlik]). Madde numarasını yalnız sonuçtakimaddeleralanından yaz; tahmin etme. Gerekirsebelge_getirile 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
| Capability | Details |
|---|---|
| tools | {} |
| prompts | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| 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
| Name | Description |
|---|---|
| turkactuary | TurkActuary sistem talimatı ve araç kullanım rehberi. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 19 tools
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.
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.
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.
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.