make descriptions more llm friendly

bedesten_mcp_module/models.py

@@ -42,56 +42,56 @@ class BedestenSearchData(BaseModel):
         Calculate total pages from response.data.total / pageSize
         Navigate: pageNumber=2 gets next set of results""")
     itemTypeList: List[str] = Field(..., description="""Court type filter - determines which court decisions to search:
-        • ["YARGITAYKARARI"]: Yargıtay (Court of Cassation) - supreme court civil/criminal
+        • ["YARGITAYKARARI"]: Court of Cassation (Yargıtay) - supreme court civil/criminal decisions
-        • ["DANISTAYKARAR"]: Danıştay (Council of State) - administrative court decisions
+        • ["DANISTAYKARAR"]: Council of State (Danıştay) - administrative court decisions
-        • ["YERELHUKUK"]: Yerel Hukuk Mahkemesi - local civil court decisions
+        • ["YERELHUKUK"]: Local Civil Courts (Yerel Hukuk Mahkemeleri) - first instance civil decisions
-        • ["ISTINAFHUKUK"]: İstinaf Hukuk Mahkemesi - civil appellate court decisions
+        • ["ISTINAFHUKUK"]: Civil Courts of Appeals (İstinaf Hukuk Mahkemeleri) - appellate court decisions
-        • ["KYB"]: Kanun Yararına Bozma - extraordinary appeal decisions
+        • ["KYB"]: Extraordinary Appeal (Kanun Yararına Bozma) - extraordinary appeal decisions
         Note: Use single-item list for specific court type targeting""")
     phrase: str = Field(..., description="""Search phrase/keyword with advanced search support:
         • Regular search: "mülkiyet kararı" - searches words separately
         • Exact phrase: "\"mülkiyet kararı\"" - searches exact phrase (more precise)
-        • Legal concepts: "\"idari işlem\"", "\"sözleşme ihlali\""
+        • Legal concepts: "\"idari işlem\"", "\"sözleşme ihlali\"", "\"tazminat davası\""
         • Empty string: searches all documents (use with filters)
-        Exact phrases significantly reduce false positives""")
+        Exact phrases significantly reduce false positives for precise legal research""")
     birimAdi: Optional[Union[YargitayBirimEnum, DanistayBirimEnum]] = Field(None, description="""
-        Chamber/Board filter (optional). Available options depend on itemTypeList:
+        Chamber/Department (Daire) filter (optional). Available options depend on itemTypeList:
         
-        For YARGITAYKARARI (52 options):
+        For YARGITAYKARARI - Court of Cassation (52 options):
         - None/null for ALL chambers
-        - 'Hukuk Genel Kurulu', '1. Hukuk Dairesi' through '23. Hukuk Dairesi'
+        - 'Civil General Assembly (Hukuk Genel Kurulu)', '1st Civil Chamber (1. Hukuk Dairesi)' through '23rd Civil Chamber (23. Hukuk Dairesi)'
-        - 'Ceza Genel Kurulu', '1. Ceza Dairesi' through '23. Ceza Dairesi'  
+        - 'Criminal General Assembly (Ceza Genel Kurulu)', '1st Criminal Chamber (1. Ceza Dairesi)' through '23rd Criminal Chamber (23. Ceza Dairesi)'  
-        - 'Hukuk Daireleri Başkanlar Kurulu', 'Ceza Daireleri Başkanlar Kurulu'
+        - 'Civil Chambers Presidents Board (Hukuk Daireleri Başkanlar Kurulu)', 'Criminal Chambers Presidents Board (Ceza Daireleri Başkanlar Kurulu)'
-        - 'Büyük Genel Kurulu'
+        - 'Grand General Assembly (Büyük Genel Kurulu)'
         
-        For DANISTAYKARAR (27 options):
+        For DANISTAYKARAR - Council of State (27 options):
         - None/null for ALL chambers
-        - 'Büyük Gen.Kur.', 'İdare Dava Daireleri Kurulu', 'Vergi Dava Daireleri Kurulu'
+        - 'Grand General Assembly (Büyük Gen.Kur.)', 'Administrative Cases Chambers Council (İdare Dava Daireleri Kurulu)', 'Tax Cases Chambers Council (Vergi Dava Daireleri Kurulu)'
-        - '1. Daire' through '17. Daire'
+        - '1st Chamber (1. Daire)' through '17th Chamber (17. Daire)'
-        - 'İçtihatları Birleştirme Kurulu', 'İdari İşler Kurulu', 'Başkanlar Kurulu'
+        - 'Precedents Unification Council (İçtihatları Birleştirme Kurulu)', 'Administrative Affairs Council (İdari İşler Kurulu)', 'Presidents Council (Başkanlar Kurulu)'
-        - Military courts: 'Askeri Yüksek İdare Mahkemesi' variants
+        - Military courts: 'Military High Administrative Court (Askeri Yüksek İdare Mahkemesi)' variants
     """)
-    kararTarihiStart: Optional[str] = Field(None, description="""Decision start date filter (optional).
+    kararTarihiStart: Optional[str] = Field(None, description="""Decision start date (Karar Tarihi Başlangıç) filter (optional).
         Format: YYYY-MM-DDTHH:MM:SS.000Z (ISO 8601 with Z timezone)
         Examples:
         • "2024-01-01T00:00:00.000Z" - from beginning of 2024
         • "2023-06-15T00:00:00.000Z" - from June 15, 2023
         • "2024-03-01T00:00:00.000Z" - from March 1, 2024
-        Use with kararTarihiEnd for date range, or alone for "from date" filtering""")
+        Use with kararTarihiEnd for date range, or alone for "from date" filtering"""
-    kararTarihiEnd: Optional[str] = Field(None, description="""Decision end date filter (optional).
+    kararTarihiEnd: Optional[str] = Field(None, description="""Decision end date (Karar Tarihi Bitiş) filter (optional).
         Format: YYYY-MM-DDTHH:MM:SS.000Z (ISO 8601 with Z timezone)
         Examples:
         • "2024-12-31T23:59:59.999Z" - until end of 2024
         • "2023-12-31T23:59:59.999Z" - until end of 2023  
         • "2024-06-30T23:59:59.999Z" - until end of June 2024
-        Use with kararTarihiStart for date range, or alone for "until date" filtering""")
+        Use with kararTarihiStart for date range, or alone for "until date" filtering"""
-    sortFields: List[str] = Field(default=["KARAR_TARIHI"], description="""Sorting field specification.
+    sortFields: List[str] = Field(default=["KARAR_TARIHI"], description="""Sorting field (Sıralama Alanı) specification.
-        ["KARAR_TARIHI"]: Sort by decision date [DEFAULT]
+        ["KARAR_TARIHI"]: Sort by decision date (Karar Tarihi) [DEFAULT]
-        Most common use case for chronological ordering""")
+        Most common use case for chronological ordering"""
-    sortDirection: str = Field(default="desc", description="""Sort direction for results.
+    sortDirection: str = Field(default="desc", description="""Sort direction (Sıralama Yönü) for results.
         "desc": Descending order - newest decisions first [DEFAULT]
         "asc": Ascending order - oldest decisions first
-        Recommended: "desc" for latest legal developments""")""")
+        Recommended: "desc" for latest legal developments""")
 
 class BedestenSearchRequest(BaseModel):
     data: BedestenSearchData
@@ -146,7 +146,7 @@ class BedestenDocumentResponse(BaseModel):
     metadata: Dict[str, Any]
 
 class BedestenDocumentMarkdown(BaseModel):
-    documentId: str = Field(..., description="The document ID from Bedesten")
+    documentId: str = Field(..., description="The document ID (Belge Kimliği) from Bedesten")
-    markdown_content: Optional[str] = Field(None, description="The decision content converted to Markdown")
+    markdown_content: Optional[str] = Field(None, description="The decision content (Karar İçeriği) converted to Markdown")
-    source_url: str = Field(..., description="The source URL of the document")
+    source_url: str = Field(..., description="The source URL (Kaynak URL) of the document")
-    mime_type: Optional[str] = Field(None, description="Original content type (text/html or application/pdf)")
+    mime_type: Optional[str] = Field(None, description="Original content type (İçerik Türü) (text/html or application/pdf)")

danistay_mcp_module/models.py

@@ -21,10 +21,10 @@ class DanistayKeywordSearchRequestData(BaseModel):
 
 class DanistayKeywordSearchRequest(BaseModel): # This is the model the MCP tool will accept
     """Model for keyword-based search request for Danistay."""
-    andKelimeler: List[str] = Field(default_factory=list, description="Keywords for AND logic, e.g., ['word1', 'word2']")
+    andKelimeler: List[str] = Field(default_factory=list, description="Keywords for AND logic (VE Mantığı), e.g., ['word1', 'word2']")
-    orKelimeler: List[str] = Field(default_factory=list, description="Keywords for OR logic.")
+    orKelimeler: List[str] = Field(default_factory=list, description="Keywords for OR logic (VEYA Mantığı).")
-    notAndKelimeler: List[str] = Field(default_factory=list, description="Keywords for NOT AND logic.")
+    notAndKelimeler: List[str] = Field(default_factory=list, description="Keywords for NOT AND logic (VE DEĞİL Mantığı).")
-    notOrKelimeler: List[str] = Field(default_factory=list, description="Keywords for NOT OR logic.")
+    notOrKelimeler: List[str] = Field(default_factory=list, description="Keywords for NOT OR logic (VEYA DEĞİL Mantığı).")
     pageSize: int = Field(default=10, ge=1, le=100)
     pageNumber: int = Field(default=1, ge=1)
 
@@ -80,11 +80,11 @@ class DanistayApiDecisionEntry(BaseModel):
     esasNo: Optional[str] = Field(None)
     kararNo: Optional[str] = Field(None)
     kararTarihi: Optional[str] = Field(None)
-    arananKelime: Optional[str] = Field(None, description="Matched keyword if provided in response.")
+    arananKelime: Optional[str] = Field(None, description="Matched keyword (Aranan Kelime) if provided in response.")
     # index: Optional[int] = None # Present in response, can be added if needed by MCP tool
     # siraNo: Optional[int] = None # Present in detailed response, can be added
 
-    document_url: Optional[HttpUrl] = Field(None, description="URL to the full document, constructed by the client.")
+    document_url: Optional[HttpUrl] = Field(None, description="URL (Belge URL) to the full document, constructed by the client.")
 
     class Config:
         populate_by_name = True # Important for alias to work
@@ -95,17 +95,17 @@ class DanistayApiResponseInnerData(BaseModel):
     data: List[DanistayApiDecisionEntry]
     recordsTotal: int
     recordsFiltered: int
-    draw: Optional[int] = Field(None, description="Draw counter from API, usually for DataTables.")
+    draw: Optional[int] = Field(None, description="Draw counter (Çizim Sayıcısı) from API, usually for DataTables.")
 
 class DanistayApiResponse(BaseModel):
     """Model for the complete search response from the Danistay API."""
     data: DanistayApiResponseInnerData
-    metadata: Optional[Dict[str, Any]] = Field(None, description="Optional metadata from API.")
+    metadata: Optional[Dict[str, Any]] = Field(None, description="Optional metadata (Meta Veri) from API.")
 
 class DanistayDocumentMarkdown(BaseModel):
     """Model for a Danistay decision document, containing only Markdown content."""
     id: str
-    markdown_content: Optional[str] = Field(None, description="The decision content converted to Markdown.")
+    markdown_content: Optional[str] = Field(None, description="The decision content (Karar İçeriği) converted to Markdown.")
     source_url: HttpUrl
 
 class CompactDanistaySearchResult(BaseModel):

emsal_mcp_module/models.py

@@ -17,7 +17,7 @@ class EmsalDetailedSearchRequestData(BaseModel):
     # Add other specific court type fields from the form if they are separate keys in payload
     # E.g., "Ceza Mahkemeleri", "İdari Mahkemeler" etc.
     
-    birimHukukMah: Optional[str] = Field("", description="List of selected Regional Civil Chambers, '+' separated.") 
+    birimHukukMah: Optional[str] = Field("", description="List of selected Regional Civil Chambers (Bölge Hukuk Mahkemeleri), '+' separated.") 
 
     esasYil: Optional[str] = ""
     esasIlkSiraNo: Optional[str] = ""
@@ -38,25 +38,25 @@ class EmsalDetailedSearchRequestData(BaseModel):
 
 class EmsalSearchRequest(BaseModel): # This is the model the MCP tool will accept
     """Model for Emsal detailed search request, with user-friendly field names."""
-    keyword: Optional[str] = Field(None, description="Keyword to search.")
+    keyword: Optional[str] = Field(None, description="Keyword (Anahtar Kelime) to search.")
     
-    selected_bam_civil_court: Optional[str] = Field(None, description="Selected BAM Civil Court (maps to 'Bam Hukuk Mahkemeleri' payload key).")
+    selected_bam_civil_court: Optional[str] = Field(None, description="Selected BAM Civil Court (Seçilen BAM Hukuk Mahkemesi) (maps to 'Bam Hukuk Mahkemeleri' payload key).")
-    selected_civil_court: Optional[str] = Field(None, description="Selected Civil Court (maps to 'Hukuk Mahkemeleri' payload key).")
+    selected_civil_court: Optional[str] = Field(None, description="Selected Civil Court (Seçilen Hukuk Mahkemesi) (maps to 'Hukuk Mahkemeleri' payload key).")
-    selected_regional_civil_chambers: Optional[List[str]] = Field(default_factory=list, description="Selected Regional Civil Chambers (for 'birimHukukMah', joined by '+').")
+    selected_regional_civil_chambers: Optional[List[str]] = Field(default_factory=list, description="Selected Regional Civil Chambers (Seçilen Bölge Hukuk Daireleri) (for 'birimHukukMah', joined by '+').")
 
-    case_year_esas: Optional[str] = Field(None, description="Case year for 'Esas No'.")
+    case_year_esas: Optional[str] = Field(None, description="Case year (Dava Yılı) for 'Esas No'.")
-    case_start_seq_esas: Optional[str] = Field(None, description="Starting sequence for 'Esas No'.")
+    case_start_seq_esas: Optional[str] = Field(None, description="Starting sequence (Başlangıç Sırası) for 'Esas No'.")
-    case_end_seq_esas: Optional[str] = Field(None, description="Ending sequence for 'Esas No'.")
+    case_end_seq_esas: Optional[str] = Field(None, description="Ending sequence (Bitiş Sırası) for 'Esas No'.")
     
-    decision_year_karar: Optional[str] = Field(None, description="Decision year for 'Karar No'.")
+    decision_year_karar: Optional[str] = Field(None, description="Decision year (Karar Yılı) for 'Karar No'.")
-    decision_start_seq_karar: Optional[str] = Field(None, description="Starting sequence for 'Karar No'.")
+    decision_start_seq_karar: Optional[str] = Field(None, description="Starting sequence (Başlangıç Sırası) for 'Karar No'.")
-    decision_end_seq_karar: Optional[str] = Field(None, description="Ending sequence for 'Karar No'.")
+    decision_end_seq_karar: Optional[str] = Field(None, description="Ending sequence (Bitiş Sırası) for 'Karar No'.")
     
-    start_date: Optional[str] = Field(None, description="Start date for decision (DD.MM.YYYY).")
+    start_date: Optional[str] = Field(None, description="Start date (Başlangıç Tarihi) for decision (DD.MM.YYYY).")
-    end_date: Optional[str] = Field(None, description="End date for decision (DD.MM.YYYY).")
+    end_date: Optional[str] = Field(None, description="End date (Bitiş Tarihi) for decision (DD.MM.YYYY).")
     
-    sort_criteria: str = Field("1", description="Sorting criteria (e.g., 1: Esas No).")
+    sort_criteria: str = Field("1", description="Sorting criteria (Sıralama Kriteri) (e.g., 1: Esas No).")
-    sort_direction: str = Field("desc", description="Sorting direction ('asc' or 'desc').")
+    sort_direction: str = Field("desc", description="Sorting direction (Sıralama Yönü) ('asc' or 'desc').")
     
     page_number: int = Field(default=1, ge=1)
     page_size: int = Field(default=10, ge=1, le=100)
@@ -65,15 +65,15 @@ class EmsalSearchRequest(BaseModel): # This is the model the MCP tool will accep
 class EmsalApiDecisionEntry(BaseModel):
     """Model for an individual decision entry from the Emsal API search response."""
     id: str
-    daire: Optional[str] = Field(None, description="The chamber/court that made the decision.")
+    daire: Optional[str] = Field(None, description="The chamber/court (Daire/Mahkeme) that made the decision.")
     esasNo: Optional[str] = Field(None)
     kararNo: Optional[str] = Field(None)
     kararTarihi: Optional[str] = Field(None)
-    arananKelime: Optional[str] = Field(None, description="Matched keyword from the search.")
+    arananKelime: Optional[str] = Field(None, description="Matched keyword (Aranan Kelime) from the search.")
-    durum: Optional[str] = Field(None, description="Status of the decision (e.g., 'KESİNLEŞMEDİ').")
+    durum: Optional[str] = Field(None, description="Status (Durum) of the decision (e.g., 'KESİNLEŞMEDİ').")
     # index: Optional[int] = None # Present in Emsal response, can be added if tool needs it
 
-    document_url: Optional[HttpUrl] = Field(None, description="URL to the full document, constructed by the client.")
+    document_url: Optional[HttpUrl] = Field(None, description="URL (Belge URL) to the full document, constructed by the client.")
 
     class Config:
         extra = 'ignore'
@@ -83,17 +83,17 @@ class EmsalApiResponseInnerData(BaseModel):
     data: List[EmsalApiDecisionEntry]
     recordsTotal: int
     recordsFiltered: int
-    draw: Optional[int] = Field(None, description="Draw counter from API, usually for DataTables.")
+    draw: Optional[int] = Field(None, description="Draw counter (Çizim Sayıcısı) from API, usually for DataTables.")
 
 class EmsalApiResponse(BaseModel):
     """Model for the complete search response from the Emsal API."""
     data: EmsalApiResponseInnerData
-    metadata: Optional[Dict[str, Any]] = Field(None, description="Optional metadata from API, if any.")
+    metadata: Optional[Dict[str, Any]] = Field(None, description="Optional metadata (Meta Veri) from API, if any.")
 
 class EmsalDocumentMarkdown(BaseModel):
     """Model for an Emsal decision document, containing only Markdown content."""
     id: str
-    markdown_content: Optional[str] = Field(None, description="The decision content converted to Markdown.")
+    markdown_content: Optional[str] = Field(None, description="The decision content (Karar İçeriği) converted to Markdown.")
     source_url: HttpUrl
 
 class CompactEmsalSearchResult(BaseModel):

mcp_server_main.py

@@ -117,7 +117,7 @@ KARAR_TURU_ADI_TO_GUID_ENUM_MAP = {
 
 # --- MCP Tools for Yargitay ---
 @app.tool(
-    description="Search Yargıtay (Court of Cassation) decisions using the primary official API with advanced search operators, chamber filtering (52 options), and comprehensive criteria. This is Turkey's highest court for civil and criminal matters, providing supreme court precedents",
+    description="Search Court of Cassation (Yargıtay) decisions using the primary official API with advanced search operators, chamber filtering (52 options), and comprehensive criteria. This is Turkey's highest court for civil and criminal matters, providing supreme court precedents",
     annotations={
         "readOnlyHint": True,
         "openWorldHint": True,
@@ -162,37 +162,37 @@ async def search_yargitay_detailed(
     pageNumber: int = Field(1, ge=1, description="Page number to retrieve.")
 ) -> CompactYargitaySearchResult:
     """
-    Searches Yargıtay (Court of Cassation) decisions using the primary official API.
+    Searches Court of Cassation (Yargıtay) decisions using the primary official API.
     
-    Yargıtay is Turkey's highest court for civil and criminal matters, equivalent to a Supreme Court.
+    The Court of Cassation (Yargıtay) is Turkey's highest court for civil and criminal matters,
-    This tool provides access to the most comprehensive database of supreme court precedents with
+    equivalent to a Supreme Court. This tool provides access to the most comprehensive database
-    advanced search capabilities and filtering options.
+    of supreme court precedents with advanced search capabilities and filtering options.
     
     Key Features:
     • Advanced search operators (AND, OR, wildcards, exclusions)
-    • Chamber filtering: 52 options (23 Civil + 23 Criminal + General Assemblies)
+    • Chamber filtering: 52 options (23 Civil (Hukuk) + 23 Criminal (Ceza) + General Assemblies (Genel Kurullar))
     • Date range filtering with DD.MM.YYYY format
-    • Case number filtering (Esas No and Karar No)
+    • Case number filtering (Case No (Esas No) and Decision No (Karar No))
     • Pagination support (1-100 results per page)
     • Multiple sorting options (by case number, decision number, date)
     
     SEARCH SYNTAX GUIDE:
-    • Words with spaces: OR search ("arsa payı" finds ANY of the words)
+    • Words with spaces: OR search ("property share" finds ANY of the words)
-    • "Quotes": Exact phrase search ("arsa payı" finds exact phrase)
+    • "Quotes": Exact phrase search ("property share" finds exact phrase)
-    • Plus sign (+): AND search (arsa+payı requires both words)
+    • Plus sign (+): AND search (property+share requires both words)
-    • Asterisk (*): Wildcard (inşaat* matches variations)
+    • Asterisk (*): Wildcard (construct* matches variations)
     • Minus sign (-): Exclude terms (avoid unwanted results)
     
     Common Search Patterns:
-    • Simple OR: arsa payı (finds ~523K results)
+    • Simple OR: property share (finds ~523K results)
-    • Exact phrase: "arsa payı" (finds ~22K results)
+    • Exact phrase: "property share" (finds ~22K results)
-    • Multiple required: +"arsa payı" +"bozma sebebi" (finds ~234 results)
+    • Multiple required: +"property share" +"annulment reason (bozma sebebi)" (finds ~234 results)
-    • Wildcard expansion: inşaat* (matches inşaat, inşaatı, inşaatın, etc.)
+    • Wildcard expansion: construct* (matches construction, constructive, etc.)
-    • Exclude unwanted: +"arsa payı" -"inşaat sözleşmesi"
+    • Exclude unwanted: +"property share" -"construction contract"
     
     Use cases:
     • Research supreme court precedents and legal principles
-    • Find decisions from specific chambers (Civil vs Criminal)
+    • Find decisions from specific chambers (Civil (Hukuk) vs Criminal (Ceza))
     • Search for interpretations of specific legal concepts
     • Analyze court reasoning on complex legal issues
     • Track legal developments over time periods
@@ -236,7 +236,7 @@ async def search_yargitay_detailed(
         raise
 
 @app.tool(
-    description="Retrieve the full text of a specific Yargıtay decision from the primary official API in Markdown format",
+    description="Retrieve the full text of a specific Court of Cassation (Yargıtay) decision from the primary official API in Markdown format",
     annotations={
         "readOnlyHint": True,
         "idempotentHint": True
@@ -244,14 +244,14 @@ async def search_yargitay_detailed(
 )
 async def get_yargitay_document_markdown(id: str) -> YargitayDocumentMarkdown:
     """
-    Retrieves the full text of a specific Yargıtay decision from the primary official API in Markdown format.
+    Retrieves the full text of a specific Court of Cassation (Yargıtay) decision from the primary official API in Markdown format.
     
     This tool fetches complete supreme court decision documents and converts them to clean,
     readable Markdown format suitable for detailed legal analysis and processing.
     
     Input Requirements:
     • id: Decision ID from search_yargitay_detailed results
-    • ID must be non-empty string from official Yargıtay database
+    • ID must be non-empty string from official Court of Cassation (Yargıtay) database
     
     Output Format:
     • Clean Markdown text with legal structure preserved
@@ -263,11 +263,11 @@ async def get_yargitay_document_markdown(id: str) -> YargitayDocumentMarkdown:
     • Complete legal reasoning and precedent analysis
     • Detailed examination of lower court decisions
     • Citation of relevant laws, regulations, and prior cases
-    • Final ruling with legal justification
+    • Final ruling (karar) with legal justification
     
     Use for:
     • Reading full supreme court decision texts
-    • Legal research and precedent analysis
+    • Legal research and precedent (emsal) analysis
     • Citation extraction and reference building
     • Understanding supreme court legal reasoning
     • Academic and professional legal research
@@ -282,7 +282,7 @@ async def get_yargitay_document_markdown(id: str) -> YargitayDocumentMarkdown:
 
 # --- MCP Tools for Danistay ---
 @app.tool(
-    description="Search Danıştay (Council of State) decisions using keyword-based logic with AND/OR/NOT operators for complex administrative law research",
+    description="Search Council of State (Danıştay) decisions using keyword-based logic with AND/OR/NOT operators for complex administrative law research",
     annotations={
         "readOnlyHint": True,
         "openWorldHint": True,
@@ -298,11 +298,11 @@ async def search_danistay_by_keyword(
     pageSize: int = Field(10, ge=1, le=100, description="Results per page.")
 ) -> CompactDanistaySearchResult:
     """
-    Searches Danıştay (Council of State) decisions using keyword-based logic.
+    Searches Council of State (Danıştay) decisions using keyword-based logic.
     
-    Danıştay is Turkey's highest administrative court, equivalent to a Council of State,
+    The Council of State (Danıştay) is Turkey's highest administrative court, responsible for
-    responsible for reviewing administrative actions and providing administrative law precedents.
+    reviewing administrative actions and providing administrative law precedents. This tool
-    This tool provides flexible keyword-based searching with Boolean logic operators.
+    provides flexible keyword-based searching with Boolean logic operators.
     
     Key Features:
     • Boolean logic operators: AND, OR, NOT combinations
@@ -320,17 +320,17 @@ async def search_danistay_by_keyword(
     Administrative Law Use Cases:
     • Research administrative court precedents
     • Find decisions on specific government agencies
-    • Search for rulings on permits and licenses
+    • Search for rulings on permits (ruhsat) and licenses (izin)
     • Analyze administrative procedure interpretations
     • Study public administration legal principles
     
     Examples:
-    • Simple AND: andKelimeler=["idari işlem", "iptal"]
+    • Simple AND: andKelimeler=["administrative act (idari işlem)", "annulment (iptal)"]
-    • OR search: orKelimeler=["rühsat", "izin", "lisans"]
+    • OR search: orKelimeler=["permit (ruhsat)", "permission (izin)", "license (lisans)"]
-    • Complex: andKelimeler=["belediye"], notOrKelimeler=["vergi"]
+    • Complex: andKelimeler=["municipality (belediye)"], notOrKelimeler=["tax (vergi)"]
     
     Returns structured search results. Use get_danistay_document_markdown() for full texts.
-    For comprehensive Danıştay research, also use search_danistay_detailed and search_danistay_bedesten.
+    For comprehensive Council of State (Danıştay) research, also use search_danistay_detailed and search_danistay_bedesten.
     """
     
     search_query = DanistayKeywordSearchRequest(
@@ -358,7 +358,7 @@ async def search_danistay_by_keyword(
         raise
 
 @app.tool(
-    description="Search Danıştay (Council of State) decisions using detailed criteria including chamber selection, case numbers, dates, and legislation references for comprehensive administrative law research",
+    description="Search Council of State (Danıştay) decisions using detailed criteria including chamber (daire) selection, case numbers, dates, and legislation references for comprehensive administrative law research",
     annotations={
         "readOnlyHint": True,
         "openWorldHint": True,
@@ -384,15 +384,15 @@ async def search_danistay_detailed(
     pageSize: int = Field(10, ge=1, le=100, description="Results per page.")
 ) -> CompactDanistaySearchResult:
     """
-    Performs detailed search for Danıştay (Council of State) decisions with comprehensive filtering.
+    Performs detailed search for Council of State (Danıştay) decisions with comprehensive filtering.
     
-    Danıştay is Turkey's highest administrative court, providing final rulings on administrative
+    The Council of State (Danıştay) is Turkey's highest administrative court, providing final
-    law matters. This tool offers the most comprehensive search capabilities for administrative
+    rulings on administrative law matters. This tool offers the most comprehensive search
-    court decisions with detailed filtering options.
+    capabilities for administrative court decisions with detailed filtering options.
     
     Key Features:
-    • Chamber/Department filtering (specify exact chamber like '1. Daire')
+    • Chamber/Department (Daire) filtering (specify exact chamber like '1st Chamber (1. Daire)')
-    • Case number filtering (Esas No and Karar No with ranges)
+    • Case number filtering (Case No (Esas No) and Decision No (Karar No) with ranges)
     • Date range filtering with DD.MM.YYYY format
     • Legislation-based search (law numbers, names, article numbers)
     • Multiple sorting options (case number, decision date)
@@ -413,13 +413,13 @@ async def search_danistay_detailed(
     • Research permit, license, and regulatory decisions
     
     Chamber Examples:
-    • '1. Daire' through '17. Daire' - Administrative chambers
+    • '1st Chamber (1. Daire)' through '17th Chamber (17. Daire)' - Administrative chambers
-    • 'Vergi Dava Daireleri Kurulu' - Tax cases
+    • 'Tax Cases Chambers Council (Vergi Dava Daireleri Kurulu)' - Tax cases
-    • 'İdare Dava Daireleri Kurulu' - Administrative cases
+    • 'Administrative Cases Chambers Council (İdare Dava Daireleri Kurulu)' - Administrative cases
     
     Returns structured search results with comprehensive metadata.
     Use get_danistay_document_markdown() for full decision texts.
-    For complete Danıştay coverage, also use search_danistay_by_keyword and search_danistay_bedesten.
+    For complete Council of State (Danıştay) coverage, also use search_danistay_by_keyword and search_danistay_bedesten.
     """
     
     search_query = DanistayDetailedSearchRequest(
@@ -457,7 +457,7 @@ async def search_danistay_detailed(
         raise
 
 @app.tool(
-    description="Retrieve the full text of a specific Danıştay decision from the primary official API in Markdown format",
+    description="Retrieve the full text of a specific Council of State (Danıştay) decision from the primary official API in Markdown format",
     annotations={
         "readOnlyHint": True,
         "idempotentHint": True
@@ -465,14 +465,14 @@ async def search_danistay_detailed(
 )
 async def get_danistay_document_markdown(id: str) -> DanistayDocumentMarkdown:
     """
-    Retrieves the full text of a specific Danıştay decision from the primary official API in Markdown format.
+    Retrieves the full text of a specific Council of State (Danıştay) decision from the primary official API in Markdown format.
     
     This tool fetches complete administrative court decision documents and converts them to clean,
     readable Markdown format suitable for detailed legal analysis and administrative law research.
     
     Input Requirements:
     • id: Decision ID from search_danistay_by_keyword or search_danistay_detailed results
-    • ID must be non-empty string from official Danıştay database
+    • ID must be non-empty string from official Council of State (Danıştay) database
     
     Output Format:
     • Clean Markdown text with administrative legal structure preserved
@@ -482,18 +482,18 @@ async def get_danistay_document_markdown(id: str) -> DanistayDocumentMarkdown:
     
     Administrative Court Decision Content:
     • Complete administrative law reasoning and precedent analysis
-    • Review of administrative actions and government decisions
+    • Review of administrative actions (idari işlemler) and government decisions
     • Citation of relevant administrative laws and regulations
-    • Final administrative ruling with legal justification
+    • Final administrative ruling (karar) with legal justification
     • Analysis of public administration procedures
     
     Use for:
     • Reading full administrative court decision texts
-    • Administrative law research and precedent analysis
+    • Administrative law research and precedent (emsal) analysis
     • Government action review and compliance research
     • Understanding administrative law principles
     • Academic and professional administrative law study
-    • Regulatory compliance and permit/license law analysis
+    • Regulatory compliance and permit/license (ruhsat/izin) law analysis
     """
     logger.info(f"Tool 'get_danistay_document_markdown' called for ID: {id}")
     if not id or not id.strip(): raise ValueError("Document ID must be a non-empty string for Danıştay.")
@@ -505,7 +505,7 @@ async def get_danistay_document_markdown(id: str) -> DanistayDocumentMarkdown:
 
 # --- MCP Tools for Emsal ---
 @app.tool(
-    description="Search Emsal (UYAP Precedent) decisions using detailed criteria including court selection, case numbers, and date ranges for comprehensive precedent research across Turkish courts",
+    description="Search Precedent (Emsal) decisions using detailed criteria including court selection, case numbers, and date ranges for comprehensive precedent research across Turkish courts through UYAP system",
     annotations={
         "readOnlyHint": True,
         "openWorldHint": True,
@@ -531,17 +531,17 @@ async def search_emsal_detailed_decisions(
     page_size: int = Field(10, ge=1, le=100, description="Results per page.")
 ) -> CompactEmsalSearchResult:
     """
-    Searches for Emsal (UYAP Precedent) decisions using detailed criteria.
+    Searches for Precedent (Emsal) decisions using detailed criteria.
     
-    Emsal database contains precedent decisions from various Turkish courts integrated through
+    The Precedent (Emsal) database contains precedent decisions from various Turkish courts
-    the UYAP (National Judiciary Informatics System). This tool provides access to a comprehensive
+    integrated through the UYAP (National Judiciary Informatics System). This tool provides
-    collection of court decisions that serve as legal precedents.
+    access to a comprehensive collection of court decisions that serve as legal precedents.
     
     Key Features:
     • Multi-court coverage (BAM, Civil courts, Regional chambers)
     • Keyword-based search across decision texts
     • Court-specific filtering for targeted research
-    • Case number filtering (Esas No and Karar No with ranges)
+    • Case number filtering (Case No (Esas No) and Decision No (Karar No) with ranges)
     • Date range filtering with DD.MM.YYYY format
     • Multiple sorting options and pagination support
     
@@ -551,7 +551,7 @@ async def search_emsal_detailed_decisions(
     • Regional Civil Chambers: Specialized civil court departments
     
     Precedent Research Use Cases:
-    • Find precedent decisions across multiple court levels
+    • Find precedent (emsal) decisions across multiple court levels
     • Research court interpretations of specific legal concepts
     • Analyze consistent legal reasoning patterns
     • Study regional variations in legal decisions
@@ -604,7 +604,7 @@ async def search_emsal_detailed_decisions(
         raise
 
 @app.tool(
-    description="Retrieve the full text of a specific Emsal (UYAP Precedent) decision in Markdown format",
+    description="Retrieve the full text of a specific Precedent (Emsal) decision in Markdown format from UYAP system",
     annotations={
         "readOnlyHint": True,
         "idempotentHint": True
@@ -652,7 +652,7 @@ async def get_emsal_document_markdown(id: str) -> EmsalDocumentMarkdown:
 
 # --- MCP Tools for Uyusmazlik ---
 @app.tool(
-    description="Search Uyuşmazlık Mahkemesi (Court of Jurisdictional Disputes) decisions with comprehensive filtering for dispute resolution between different court systems",
+    description="Search Court of Jurisdictional Disputes (Uyuşmazlık Mahkemesi) decisions with comprehensive filtering for dispute resolution between different court systems",
     annotations={
         "readOnlyHint": True,
         "openWorldHint": True,
@@ -680,9 +680,9 @@ async def search_uyusmazlik_decisions(
     not_hepsi: str = Field("", description="Exclude texts containing these specified words.")
 ) -> UyusmazlikSearchResponse:
     """
-    Searches for Uyuşmazlık Mahkemesi (Court of Jurisdictional Disputes) decisions.
+    Searches for Court of Jurisdictional Disputes (Uyuşmazlık Mahkemesi) decisions.
     
-    Uyuşmazlık Mahkemesi resolves jurisdictional disputes between different court systems
+    The Court of Jurisdictional Disputes (Uyuşmazlık Mahkemesi) resolves jurisdictional disputes between different court systems
     in Turkey, determining which court has jurisdiction over specific cases. This specialized
     court handles conflicts between civil, criminal, and administrative jurisdictions.
     
@@ -695,13 +695,13 @@ async def search_uyusmazlik_decisions(
     • Official Gazette reference search
     
     Dispute Types:
-    • Görev Uyuşmazlığı: Jurisdictional disputes (which court has authority)
+    • Jurisdictional Disputes (Görev Uyuşmazlığı): Which court has authority
-    • Hüküm Uyuşmazlığı: Judgment disputes (conflicting final decisions)
+    • Judgment Disputes (Hüküm Uyuşmazlığı): Conflicting final decisions
     
     Departments:
-    • Ceza Bölümü: Criminal section decisions
+    • Criminal Section (Ceza Bölümü): Criminal section decisions
-    • Hukuk Bölümü: Civil section decisions  
+    • Civil Section (Hukuk Bölümü): Civil section decisions  
-    • Genel Kurul Kararları: General Assembly decisions
+    • General Assembly Decisions (Genel Kurul Kararları): General Assembly decisions
     
     Advanced Search Options:
     • tumce: Exact phrase matching
@@ -755,7 +755,7 @@ async def search_uyusmazlik_decisions(
         raise
 
 @app.tool(
-    description="Retrieve the full text of a specific Uyuşmazlık Mahkemesi decision from its URL in Markdown format",
+    description="Retrieve the full text of a specific Court of Jurisdictional Disputes (Uyuşmazlık Mahkemesi) decision from its URL in Markdown format",
     annotations={
         "readOnlyHint": True,
         "idempotentHint": True
@@ -1116,7 +1116,7 @@ async def get_anayasa_bireysel_basvuru_document_markdown(
 
 # --- MCP Tools for KIK (Kamu İhale Kurulu) ---
 @app.tool(
-    description="Search KIK (Public Procurement Authority) decisions with comprehensive filtering for public procurement law and administrative dispute research",
+    description="Search Public Procurement Authority (Kamu İhale Kurulu - KIK) decisions with comprehensive filtering for public procurement law and administrative dispute research",
     annotations={
         "readOnlyHint": True,
         "openWorldHint": True,
@@ -1138,9 +1138,9 @@ async def search_kik_decisions(
     page: int = Field(1, ge=1, description="Results page number.")
 ) -> KikSearchResult:
     """
-    Searches KIK (Public Procurement Authority) decisions with comprehensive filtering.
+    Searches Public Procurement Authority (Kamu İhale Kurulu - KIK) decisions with comprehensive filtering.
     
-    KIK is Turkey's public procurement regulatory authority, responsible for overseeing
+    The Public Procurement Authority (KIK) is Turkey's public procurement regulatory authority, responsible for overseeing
     government procurement processes and resolving procurement-related disputes. This tool
     provides access to official procurement decisions and regulatory interpretations.
     
@@ -1208,7 +1208,7 @@ async def search_kik_decisions(
         return KikSearchResult(decisions=[], total_records=0, current_page=current_page_val)
 
 @app.tool(
-    description="Retrieve the full text of a KIK (Public Procurement Authority) decision in paginated Markdown format",
+    description="Retrieve the full text of a Public Procurement Authority (KIK) decision in paginated Markdown format",
     annotations={
         "readOnlyHint": True,
         "idempotentHint": True
@@ -1279,7 +1279,7 @@ async def get_kik_document_markdown(
             is_paginated=False
         )
 @app.tool(
-    description="Search Turkish Competition Authority (Rekabet Kurumu) decisions with comprehensive filtering for competition law and antitrust research",
+    description="Search Competition Authority (Rekabet Kurumu) decisions with comprehensive filtering for competition law and antitrust research",
     annotations={
         "readOnlyHint": True,
         "openWorldHint": True,
@@ -1306,9 +1306,9 @@ async def search_rekabet_kurumu_decisions(
     page: int = Field(1, ge=1, description="Page number to fetch for the results list.")
 ) -> RekabetSearchResult:
     """
-    Searches Turkish Competition Authority (Rekabet Kurumu) decisions with comprehensive filtering.
+    Searches Competition Authority (Rekabet Kurumu) decisions with comprehensive filtering.
     
-    Rekabet Kurumu is Turkey's competition authority, responsible for enforcing antitrust laws,
+    The Competition Authority (Rekabet Kurumu) is Turkey's competition authority, responsible for enforcing antitrust laws,
     preventing anti-competitive practices, and regulating mergers and acquisitions. This tool
     provides access to official competition law decisions and regulatory interpretations.
     
@@ -1383,7 +1383,7 @@ async def search_rekabet_kurumu_decisions(
         return RekabetSearchResult(decisions=[], retrieved_page_number=page, total_records_found=0, total_pages=0)
 
 @app.tool(
-    description="Retrieve the full text of a Turkish Competition Authority decision in paginated Markdown format converted from PDF",
+    description="Retrieve the full text of a Competition Authority (Rekabet Kurumu) decision in paginated Markdown format converted from PDF",
     annotations={
         "readOnlyHint": True,
         "idempotentHint": True
@@ -1440,7 +1440,7 @@ async def get_rekabet_kurumu_document(
 
 # --- MCP Tools for Bedesten (Alternative Yargitay Search) ---
 @app.tool(
-    description="Search Yargıtay (Court of Cassation) decisions using the Bedesten API - an alternative data source that complements the primary Yargıtay API. This tool provides access to recent decisions with advanced filtering capabilities including chamber selection, date ranges, and exact phrase matching. Use this alongside search_yargitay_detailed for comprehensive coverage.",
+    description="Search Court of Cassation (Yargıtay) decisions using the Bedesten API - an alternative data source that complements the primary Court of Cassation API. This tool provides access to recent decisions with advanced filtering capabilities including chamber selection, date ranges, and exact phrase matching. Use this alongside search_yargitay_detailed for comprehensive coverage.",
     annotations={
         "readOnlyHint": True,
         "openWorldHint": True,
@@ -1543,7 +1543,7 @@ async def get_yargitay_bedesten_document_markdown(
 
 # --- MCP Tools for Bedesten (Alternative Danıştay Search) ---
 @app.tool(
-    description="Search Danıştay (Council of State) decisions using the Bedesten API - a powerful alternative data source. This tool provides access to administrative court decisions with comprehensive filtering options including chamber selection (27 options), date ranges, and exact phrase matching. Use this alongside search_danistay_by_keyword and search_danistay_detailed for complete coverage of administrative law decisions.",
+    description="Search Council of State (Danıştay) decisions using the Bedesten API - a powerful alternative data source. This tool provides access to administrative court decisions with comprehensive filtering options including chamber (daire) selection (27 options), date ranges, and exact phrase matching. Use this alongside search_danistay_by_keyword and search_danistay_detailed for complete coverage of administrative law decisions.",
     annotations={
         "readOnlyHint": True,
         "openWorldHint": True,
@@ -1643,7 +1643,7 @@ async def get_danistay_bedesten_document_markdown(
 
 # --- MCP Tools for Bedesten (Yerel Hukuk Mahkemesi Search) ---
 @app.tool(
-    description="Search local civil court (Yerel Hukuk Mahkemesi) decisions using the Bedesten API. This is the primary and only available tool for accessing local court decisions, which represent the first instance of civil litigation in Turkey. Supports advanced search features including date filtering and exact phrase matching for precise legal research.",
+    description="Search Local Civil Courts (Yerel Hukuk Mahkemeleri) decisions using the Bedesten API. This is the primary and only available tool for accessing local court decisions, which represent the first instance of civil litigation in Turkey. Supports advanced search features including date filtering and exact phrase matching for precise legal research.",
     annotations={
         "readOnlyHint": True,
         "openWorldHint": True,
@@ -1733,7 +1733,7 @@ async def get_yerel_hukuk_bedesten_document_markdown(
 
 # --- MCP Tools for Bedesten (İstinaf Hukuk Mahkemesi Search) ---
 @app.tool(
-    description="Search İstinaf Hukuk Mahkemesi (Civil Court of Appeals) decisions using Bedesten API with advanced filtering options including date range and exact phrase search capabilities",
+    description="Search Civil Courts of Appeals (İstinaf Hukuk Mahkemeleri) decisions using Bedesten API with advanced filtering options including date range and exact phrase search capabilities",
     annotations={
         "readOnlyHint": True,
         "openWorldHint": True,
@@ -1853,7 +1853,7 @@ async def get_istinaf_hukuk_bedesten_document_markdown(
 
 # --- MCP Tools for Bedesten (Kanun Yararına Bozma Search) ---
 @app.tool(
-    description="Search Kanun Yararına Bozma (KYB - Extraordinary Appeal) decisions using Bedesten API with date filtering and exact phrase search support",
+    description="Search Extraordinary Appeal (Kanun Yararına Bozma - KYB) decisions using Bedesten API with date filtering and exact phrase search support"
     annotations={
         "readOnlyHint": True,
         "openWorldHint": True,

yargitay_mcp_module/models.py

@@ -41,18 +41,18 @@ class YargitayDetailedSearchRequest(BaseModel):
         • Wildcards: 'bozma*' (matches bozma, bozması, bozmanın, etc.)
         • Multiple required: '+"arsa payı" +"bozma sebebi"'
         • Exclusion: '+"arsa payı" -"inşaat sözleşmesi"'
-        Examples: arsa payı | "arsa payı" | +"property right" +"cancellation reason" | legal*""")
+        Examples: arsa payı | "arsa payı" | +"mülkiyet hakkı" +"bozma sebebi" | hukuk*""")
-    # Department/Board selection - Complete Yargıtay chamber hierarchy
+    # Department/Board selection - Complete Court of Cassation chamber hierarchy
     birimYrgKurulDaire: YargitayBirimEnum = Field("", description="""
-        Yargıtay chamber/board selection. Options include:
+        Court of Cassation (Yargıtay) chamber/board selection. Options include:
         - Empty string ('') for ALL chambers
-        - Civil: 'Hukuk Genel Kurulu', '1. Hukuk Dairesi' through '23. Hukuk Dairesi', 'Hukuk Daireleri Başkanlar Kurulu'
+        - Civil: 'Civil General Assembly (Hukuk Genel Kurulu)', '1st Civil Chamber (1. Hukuk Dairesi)' through '23rd Civil Chamber (23. Hukuk Dairesi)', 'Civil Chambers Presidents Board (Hukuk Daireleri Başkanlar Kurulu)'
-        - Criminal: 'Ceza Genel Kurulu', '1. Ceza Dairesi' through '23. Ceza Dairesi', 'Ceza Daireleri Başkanlar Kurulu'
+        - Criminal: 'Criminal General Assembly (Ceza Genel Kurulu)', '1st Criminal Chamber (1. Ceza Dairesi)' through '23rd Criminal Chamber (23. Ceza Dairesi)', 'Criminal Chambers Presidents Board (Ceza Daireleri Başkanlar Kurulu)'
-        - General: 'Büyük Genel Kurulu'
+        - General: 'Grand General Assembly (Büyük Genel Kurulu)'
-        Total: 49 possible values (including empty string for all chambers)
+        Total: 52 possible values (including empty string for all chambers)
     """)
-    birimYrgHukukDaire: Optional[str] = Field("", description="Legacy field - use birimYrgKurulDaire instead")
+    birimYrgHukukDaire: Optional[str] = Field("", description="Legacy field - use birimYrgKurulDaire instead for chamber selection")
-    birimYrgCezaDaire: Optional[str] = Field("", description="Legacy field - use birimYrgKurulDaire instead")
+    birimYrgCezaDaire: Optional[str] = Field("", description="Legacy field - use birimYrgKurulDaire instead for chamber selection")
     
     esasYil: Optional[str] = Field("", description="""Case year for 'Esas No' filtering. 
         Format: YYYY (e.g., '2024')
@@ -105,15 +105,15 @@ class YargitayDetailedSearchRequest(BaseModel):
 class YargitayApiDecisionEntry(BaseModel):
     """Model for an individual decision entry from the Yargitay API search response."""
     id: str # Unique system ID of the decision
-    daire: Optional[str] = Field(None, description="The chamber that made the decision.")
+    daire: Optional[str] = Field(None, description="The chamber (Daire) that made the decision.")
-    esasNo: Optional[str] = Field(None, alias="esasNo", description="Case registry number ('Esas No').")
+    esasNo: Optional[str] = Field(None, alias="esasNo", description="Case registry number (Esas No).")
-    kararNo: Optional[str] = Field(None, alias="kararNo", description="Decision number ('Karar No').")
+    kararNo: Optional[str] = Field(None, alias="kararNo", description="Decision number (Karar No).")
-    kararTarihi: Optional[str] = Field(None, alias="kararTarihi", description="Date of the decision.")
+    kararTarihi: Optional[str] = Field(None, alias="kararTarihi", description="Date of the decision (Karar Tarihi).")
-    arananKelime: Optional[str] = Field(None, alias="arananKelime", description="Matched keyword in the search result item.")
+    arananKelime: Optional[str] = Field(None, alias="arananKelime", description="Matched keyword (Aranan Kelime) in the search result item.")
     # 'index' and 'siraNo' from API response are not critical for MCP tool, so omitted for brevity
     
     # This field will be populated by the client after fetching the search list
-    document_url: Optional[HttpUrl] = Field(None, description="Direct URL to the decision document.")
+    document_url: Optional[HttpUrl] = Field(None, description="Direct URL (Belge URL) to the decision document.")
 
     class Config:
         populate_by_name = True # To allow populating by alias from API response
@@ -133,9 +133,9 @@ class YargitayApiSearchResponse(BaseModel):
 
 class YargitayDocumentMarkdown(BaseModel):
     """Model for a Yargitay decision document, containing only Markdown content."""
-    id: str = Field(..., description="The unique ID of the document.")
+    id: str = Field(..., description="The unique ID (Belge Kimliği) of the document.")
-    markdown_content: Optional[str] = Field(None, description="The decision content converted to Markdown.")
+    markdown_content: Optional[str] = Field(None, description="The decision content (Karar İçeriği) converted to Markdown.")
-    source_url: HttpUrl = Field(..., description="The source URL of the original document.")
+    source_url: HttpUrl = Field(..., description="The source URL (Kaynak URL) of the original document.")
 
 class CompactYargitaySearchResult(BaseModel):
     """A more compact search result model for the MCP tool to return."""