saidsurucu
9b43070754
Applied automatic fixes for 315 out of 597 linting errors: - Remove unused imports (F401) - Fix f-string without placeholders (F541) - Split multiple imports (E401) - Remove redundant import aliases Remaining 272 errors are mostly style issues: - 164 E701: Multiple statements on one line (colon) - 70 E402: Module import not at top of file - 13 F841: Unused variables - Various other style warnings Code functionality unchanged - all fixes are cosmetic improvements.
1679 lines
76 KiB
Python
1679 lines
76 KiB
Python
"""
|
||
FastAPI Comprehensive Endpoints with Complete MCP Documentation
|
||
This is the complete version with all descriptions and docstrings from MCP server.
|
||
"""
|
||
|
||
import os
|
||
from typing import List, Dict, Any, Optional
|
||
from datetime import datetime
|
||
|
||
from fastapi import FastAPI, HTTPException, Query
|
||
from fastapi.middleware.cors import CORSMiddleware
|
||
from pydantic import BaseModel, Field
|
||
|
||
# Import the main MCP app
|
||
from mcp_server_main import app as mcp_server
|
||
|
||
# Create MCP ASGI app
|
||
mcp_asgi_app = mcp_server.http_app(path="/mcp")
|
||
|
||
# Create FastAPI app with MCP lifespan
|
||
app = FastAPI(
|
||
title="Yargı MCP API - Turkish Legal Database REST API",
|
||
description="""
|
||
Comprehensive REST API for Turkish Legal Databases with complete MCP tool coverage.
|
||
|
||
This API provides access to 8 major Turkish legal institutions including:
|
||
• Yargıtay (Court of Cassation) - Supreme civil/criminal court
|
||
• Danıştay (Council of State) - Supreme administrative court
|
||
• Constitutional Court - Constitutional review and individual applications
|
||
• Competition Authority - Antitrust and merger decisions
|
||
• Public Procurement Authority - Government contracting disputes
|
||
• Court of Accounts - Public audit and accountability
|
||
• Emsal (UYAP Precedents) - Cross-court precedent database
|
||
• Local and Appellate Courts - First and second instance decisions
|
||
|
||
Features complete coverage of 33 MCP tools with enhanced documentation,
|
||
typed request models, and comprehensive legal context.
|
||
|
||
Tool Properties (from MCP annotations):
|
||
• Read-only: All tools are read-only and do not modify system state
|
||
• Idempotent: Same inputs produce same outputs for reliable research
|
||
• Open-world search: Search tools explore comprehensive legal databases
|
||
• Deterministic document retrieval: Document tools return consistent content
|
||
""",
|
||
version="1.0.0",
|
||
lifespan=mcp_asgi_app.lifespan
|
||
)
|
||
|
||
# Add CORS middleware
|
||
cors_origins = os.getenv("ALLOWED_ORIGINS", "*").split(",")
|
||
app.add_middleware(
|
||
CORSMiddleware,
|
||
allow_origins=cors_origins,
|
||
allow_credentials=True,
|
||
allow_methods=["*"],
|
||
allow_headers=["*"],
|
||
)
|
||
|
||
# Mount MCP server
|
||
app.mount("/mcp-server", mcp_asgi_app)
|
||
|
||
# Response models (keeping from original)
|
||
class ToolInfo(BaseModel):
|
||
name: str
|
||
description: str
|
||
parameters: Dict[str, Any]
|
||
|
||
class ServerInfo(BaseModel):
|
||
name: str
|
||
version: str
|
||
description: str
|
||
tools_count: int
|
||
databases: List[str]
|
||
mcp_endpoint: str
|
||
api_docs: str
|
||
|
||
class HealthCheck(BaseModel):
|
||
status: str
|
||
timestamp: datetime
|
||
uptime_seconds: Optional[float] = None
|
||
tools_operational: bool
|
||
|
||
# Track server start time
|
||
SERVER_START_TIME = datetime.now()
|
||
|
||
# MCP tool caller helper
|
||
async def call_mcp_tool(tool_name: str, arguments: Dict[str, Any]):
|
||
"""Call an MCP tool with given arguments"""
|
||
try:
|
||
tool = mcp_server._tool_manager._tools.get(tool_name)
|
||
if not tool:
|
||
raise HTTPException(status_code=404, detail=f"Tool '{tool_name}' not found")
|
||
result = await tool.fn(**arguments)
|
||
return result
|
||
except Exception as e:
|
||
raise HTTPException(status_code=500, detail=f"Tool execution failed: {str(e)}")
|
||
|
||
# ============================================================================
|
||
# COMPREHENSIVE REQUEST MODELS WITH FULL MCP DOCUMENTATION
|
||
# ============================================================================
|
||
|
||
class YargitaySearchRequest(BaseModel):
|
||
"""
|
||
Search request for Court of Cassation (Yargıtay) decisions using primary official API.
|
||
|
||
The Court of Cassation is Turkey's highest court for civil and criminal matters,
|
||
equivalent to a Supreme Court. Provides access to comprehensive supreme court precedents.
|
||
"""
|
||
arananKelime: str = Field(
|
||
...,
|
||
description="""Keyword to search for with advanced operators:
|
||
• Space between words = OR logic (arsa payı → "arsa" OR "payı")
|
||
• "exact phrase" = Exact match ("arsa payı" → exact phrase)
|
||
• word1+word2 = AND logic (arsa+payı → both words required)
|
||
• word* = Wildcard (bozma* → bozma, bozması, bozmanın, etc.)
|
||
• +"phrase1" +"phrase2" = Multiple required phrases
|
||
• +"required" -"excluded" = Include and exclude
|
||
|
||
Turkish Examples:
|
||
• Simple OR: arsa payı (~523K results)
|
||
• Exact phrase: "arsa payı" (~22K results)
|
||
• Multiple AND: +"arsa payı" +"bozma sebebi" (~234 results)
|
||
• Wildcard: bozma* (bozma, bozması, bozmanın, etc.)
|
||
• Exclude: +"arsa payı" -"kira sözleşmesi"
|
||
""",
|
||
example='+"mülkiyet hakkı" +"iptal"'
|
||
)
|
||
birimYrgKurulDaire: Optional[str] = Field(
|
||
"",
|
||
description="""Chamber/board selection (52 options):
|
||
Civil Chambers: 1-23. Hukuk Dairesi
|
||
Criminal Chambers: 1-23. Ceza Dairesi
|
||
General Assemblies: Hukuk Genel Kurulu, Ceza Genel Kurulu
|
||
Special Boards: Hukuk/Ceza Daireleri Başkanlar Kurulu, Büyük Genel Kurulu
|
||
|
||
Use "" for ALL chambers or specify exact chamber name.
|
||
""",
|
||
example="1. Hukuk Dairesi"
|
||
)
|
||
baslangicTarihi: Optional[str] = Field(None, description="Start date (DD.MM.YYYY)", example="01.01.2020")
|
||
bitisTarihi: Optional[str] = Field(None, description="End date (DD.MM.YYYY)", example="31.12.2024")
|
||
pageSize: int = Field(20, description="Results per page (1-100)", ge=1, le=100, example=20)
|
||
|
||
class YargitayBedestenSearchRequest(BaseModel):
|
||
"""
|
||
Search request for Court of Cassation using Bedesten API (alternative source).
|
||
Complements primary API with different search capabilities and recent decisions.
|
||
"""
|
||
phrase: str = Field(
|
||
...,
|
||
description="""Aranacak kavram/kelime. İki farklı arama türü desteklenir:
|
||
• Normal arama: "mülkiyet hakkı" - kelimeler ayrı ayrı aranır
|
||
• Tam cümle arama: "\"mülkiyet hakkı\"" - tırnak içindeki ifade aynen aranır
|
||
Tam cümle aramalar daha kesin sonuçlar verir.
|
||
|
||
Search phrase with exact matching support:
|
||
• Regular search: "mülkiyet hakkı" - searches individual words separately
|
||
• Exact phrase search: "\"mülkiyet hakkı\"" - searches for exact phrase as unit
|
||
Exact phrase search provides more precise results with fewer false positives.
|
||
""",
|
||
example="\"mülkiyet hakkı\""
|
||
)
|
||
birimAdi: Optional[str] = Field(
|
||
None,
|
||
description="""Daire/Kurul seçimi (52 seçenek - ana API ile aynı):
|
||
• Hukuk daireleri: 1. Hukuk Dairesi - 23. Hukuk Dairesi
|
||
• Ceza daireleri: 1. Ceza Dairesi - 23. Ceza Dairesi
|
||
• Genel kurullar: Hukuk Genel Kurulu, Ceza Genel Kurulu
|
||
• Özel kurullar: Hukuk/Ceza Daireleri Başkanlar Kurulu, Büyük Genel Kurulu
|
||
|
||
Chamber filtering (52 options - same as primary API):
|
||
• Civil chambers: 1. Hukuk Dairesi through 23. Hukuk Dairesi
|
||
• Criminal chambers: 1. Ceza Dairesi through 23. Ceza Dairesi
|
||
• General assemblies: Hukuk Genel Kurulu, Ceza Genel Kurulu
|
||
• Special boards: Hukuk/Ceza Daireleri Başkanlar Kurulu, Büyük Genel Kurulu
|
||
|
||
Use None for ALL chambers, or specify exact chamber name.
|
||
""",
|
||
example="1. Hukuk Dairesi"
|
||
)
|
||
kararTarihiStart: Optional[str] = Field(
|
||
None,
|
||
description="""Karar başlangıç tarihi (ISO 8601 formatı):
|
||
Format: YYYY-MM-DDTHH:MM:SS.000Z
|
||
Örnek: "2024-01-01T00:00:00.000Z" - 1 Ocak 2024'ten itibaren kararlar
|
||
kararTarihiEnd ile birlikte tarih aralığı filtrelemesi için kullanılır.
|
||
|
||
Decision start date filter (ISO 8601 format):
|
||
Format: YYYY-MM-DDTHH:MM:SS.000Z
|
||
Example: "2024-01-01T00:00:00.000Z" for decisions from Jan 1, 2024
|
||
Use with kararTarihiEnd for date range filtering.
|
||
""",
|
||
example="2024-01-01T00:00:00.000Z"
|
||
)
|
||
kararTarihiEnd: Optional[str] = Field(
|
||
None,
|
||
description="""Karar bitiş tarihi (ISO 8601 formatı):
|
||
Format: YYYY-MM-DDTHH:MM:SS.000Z
|
||
Örnek: "2024-12-31T23:59:59.999Z" - 31 Aralık 2024'e kadar kararlar
|
||
kararTarihiStart ile birlikte tarih aralığı filtrelemesi için kullanılır.
|
||
|
||
Decision end date filter (ISO 8601 format):
|
||
Format: YYYY-MM-DDTHH:MM:SS.000Z
|
||
Example: "2024-12-31T23:59:59.999Z" for decisions until Dec 31, 2024
|
||
Use with kararTarihiStart for date range filtering.
|
||
""",
|
||
example="2024-12-31T23:59:59.999Z"
|
||
)
|
||
pageSize: int = Field(20, description="Results per page (1-100)", ge=1, le=100)
|
||
|
||
class DanistayKeywordSearchRequest(BaseModel):
|
||
"""
|
||
Keyword-based search for Council of State (Danıştay) decisions with Boolean logic.
|
||
|
||
The Council of State is Turkey's highest administrative court, providing final
|
||
rulings on administrative law matters with Boolean keyword operators.
|
||
"""
|
||
andKelimeler: List[str] = Field(
|
||
...,
|
||
description="ALL keywords must be present (AND logic)",
|
||
example=["idari işlem", "iptal"]
|
||
)
|
||
orKelimeler: Optional[List[str]] = Field(
|
||
None,
|
||
description="ANY keyword can be present (OR logic)",
|
||
example=["ruhsat", "izin", "lisans"]
|
||
)
|
||
notKelimeler: Optional[List[str]] = Field(
|
||
None,
|
||
description="EXCLUDE if keywords present (NOT logic)",
|
||
example=["vergi"]
|
||
)
|
||
pageSize: int = Field(20, description="Results per page (1-100)", ge=1, le=100)
|
||
|
||
class DanistayDetailedSearchRequest(BaseModel):
|
||
"""
|
||
Detailed search for Council of State decisions with comprehensive filtering.
|
||
Provides the most comprehensive search capabilities for administrative court decisions.
|
||
"""
|
||
daire: Optional[str] = Field(
|
||
None,
|
||
description="Chamber/Department filter (1. Daire through 17. Daire, special councils)",
|
||
example="3. Daire"
|
||
)
|
||
baslangicTarihi: Optional[str] = Field(None, description="Start date (DD.MM.YYYY)", example="01.01.2020")
|
||
bitisTarihi: Optional[str] = Field(None, description="End date (DD.MM.YYYY)", example="31.12.2024")
|
||
esas: Optional[str] = Field(None, description="Case number (Esas No)", example="2024/123")
|
||
karar: Optional[str] = Field(None, description="Decision number (Karar No)", example="2024/456")
|
||
|
||
class DanistayBedestenSearchRequest(BaseModel):
|
||
"""
|
||
Council of State search using Bedesten API with chamber filtering and exact phrase search.
|
||
Provides access to administrative court decisions with 27 chamber options.
|
||
"""
|
||
phrase: str = Field(..., description="Search phrase (supports exact matching with quotes)")
|
||
birimAdi: Optional[str] = Field(
|
||
None,
|
||
description="""Chamber filtering (27 options):
|
||
Main Councils: Büyük Gen.Kur., İdare Dava Daireleri Kurulu, Vergi Dava Daireleri Kurulu
|
||
Chambers: 1. Daire through 17. Daire
|
||
Military: Askeri Yüksek İdare Mahkemesi chambers
|
||
""",
|
||
example="3. Daire"
|
||
)
|
||
kararTarihiStart: Optional[str] = Field(None, description="Start date (ISO 8601)")
|
||
kararTarihiEnd: Optional[str] = Field(None, description="End date (ISO 8601)")
|
||
pageSize: int = Field(20, description="Results per page", ge=1, le=100)
|
||
|
||
class EmsalSearchRequest(BaseModel):
|
||
"""
|
||
Search Precedent (Emsal) decisions from UYAP system across multiple court levels.
|
||
Provides access to precedent decisions from various Turkish courts.
|
||
"""
|
||
keyword: str = Field(..., description="Search keyword across decision texts")
|
||
decision_year_karar: Optional[str] = Field(None, description="Decision year filter", example="2024")
|
||
results_per_page: int = Field(20, description="Results per page", ge=1, le=100)
|
||
|
||
class UyusmazlikSearchRequest(BaseModel):
|
||
"""
|
||
Search Court of Jurisdictional Disputes decisions.
|
||
Resolves jurisdictional disputes between different court systems.
|
||
"""
|
||
keywords: List[str] = Field(..., description="Search keywords", example=["görev", "uyuşmazlık"])
|
||
page_to_fetch: int = Field(1, description="Page number", ge=1)
|
||
|
||
class AnayasaNormSearchRequest(BaseModel):
|
||
"""
|
||
Search Constitutional Court norm control (judicial review) decisions.
|
||
Turkey's highest constitutional authority for reviewing law constitutionality.
|
||
"""
|
||
keywords_all: List[str] = Field(..., description="All required keywords", example=["eğitim hakkı", "anayasa"])
|
||
period: Optional[str] = Field(None, description="Constitutional period (1=1961, 2=1982)", example="2")
|
||
application_type: Optional[str] = Field(None, description="Application type (1=İptal)", example="1")
|
||
results_per_page: int = Field(20, description="Results per page", ge=1, le=100)
|
||
|
||
class AnayasaBireyselSearchRequest(BaseModel):
|
||
"""
|
||
Search Constitutional Court individual application decisions.
|
||
Human rights violation cases through individual citizen petitions.
|
||
"""
|
||
keywords: List[str] = Field(..., description="Search keywords", example=["ifade özgürlüğü", "basın"])
|
||
page_to_fetch: int = Field(1, description="Page number", ge=1)
|
||
|
||
class KikSearchRequest(BaseModel):
|
||
"""
|
||
Search Public Procurement Authority (KİK) decisions.
|
||
Government procurement disputes and regulatory interpretations.
|
||
"""
|
||
karar_tipi: Optional[str] = Field(
|
||
None,
|
||
description="Decision type (rbUyusmazlik=Disputes, rbDuzenleyici=Regulatory, rbMahkeme=Court)",
|
||
example="rbUyusmazlik"
|
||
)
|
||
karar_metni: Optional[str] = Field(None, description="Decision text search", example="ihale iptali")
|
||
basvuru_konusu_ihale: Optional[str] = Field(None, description="Tender subject", example="danışmanlık")
|
||
karar_tarihi_baslangic: Optional[str] = Field(None, description="Start date", example="01.01.2023")
|
||
|
||
class RekabetSearchRequest(BaseModel):
|
||
"""
|
||
Search Competition Authority decisions.
|
||
Antitrust, merger control, and competition law enforcement.
|
||
"""
|
||
KararTuru: Optional[str] = Field(
|
||
None,
|
||
description="Decision type (Birleşme ve Devralma, Rekabet İhlali, Muafiyet, etc.)",
|
||
example="Birleşme ve Devralma"
|
||
)
|
||
PdfText: Optional[str] = Field(
|
||
None,
|
||
description="Full-text search in decisions. Use quotes for exact phrases.",
|
||
example="\"market definition\" telecommunications"
|
||
)
|
||
YayinlanmaTarihi: Optional[str] = Field(None, description="Publication date", example="01.01.2020")
|
||
page: int = Field(1, description="Page number", ge=1)
|
||
|
||
class BedestenSearchRequest(BaseModel):
|
||
"""
|
||
Generic search request for Bedesten API courts (Yerel Hukuk, İstinaf Hukuk, KYB).
|
||
Supports exact phrase search and date filtering.
|
||
"""
|
||
phrase: str = Field(
|
||
...,
|
||
description="Search phrase. Use quotes for exact matching: \"legal term\"",
|
||
example="\"sözleşme ihlali\""
|
||
)
|
||
kararTarihiStart: Optional[str] = Field(None, description="Start date (ISO 8601)")
|
||
kararTarihiEnd: Optional[str] = Field(None, description="End date (ISO 8601)")
|
||
pageSize: int = Field(20, description="Results per page", ge=1, le=100)
|
||
|
||
class SayistaySearchRequest(BaseModel):
|
||
"""
|
||
Search Court of Accounts (Sayıştay) decisions.
|
||
Public audit, accountability, and financial oversight decisions.
|
||
"""
|
||
keywords: List[str] = Field(..., description="Search keywords", example=["mali sorumluluk", "denetim"])
|
||
page_to_fetch: int = Field(1, description="Page number", ge=1)
|
||
|
||
# ============================================================================
|
||
# BASIC SERVER ENDPOINTS (keeping from original)
|
||
# ============================================================================
|
||
|
||
@app.get("/", response_model=ServerInfo)
|
||
async def root():
|
||
"""Get comprehensive server information with database coverage"""
|
||
return ServerInfo(
|
||
name="Yargı MCP Server - Turkish Legal Database API",
|
||
version="1.0.0",
|
||
description="Complete REST API for Turkish legal databases with 33 MCP tools",
|
||
tools_count=len(mcp_server._tool_manager._tools),
|
||
databases=[
|
||
"Yargıtay (Court of Cassation) - 4 tools",
|
||
"Danıştay (Council of State) - 5 tools",
|
||
"Emsal (UYAP Precedents) - 2 tools",
|
||
"Uyuşmazlık Mahkemesi (Jurisdictional Disputes) - 2 tools",
|
||
"Anayasa Mahkemesi (Constitutional Court) - 4 tools",
|
||
"Kamu İhale Kurulu (Public Procurement) - 2 tools",
|
||
"Rekabet Kurumu (Competition Authority) - 2 tools",
|
||
"Sayıştay (Court of Accounts) - 6 tools",
|
||
"Bedesten API Courts (Local/Appellate/KYB) - 6 tools"
|
||
],
|
||
mcp_endpoint="/mcp-server/mcp/",
|
||
api_docs="/docs"
|
||
)
|
||
|
||
@app.get("/health", response_model=HealthCheck)
|
||
async def health_check():
|
||
"""Health check with comprehensive system status"""
|
||
uptime = (datetime.now() - SERVER_START_TIME).total_seconds()
|
||
return HealthCheck(
|
||
status="healthy",
|
||
timestamp=datetime.now(),
|
||
uptime_seconds=uptime,
|
||
tools_operational=len(mcp_server._tool_manager._tools) == 33
|
||
)
|
||
|
||
@app.get("/api/tools", response_model=List[ToolInfo])
|
||
async def list_tools(
|
||
search: Optional[str] = Query(None, description="Search tools by name or description"),
|
||
database: Optional[str] = Query(None, description="Filter by database name")
|
||
):
|
||
"""List all 33 MCP tools with filtering capabilities"""
|
||
tools = []
|
||
for tool in mcp_server._tool_manager._tools.values():
|
||
if search and search.lower() not in tool.name.lower() and search.lower() not in tool.description.lower():
|
||
continue
|
||
if database:
|
||
db_lower = database.lower()
|
||
if db_lower not in tool.name.lower() and db_lower not in tool.description.lower():
|
||
continue
|
||
|
||
params = {}
|
||
if hasattr(tool, 'schema') and tool.schema:
|
||
if hasattr(tool.schema, 'parameters'):
|
||
params = tool.schema.parameters
|
||
elif hasattr(tool.schema, '__annotations__'):
|
||
params = {k: str(v) for k, v in tool.schema.__annotations__.items()}
|
||
|
||
tools.append(ToolInfo(
|
||
name=tool.name,
|
||
description=tool.description,
|
||
parameters=params
|
||
))
|
||
return tools
|
||
|
||
# ============================================================================
|
||
# YARGITAY (COURT OF CASSATION) ENDPOINTS - 4 TOOLS
|
||
# ============================================================================
|
||
|
||
@app.post(
|
||
"/api/yargitay/search",
|
||
tags=["Yargıtay"],
|
||
summary="Search Court of Cassation (Primary API)",
|
||
description="""Search Turkey's Supreme Court for civil and criminal precedents using advanced operators.
|
||
|
||
Key Features:
|
||
• Advanced search: AND (+), OR (space), NOT (-), wildcards (*), exact phrases ("")
|
||
• 52 chamber options (23 Civil + 23 Criminal + General Assemblies)
|
||
• Date range filtering • Case/decision number filtering • Pagination
|
||
|
||
Search Examples:
|
||
• OR search: property share (finds ANY words)
|
||
• Exact phrase: "property share" (finds exact phrase)
|
||
• AND required: +"property share" +"annulment reason"
|
||
• Wildcard: construct* (construction, constructive, etc.)
|
||
• Exclude terms: +"property share" -"construction contract"
|
||
|
||
Use for supreme court precedent research and legal principle analysis."""
|
||
)
|
||
async def search_yargitay(request: YargitaySearchRequest):
|
||
"""
|
||
Searches Court of Cassation (Yargıtay) decisions using the primary official API.
|
||
|
||
The Court of Cassation (Yargıtay) is Turkey's highest court for civil and criminal matters,
|
||
equivalent to a Supreme Court. This tool provides access to the most comprehensive database
|
||
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 (Hukuk) + 23 Criminal (Ceza) + General Assemblies (Genel Kurullar))
|
||
• Date range filtering with DD.MM.YYYY format
|
||
• 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 ("property share" finds ANY of the words)
|
||
• "Quotes": Exact phrase search ("property share" finds exact phrase)
|
||
• Plus sign (+): AND search (property+share requires both words)
|
||
• Asterisk (*): Wildcard (construct* matches variations)
|
||
• Minus sign (-): Exclude terms (avoid unwanted results)
|
||
|
||
Common Search Patterns:
|
||
• Simple OR: property share (finds ~523K results)
|
||
• Exact phrase: "property share" (finds ~22K results)
|
||
• Multiple required: +"property share" +"annulment reason (bozma sebebi)" (finds ~234 results)
|
||
• Wildcard expansion: construct* (matches construction, constructive, etc.)
|
||
• Exclude unwanted: +"property share" -"construction contract"
|
||
|
||
Use cases:
|
||
• Research supreme court precedents and legal principles
|
||
• 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
|
||
|
||
Returns structured search results with decision metadata. Use get_yargitay_document_markdown()
|
||
to retrieve full decision texts for detailed analysis.
|
||
"""
|
||
args = {
|
||
"arananKelime": request.arananKelime,
|
||
"birimYrgKurulDaire": request.birimYrgKurulDaire,
|
||
"pageSize": request.pageSize
|
||
}
|
||
if request.baslangicTarihi:
|
||
args["baslangicTarihi"] = request.baslangicTarihi
|
||
if request.bitisTarihi:
|
||
args["bitisTarihi"] = request.bitisTarihi
|
||
return await call_mcp_tool("search_yargitay_detailed", args)
|
||
|
||
@app.post(
|
||
"/api/yargitay/search-bedesten",
|
||
tags=["Yargıtay"],
|
||
summary="Search Court of Cassation (Bedesten API)",
|
||
description="""Alternative Court of Cassation search with exact phrase matching and recent decisions.
|
||
|
||
Key Features:
|
||
• Exact phrase search: "\"legal term\"" for precise matching
|
||
• Regular search: "legal term" for individual word matching
|
||
• 52 chamber filtering options (same as primary API)
|
||
• ISO 8601 date filtering • Recent decision coverage
|
||
|
||
Use alongside primary search for comprehensive coverage. Exact phrase search provides
|
||
higher precision with fewer false positives."""
|
||
)
|
||
async def search_yargitay_bedesten(request: YargitayBedestenSearchRequest):
|
||
"""Search Court of Cassation using Bedesten API. Complements primary API for complete coverage."""
|
||
args = {"phrase": request.phrase, "pageSize": request.pageSize}
|
||
if request.birimAdi:
|
||
args["birimAdi"] = request.birimAdi
|
||
if request.kararTarihiStart:
|
||
args["kararTarihiStart"] = request.kararTarihiStart
|
||
if request.kararTarihiEnd:
|
||
args["kararTarihiEnd"] = request.kararTarihiEnd
|
||
return await call_mcp_tool("search_yargitay_bedesten", args)
|
||
|
||
@app.get(
|
||
"/api/yargitay/document/{decision_id}",
|
||
tags=["Yargıtay"],
|
||
summary="Get Court of Cassation Document (Primary API)",
|
||
description="""Retrieve complete Court of Cassation decision in Markdown format.
|
||
|
||
Content includes:
|
||
• Complete legal reasoning and precedent analysis
|
||
• Detailed examination of lower court decisions
|
||
• Citations of laws, regulations, and prior cases
|
||
• Final ruling with legal justification
|
||
|
||
Perfect for detailed legal analysis, precedent research, and citation building."""
|
||
)
|
||
async def get_yargitay_document(decision_id: str):
|
||
"""Get full Court of Cassation decision text in clean Markdown format."""
|
||
return await call_mcp_tool("get_yargitay_document_markdown", {"id": decision_id})
|
||
|
||
@app.get(
|
||
"/api/yargitay/bedesten-document/{document_id}",
|
||
tags=["Yargıtay"],
|
||
summary="Get Court of Cassation Document (Bedesten API)",
|
||
description="""Retrieve Court of Cassation decision from Bedesten API in Markdown format.
|
||
|
||
Features:
|
||
• Supports both HTML and PDF source documents
|
||
• Clean Markdown conversion with legal structure preserved
|
||
• Removes technical artifacts for easy reading
|
||
• Compatible with documentId from Bedesten search results"""
|
||
)
|
||
async def get_yargitay_bedesten_document(document_id: str):
|
||
"""Get Court of Cassation document from Bedesten API in Markdown format."""
|
||
return await call_mcp_tool("get_yargitay_bedesten_document_markdown", {"documentId": document_id})
|
||
|
||
# ============================================================================
|
||
# DANISTAY (COUNCIL OF STATE) ENDPOINTS - 5 TOOLS
|
||
# ============================================================================
|
||
|
||
@app.post(
|
||
"/api/danistay/search-keyword",
|
||
tags=["Danıştay"],
|
||
summary="Search Council of State (Keyword Logic)",
|
||
description="""Search Turkey's highest administrative court using Boolean keyword logic.
|
||
|
||
Boolean Operators:
|
||
• AND keywords: ALL must be present (required terms)
|
||
• OR keywords: ANY can be present (alternative terms)
|
||
• NOT keywords: EXCLUDE if present (unwanted terms)
|
||
|
||
Examples:
|
||
• Administrative acts: andKelimeler=["idari işlem", "iptal"]
|
||
• Permits/licenses: orKelimeler=["ruhsat", "izin", "lisans"]
|
||
• Exclude tax cases: notKelimeler=["vergi"]
|
||
|
||
Perfect for administrative law research and government action reviews."""
|
||
)
|
||
async def search_danistay_keyword(request: DanistayKeywordSearchRequest):
|
||
"""
|
||
Searches Council of State (Danıştay) decisions using keyword-based logic.
|
||
|
||
The Council of State (Danıştay) is Turkey's highest administrative court, responsible for
|
||
reviewing administrative actions and providing administrative law precedents. This tool
|
||
provides flexible keyword-based searching with Boolean logic operators.
|
||
|
||
Key Features:
|
||
• Boolean logic operators: AND, OR, NOT combinations
|
||
• Multiple keyword lists for complex search strategies
|
||
• Pagination support (1-100 results per page)
|
||
• Administrative law focus (permits, licenses, public administration)
|
||
• Complement to search_danistay_detailed for comprehensive coverage
|
||
|
||
Keyword Logic:
|
||
• andKelimeler: ALL keywords must be present (AND logic)
|
||
• orKelimeler: ANY keyword can be present (OR logic)
|
||
• notAndKelimeler: EXCLUDE if ALL keywords present (NOT AND)
|
||
• notOrKelimeler: EXCLUDE if ANY keyword present (NOT OR)
|
||
|
||
Administrative Law Use Cases:
|
||
• Research administrative court precedents
|
||
• Find decisions on specific government agencies
|
||
• Search for rulings on permits (ruhsat) and licenses (izin)
|
||
• Analyze administrative procedure interpretations
|
||
• Study public administration legal principles
|
||
|
||
Examples:
|
||
• Simple AND: andKelimeler=["administrative act (idari işlem)", "annulment (iptal)"]
|
||
• OR search: orKelimeler=["permit (ruhsat)", "permission (izin)", "license (lisans)"]
|
||
• Complex: andKelimeler=["municipality (belediye)"], notOrKelimeler=["tax (vergi)"]
|
||
|
||
Returns structured search results. Use get_danistay_document_markdown() for full texts.
|
||
For comprehensive Council of State (Danıştay) research, also use search_danistay_detailed and search_danistay_bedesten.
|
||
"""
|
||
args = {"andKelimeler": request.andKelimeler, "pageSize": request.pageSize}
|
||
if request.orKelimeler:
|
||
args["orKelimeler"] = request.orKelimeler
|
||
if request.notKelimeler:
|
||
args["notKelimeler"] = request.notKelimeler
|
||
return await call_mcp_tool("search_danistay_by_keyword", args)
|
||
|
||
@app.post(
|
||
"/api/danistay/search-detailed",
|
||
tags=["Danıştay"],
|
||
summary="Search Council of State (Detailed Criteria)",
|
||
description="""Most comprehensive Council of State search with advanced filtering.
|
||
|
||
Advanced Filtering:
|
||
• Chamber targeting (1. Daire through 17. Daire, special councils)
|
||
• Case/decision number ranges • Date range filtering
|
||
• Legislation cross-referencing • Multiple sorting options
|
||
|
||
Use for specialized administrative law research, chamber-specific decisions,
|
||
and regulatory compliance analysis."""
|
||
)
|
||
async def search_danistay_detailed(request: DanistayDetailedSearchRequest):
|
||
"""Search Council of State with comprehensive filtering for specialized administrative law research."""
|
||
args = {}
|
||
for field in ["daire", "baslangicTarihi", "bitisTarihi", "esas", "karar"]:
|
||
if getattr(request, field):
|
||
args[field] = getattr(request, field)
|
||
return await call_mcp_tool("search_danistay_detailed", args)
|
||
|
||
@app.post(
|
||
"/api/danistay/search-bedesten",
|
||
tags=["Danıştay"],
|
||
summary="Search Council of State (Bedesten API)",
|
||
description="""Council of State search via Bedesten API with 27 chamber options and exact phrase search.
|
||
|
||
Key Features:
|
||
• 27 chamber options (Main Councils, 17 Chambers, Military courts)
|
||
• Exact phrase search with double quotes for precision
|
||
• ISO 8601 date filtering • Alternative data source
|
||
|
||
Use with other Danıştay tools for complete administrative law coverage."""
|
||
)
|
||
async def search_danistay_bedesten(request: DanistayBedestenSearchRequest):
|
||
"""Search Council of State via Bedesten API. Use with other Danıştay tools for complete coverage."""
|
||
args = {"phrase": request.phrase, "pageSize": request.pageSize}
|
||
for field in ["birimAdi", "kararTarihiStart", "kararTarihiEnd"]:
|
||
if getattr(request, field):
|
||
args[field] = getattr(request, field)
|
||
return await call_mcp_tool("search_danistay_bedesten", args)
|
||
|
||
@app.get(
|
||
"/api/danistay/document/{decision_id}",
|
||
tags=["Danıştay"],
|
||
summary="Get Council of State Document (Primary API)",
|
||
description="""Retrieve complete administrative court decision in Markdown format.
|
||
|
||
Content includes:
|
||
• Complete administrative law reasoning and precedent analysis
|
||
• Review of administrative actions and government decisions
|
||
• Citations of administrative laws and regulations
|
||
• Final administrative ruling with legal justification
|
||
|
||
Essential for administrative law research and government compliance analysis."""
|
||
)
|
||
async def get_danistay_document(decision_id: str):
|
||
"""Get full Council of State decision text in clean Markdown format."""
|
||
return await call_mcp_tool("get_danistay_document_markdown", {"id": decision_id})
|
||
|
||
@app.get(
|
||
"/api/danistay/bedesten-document/{document_id}",
|
||
tags=["Danıştay"],
|
||
summary="Get Council of State Document (Bedesten API)",
|
||
description="""Retrieve Council of State decision from Bedesten API in Markdown format."""
|
||
)
|
||
async def get_danistay_bedesten_document(document_id: str):
|
||
"""Get Council of State document from Bedesten API in Markdown format."""
|
||
return await call_mcp_tool("get_danistay_bedesten_document_markdown", {"documentId": document_id})
|
||
|
||
# ============================================================================
|
||
# BEDESTEN API COURTS (LOCAL/APPELLATE/KYB) - 6 TOOLS
|
||
# ============================================================================
|
||
|
||
@app.post(
|
||
"/api/yerel-hukuk/search",
|
||
tags=["Yerel Hukuk"],
|
||
summary="Search Local Civil Courts",
|
||
description="""Search first-instance civil court decisions using Bedesten API.
|
||
|
||
Local Civil Courts handle:
|
||
• Contract disputes • Property rights • Family law • Tort claims
|
||
• Commercial disputes • Consumer protection
|
||
|
||
Only available tool for local court decisions. Supports exact phrase search
|
||
and date filtering for precise legal research."""
|
||
)
|
||
async def search_yerel_hukuk(request: BedestenSearchRequest):
|
||
"""
|
||
Searches Yerel Hukuk Mahkemesi (Local Civil Court) decisions using Bedesten API.
|
||
|
||
This provides access to local court decisions that are not available through other APIs.
|
||
Currently the only available tool for searching Yerel Hukuk Mahkemesi decisions.
|
||
Local civil courts represent the first instance of civil litigation in Turkey.
|
||
|
||
Local Civil Courts handle:
|
||
• Contract disputes and commercial litigation
|
||
• Property rights and real estate disputes
|
||
• Family law matters (divorce, custody, inheritance)
|
||
• Tort claims and compensation cases
|
||
• Consumer protection issues
|
||
• Employment disputes
|
||
|
||
Returns structured search results with decision metadata. Use get_yerel_hukuk_bedesten_document_markdown()
|
||
to retrieve full decision texts for detailed analysis.
|
||
"""
|
||
args = {"phrase": request.phrase, "pageSize": request.pageSize}
|
||
for field in ["kararTarihiStart", "kararTarihiEnd"]:
|
||
if getattr(request, field):
|
||
args[field] = getattr(request, field)
|
||
return await call_mcp_tool("search_yerel_hukuk_bedesten", args)
|
||
|
||
@app.get("/api/yerel-hukuk/document/{document_id}", tags=["Yerel Hukuk"])
|
||
async def get_yerel_hukuk_document(document_id: str):
|
||
"""
|
||
Retrieves a Yerel Hukuk Mahkemesi decision document from Bedesten API and converts to Markdown.
|
||
|
||
This tool fetches complete local court decision texts using documentId from search results.
|
||
Perfect for detailed analysis of first-instance civil court rulings.
|
||
|
||
Supports both HTML and PDF content types, automatically converting to clean Markdown format.
|
||
Use documentId from search_yerel_hukuk_bedesten results.
|
||
"""
|
||
return await call_mcp_tool("get_yerel_hukuk_bedesten_document_markdown", {"documentId": document_id})
|
||
|
||
@app.post(
|
||
"/api/istinaf-hukuk/search",
|
||
tags=["İstinaf Hukuk"],
|
||
summary="Search Civil Courts of Appeals",
|
||
description="""Search intermediate appellate court decisions using Bedesten API.
|
||
|
||
İstinaf Courts are intermediate appellate courts handling appeals from local civil courts
|
||
before cases reach the Court of Cassation. Only available tool for İstinaf decisions."""
|
||
)
|
||
async def search_istinaf_hukuk(request: BedestenSearchRequest):
|
||
"""
|
||
Searches İstinaf Hukuk Mahkemesi (Civil Court of Appeals) decisions using Bedesten API.
|
||
|
||
İstinaf courts are intermediate appellate courts in the Turkish judicial system that handle
|
||
appeals from local civil courts before cases reach Yargıtay (Court of Cassation).
|
||
This is the only available tool for accessing İstinaf Hukuk Mahkemesi decisions.
|
||
|
||
Key Features:
|
||
• Date range filtering with ISO 8601 format (YYYY-MM-DDTHH:MM:SS.000Z)
|
||
• Exact phrase search using double quotes: "\"legal term\""
|
||
• Regular search for individual keywords
|
||
• Pagination support (1-100 results per page)
|
||
|
||
Use cases:
|
||
• Research appellate court precedents
|
||
• Track appeals from specific lower courts
|
||
• Find decisions on specific legal issues at appellate level
|
||
• Analyze intermediate court reasoning before supreme court review
|
||
|
||
Returns structured data with decision metadata including dates, case numbers, and summaries.
|
||
Use get_istinaf_hukuk_bedesten_document_markdown() to retrieve full decision texts.
|
||
"""
|
||
args = {"phrase": request.phrase, "pageSize": request.pageSize}
|
||
for field in ["kararTarihiStart", "kararTarihiEnd"]:
|
||
if getattr(request, field):
|
||
args[field] = getattr(request, field)
|
||
return await call_mcp_tool("search_istinaf_hukuk_bedesten", args)
|
||
|
||
@app.get("/api/istinaf-hukuk/document/{document_id}", tags=["İstinaf Hukuk"])
|
||
async def get_istinaf_hukuk_document(document_id: str):
|
||
"""
|
||
Retrieves the full text of an İstinaf Hukuk Mahkemesi decision document in Markdown format.
|
||
|
||
This tool converts the original decision document (HTML or PDF) from Bedesten API
|
||
into clean, readable Markdown format suitable for analysis and processing.
|
||
|
||
Input Requirements:
|
||
• documentId: Use the ID from search_istinaf_hukuk_bedesten results
|
||
• Document ID must be non-empty string
|
||
|
||
Output Format:
|
||
• Clean Markdown text with proper formatting
|
||
• Preserves legal structure (headers, paragraphs, citations)
|
||
• Removes extraneous HTML/PDF artifacts
|
||
|
||
Use for:
|
||
• Reading full appellate court decision texts
|
||
• Legal analysis of İstinaf court reasoning
|
||
• Citation extraction and reference building
|
||
• Content analysis and summarization
|
||
"""
|
||
return await call_mcp_tool("get_istinaf_hukuk_bedesten_document_markdown", {"documentId": document_id})
|
||
|
||
@app.post(
|
||
"/api/kyb/search",
|
||
tags=["KYB"],
|
||
summary="Search Extraordinary Appeals (KYB)",
|
||
description="""Search Kanun Yararına Bozma (Extraordinary Appeal) decisions.
|
||
|
||
KYB is an extraordinary legal remedy where the Public Prosecutor's Office requests
|
||
review of finalized decisions in favor of law and defendants. Very rare but important
|
||
legal precedents. Only available tool for KYB decisions."""
|
||
)
|
||
async def search_kyb(request: BedestenSearchRequest):
|
||
"""
|
||
Searches Kanun Yararına Bozma (KYB - Extraordinary Appeal) decisions using Bedesten API.
|
||
|
||
KYB is an extraordinary legal remedy in the Turkish judicial system where the
|
||
Public Prosecutor's Office can request review of finalized decisions in favor of
|
||
the law and defendants. This is the only available tool for accessing KYB decisions.
|
||
|
||
Key Features:
|
||
• Date range filtering with ISO 8601 format (YYYY-MM-DDTHH:MM:SS.000Z)
|
||
• Exact phrase search using double quotes: "\"extraordinary appeal\""
|
||
• Regular search for individual keywords
|
||
• Pagination support (1-100 results per page)
|
||
|
||
Legal Significance:
|
||
• Extraordinary remedy beyond regular appeals
|
||
• Initiated by Public Prosecutor's Office
|
||
• Reviews finalized decisions for legal errors
|
||
• Can benefit defendants retroactively
|
||
• Rare but important legal precedents
|
||
|
||
Use cases:
|
||
• Research extraordinary appeal precedents
|
||
• Study prosecutorial challenges to final decisions
|
||
• Analyze legal errors in finalized cases
|
||
• Track KYB success rates and patterns
|
||
|
||
Returns structured data with decision metadata. Use get_kyb_bedesten_document_markdown()
|
||
to retrieve full decision texts for detailed analysis.
|
||
"""
|
||
args = {"phrase": request.phrase, "pageSize": request.pageSize}
|
||
for field in ["kararTarihiStart", "kararTarihiEnd"]:
|
||
if getattr(request, field):
|
||
args[field] = getattr(request, field)
|
||
return await call_mcp_tool("search_kyb_bedesten", args)
|
||
|
||
@app.get("/api/kyb/document/{document_id}", tags=["KYB"])
|
||
async def get_kyb_document(document_id: str):
|
||
"""
|
||
Retrieves the full text of a Kanun Yararına Bozma (KYB) decision document in Markdown format.
|
||
|
||
This tool converts the original extraordinary appeal decision document (HTML or PDF)
|
||
from Bedesten API into clean, readable Markdown format for analysis.
|
||
|
||
Input Requirements:
|
||
• documentId: Use the ID from search_kyb_bedesten results
|
||
• Document ID must be non-empty string
|
||
|
||
Output Format:
|
||
• Clean Markdown text with legal formatting preserved
|
||
• Structured content with headers and citations
|
||
• Removes technical artifacts from source documents
|
||
|
||
Special Value for KYB Documents:
|
||
• Contains rare extraordinary appeal reasoning
|
||
• Shows prosecutorial arguments for legal review
|
||
• Documents correction of finalized legal errors
|
||
• Provides precedent for similar extraordinary circumstances
|
||
|
||
Use for:
|
||
• Analyzing extraordinary appeal legal reasoning
|
||
• Understanding prosecutorial review criteria
|
||
• Research on legal error correction mechanisms
|
||
• Studying retroactive benefit applications
|
||
"""
|
||
return await call_mcp_tool("get_kyb_bedesten_document_markdown", {"documentId": document_id})
|
||
|
||
# ============================================================================
|
||
# ADDITIONAL COURTS - 12 TOOLS
|
||
# ============================================================================
|
||
|
||
@app.post("/api/emsal/search", tags=["Emsal"], summary="Search UYAP Precedents")
|
||
async def search_emsal(request: EmsalSearchRequest):
|
||
"""
|
||
Searches for Precedent (Emsal) decisions using detailed criteria.
|
||
|
||
The Precedent (Emsal) database contains precedent decisions from various Turkish courts
|
||
integrated through the UYAP (National Judiciary Informatics System). This tool provides
|
||
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 (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
|
||
|
||
Court Selection Options:
|
||
• BAM Civil Courts: Higher regional civil courts
|
||
• Civil Courts: Local and first-instance civil courts
|
||
• Regional Civil Chambers: Specialized civil court departments
|
||
|
||
Precedent Research Use Cases:
|
||
• 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
|
||
• Track precedent development over time
|
||
• Compare decisions from different court types
|
||
|
||
Returns structured precedent data with court information and decision metadata.
|
||
Use get_emsal_document_markdown() to retrieve full precedent decision texts.
|
||
"""
|
||
args = {"keyword": request.keyword, "results_per_page": request.results_per_page}
|
||
if request.decision_year_karar:
|
||
args["decision_year_karar"] = request.decision_year_karar
|
||
return await call_mcp_tool("search_emsal_detailed_decisions", args)
|
||
|
||
@app.get("/api/emsal/document/{decision_id}", tags=["Emsal"])
|
||
async def get_emsal_document(decision_id: str):
|
||
"""
|
||
Retrieves the full text of a specific Emsal (UYAP Precedent) decision in Markdown format.
|
||
|
||
This tool fetches complete precedent decision documents from the UYAP system and converts
|
||
them to clean, readable Markdown format suitable for legal precedent analysis.
|
||
|
||
Input Requirements:
|
||
• decision_id: Decision ID from search_emsal_detailed_decisions results
|
||
• ID must be non-empty string from UYAP Emsal database
|
||
|
||
Output Format:
|
||
• Clean Markdown text with legal precedent structure preserved
|
||
• Organized sections: court info, case facts, legal reasoning, conclusion
|
||
• Proper formatting for legal citations and cross-references
|
||
• Removes technical artifacts from source documents
|
||
|
||
Precedent Decision Content:
|
||
• Complete court reasoning and legal analysis
|
||
• Detailed examination of legal principles applied
|
||
• Citation of relevant laws, regulations, and prior precedents
|
||
• Final ruling with precedent-setting reasoning
|
||
• Court-specific interpretations and legal standards
|
||
|
||
Use for legal precedent research, citation building, and comparative legal analysis.
|
||
"""
|
||
return await call_mcp_tool("get_emsal_document_markdown", {"decision_id": decision_id})
|
||
|
||
@app.post("/api/uyusmazlik/search", tags=["Uyuşmazlık"], summary="Search Jurisdictional Disputes")
|
||
async def search_uyusmazlik(request: UyusmazlikSearchRequest):
|
||
"""
|
||
Searches for Court of Jurisdictional Disputes (Uyuşmazlık Mahkemesi) decisions.
|
||
|
||
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.
|
||
|
||
Key Features:
|
||
• Department filtering (Criminal, Civil, General Assembly decisions)
|
||
• Dispute type classification (Jurisdiction vs Judgment disputes)
|
||
• Decision outcome filtering (dispute resolution results)
|
||
• Case number and date range filtering
|
||
• Advanced text search with Boolean logic operators
|
||
• Official Gazette reference search
|
||
|
||
Dispute Types:
|
||
• Jurisdictional Disputes (Görev Uyuşmazlığı): Which court has authority
|
||
• Judgment Disputes (Hüküm Uyuşmazlığı): Conflicting final decisions
|
||
|
||
Departments:
|
||
• Criminal Section (Ceza Bölümü): Criminal section decisions
|
||
• Civil Section (Hukuk Bölümü): Civil section decisions
|
||
• General Assembly Decisions (Genel Kurul Kararları): General Assembly decisions
|
||
|
||
Use cases:
|
||
• Research jurisdictional precedents
|
||
• Understand court system boundaries
|
||
• Analyze dispute resolution patterns
|
||
• Study inter-court conflict resolution
|
||
• Legal procedure and jurisdiction research
|
||
|
||
Returns structured search results with dispute resolution information.
|
||
"""
|
||
return await call_mcp_tool("search_uyusmazlik_decisions", {
|
||
"keywords": request.keywords,
|
||
"page_to_fetch": request.page_to_fetch
|
||
})
|
||
|
||
@app.get("/api/uyusmazlik/document", tags=["Uyuşmazlık"])
|
||
async def get_uyusmazlik_document(document_url: str):
|
||
"""
|
||
Retrieves the full text of a specific Uyuşmazlık Mahkemesi decision from its URL in Markdown format.
|
||
|
||
This tool fetches complete jurisdictional dispute resolution decisions and converts them
|
||
to clean, readable Markdown format suitable for legal analysis of inter-court disputes.
|
||
|
||
Input Requirements:
|
||
• document_url: Full URL to the decision document from search_uyusmazlik_decisions results
|
||
• URL must be valid HttpUrl format from official Uyuşmazlık Mahkemesi database
|
||
|
||
Output Format:
|
||
• Clean Markdown text with jurisdictional dispute structure preserved
|
||
• Organized sections: dispute facts, jurisdictional analysis, resolution ruling
|
||
• Proper formatting for legal citations and court system references
|
||
• Removes technical artifacts from source documents
|
||
|
||
Jurisdictional Dispute Decision Content:
|
||
• Complete analysis of jurisdictional conflicts between court systems
|
||
• Detailed examination of applicable jurisdictional rules
|
||
• Citation of relevant procedural laws and court organization statutes
|
||
• Final resolution determining proper court jurisdiction
|
||
• Reasoning for jurisdictional boundaries and court authority
|
||
|
||
Use for understanding court system boundaries, analyzing jurisdictional precedents,
|
||
and legal practice guidance on proper court selection.
|
||
"""
|
||
return await call_mcp_tool("get_uyusmazlik_document_markdown_from_url", {"document_url": document_url})
|
||
|
||
@app.post("/api/anayasa/search-norm", tags=["Anayasa"], summary="Search Constitutional Court (Norm Control)")
|
||
async def search_anayasa_norm(request: AnayasaNormSearchRequest):
|
||
"""
|
||
Searches Constitutional Court (Anayasa Mahkemesi) norm control decisions with comprehensive filtering.
|
||
|
||
The Constitutional Court is Turkey's highest constitutional authority, responsible for judicial
|
||
review of laws, regulations, and constitutional amendments. Norm control (Norm Denetimi) is the
|
||
court's power to review the constitutionality of legal norms.
|
||
|
||
Key Features:
|
||
• Boolean keyword search (AND, OR, NOT logic)
|
||
• Constitutional period filtering (1961 vs 1982 Constitution)
|
||
• Case and decision number filtering
|
||
• Date range filtering for review and decision dates
|
||
• Application type classification (İptal, İtiraz, etc.)
|
||
• Applicant filtering (government entities, opposition parties)
|
||
• Official Gazette publication filtering
|
||
• Judicial opinion analysis (dissents, different reasoning)
|
||
• Court member and rapporteur filtering
|
||
• Norm type classification (laws, regulations, decrees)
|
||
• Review outcome filtering (constitutionality determinations)
|
||
• Constitutional basis article referencing
|
||
|
||
Constitutional Review Types:
|
||
• Abstract review: Ex ante constitutional control
|
||
• Concrete review: Constitutional questions during litigation
|
||
• Legislative review: Parliamentary acts and government decrees
|
||
• Regulatory review: Administrative regulations and bylaws
|
||
|
||
Use cases:
|
||
• Constitutional law research and analysis
|
||
• Legislative drafting constitutional compliance
|
||
• Academic constitutional law study
|
||
• Legal precedent analysis for constitutional questions
|
||
• Government policy constitutional assessment
|
||
|
||
Returns structured constitutional court data with comprehensive metadata.
|
||
"""
|
||
args = {"keywords_all": request.keywords_all, "results_per_page": request.results_per_page}
|
||
for field in ["period", "application_type"]:
|
||
if getattr(request, field):
|
||
args[field] = getattr(request, field)
|
||
return await call_mcp_tool("search_anayasa_norm_denetimi_decisions", args)
|
||
|
||
@app.get("/api/anayasa/norm-document", tags=["Anayasa"])
|
||
async def get_anayasa_norm_document(document_url: str, page_number: int = 1):
|
||
"""Get Constitutional Court norm control decision in paginated Markdown format."""
|
||
return await call_mcp_tool("get_anayasa_norm_denetimi_document_markdown", {
|
||
"document_url": document_url, "page_number": page_number
|
||
})
|
||
|
||
@app.post("/api/anayasa/search-bireysel", tags=["Anayasa"], summary="Search Constitutional Court (Individual Applications)")
|
||
async def search_anayasa_bireysel(request: AnayasaBireyselSearchRequest):
|
||
"""
|
||
Search Constitutional Court individual application (Bireysel Başvuru) decisions for human rights violation reports with keyword filtering.
|
||
|
||
Individual applications allow citizens to petition the Constitutional Court directly for
|
||
violations of fundamental rights and freedoms. This tool generates decision search reports
|
||
that help identify relevant human rights violation cases.
|
||
|
||
Key Features:
|
||
• Keyword-based search with AND logic
|
||
• Human rights violation case identification
|
||
• Individual petition decision analysis
|
||
• Fundamental rights and freedoms research
|
||
• Pagination support for large result sets
|
||
|
||
Individual Application System:
|
||
• Direct citizen access to Constitutional Court
|
||
• Human rights and fundamental freedoms protection
|
||
• Alternative to European Court of Human Rights
|
||
• Domestic remedy for constitutional violations
|
||
• Individual justice and rights enforcement
|
||
|
||
Human Rights Categories:
|
||
• Right to life and personal liberty
|
||
• Right to fair trial and due process
|
||
• Freedom of expression and press
|
||
• Freedom of religion and conscience
|
||
• Property rights and economic freedoms
|
||
• Right to privacy and family life
|
||
• Political rights and democratic participation
|
||
|
||
Use cases:
|
||
• Human rights violation research
|
||
• Individual petition precedent analysis
|
||
• Constitutional rights interpretation study
|
||
• Legal remedies for rights violations
|
||
• Academic human rights law research
|
||
• Civil society and NGO legal research
|
||
|
||
Returns search report with case summaries and violation categories.
|
||
Use get_anayasa_bireysel_document for full decision texts.
|
||
"""
|
||
return await call_mcp_tool("search_anayasa_bireysel_basvuru_report", {
|
||
"keywords": request.keywords, "page_to_fetch": request.page_to_fetch
|
||
})
|
||
|
||
@app.get("/api/anayasa/bireysel-document", tags=["Anayasa"])
|
||
async def get_anayasa_bireysel_document(document_url: str, page_number: int = 1):
|
||
"""
|
||
Retrieve the full text of a Constitutional Court individual application decision in paginated Markdown format.
|
||
|
||
This tool fetches complete human rights violation decisions from individual applications
|
||
and converts them to clean, readable Markdown format. Content is paginated into
|
||
5,000-character chunks for easier processing.
|
||
|
||
Input Requirements:
|
||
• document_url: URL path (e.g., /BB/YYYY/NNNN) from search results
|
||
• page_number: Page number for pagination (1-indexed, default: 1)
|
||
|
||
Output Format:
|
||
• Clean Markdown text with human rights case structure preserved
|
||
• Organized sections: applicant info, violation claims, court analysis, ruling
|
||
• Proper formatting for human rights law citations and references
|
||
• Paginated content with navigation information
|
||
|
||
Individual Application Decision Content:
|
||
• Complete human rights violation analysis
|
||
• Detailed examination of fundamental rights claims
|
||
• Citation of constitutional articles and international human rights law
|
||
• Final determination on rights violations with remedies
|
||
• Analysis of domestic court proceedings and their adequacy
|
||
• Individual remedy recommendations and compensation
|
||
|
||
Use for:
|
||
• Reading full human rights violation decisions
|
||
• Human rights law research and precedent analysis
|
||
• Understanding constitutional rights protection standards
|
||
• Individual petition strategy development
|
||
• Academic human rights and constitutional law study
|
||
• Civil society monitoring of rights violations
|
||
"""
|
||
return await call_mcp_tool("get_anayasa_bireysel_basvuru_document_markdown", {
|
||
"document_url": document_url, "page_number": page_number
|
||
})
|
||
|
||
@app.post("/api/kik/search", tags=["KİK"], summary="Search Public Procurement Authority")
|
||
async def search_kik(request: KikSearchRequest):
|
||
"""
|
||
Search Public Procurement Authority (Kamu İhale Kurulu - KIK) decisions with comprehensive filtering for public procurement law and administrative dispute research.
|
||
|
||
The Public Procurement Authority (KIK) is Turkey's procurement oversight body, responsible for
|
||
regulating public procurement processes, resolving procurement disputes, and issuing interpretive
|
||
decisions on public contracting laws. This tool provides access to official procurement decisions
|
||
and regulatory guidance.
|
||
|
||
Key Features:
|
||
• Decision type filtering (Disputes, Regulatory, Court decisions)
|
||
• Decision date range filtering for temporal analysis
|
||
• Applicant and procuring entity filtering
|
||
• Tender subject and content-based search
|
||
• Decision number and reference tracking
|
||
• Comprehensive metadata extraction
|
||
|
||
Public Procurement Decision Types:
|
||
• Uyuşmazlık Kararları: Dispute resolution decisions
|
||
• Düzenleyici Kararlar: Regulatory and interpretive decisions
|
||
• Mahkeme Kararları: Court decisions and judicial precedents
|
||
|
||
Procurement Law Areas:
|
||
• Tender procedure compliance and violations
|
||
• Bid evaluation and award criteria disputes
|
||
• Contractor qualification and eligibility
|
||
• Contract modification and scope changes
|
||
• Performance guarantees and penalty applications
|
||
• Public procurement ethics and transparency
|
||
• Emergency procurement and exceptional procedures
|
||
|
||
Use cases:
|
||
• Public procurement law research and compliance guidance
|
||
• Tender dispute resolution precedent analysis
|
||
• Government contracting risk assessment
|
||
• Procurement policy and regulatory interpretation
|
||
• Academic public administration and law study
|
||
• Legal strategy development for procurement disputes
|
||
|
||
Returns structured procurement authority data with comprehensive case metadata.
|
||
Use get_kik_document for full decision texts with detailed reasoning.
|
||
"""
|
||
args = {}
|
||
for field in ["karar_tipi", "karar_metni", "basvuru_konusu_ihale", "karar_tarihi_baslangic"]:
|
||
if getattr(request, field):
|
||
args[field] = getattr(request, field)
|
||
return await call_mcp_tool("search_kik_decisions", args)
|
||
|
||
@app.get("/api/kik/document/{decision_id}", tags=["KİK"])
|
||
async def get_kik_document(decision_id: str):
|
||
"""
|
||
Retrieve the full text of a Public Procurement Authority (KIK) decision in paginated Markdown format.
|
||
|
||
This tool fetches complete public procurement decisions and converts them from PDF to clean,
|
||
readable Markdown format. Content is paginated into manageable chunks for processing lengthy
|
||
procurement law decisions and regulatory interpretations.
|
||
|
||
Input Requirements:
|
||
• decision_id: KIK decision ID (base64 encoded karar_id) from search results
|
||
• Decision ID must be non-empty string
|
||
|
||
Output Format:
|
||
• Clean Markdown text converted from original PDF documents
|
||
• Organized sections: case summary, legal analysis, regulatory interpretation, decision
|
||
• Proper formatting for procurement law citations and regulatory references
|
||
• Paginated content with navigation information
|
||
• Metadata including PDF source link and document information
|
||
|
||
Public Procurement Decision Content:
|
||
• Complete procurement dispute analysis and resolution
|
||
• Detailed examination of tender procedures and compliance
|
||
• Citation of procurement laws, regulations, and precedents
|
||
• Final determination on procurement violations with corrective measures
|
||
• Regulatory guidance and policy interpretations
|
||
• Contractor liability and penalty determinations
|
||
|
||
Use for:
|
||
• Reading full public procurement authority decisions
|
||
• Procurement law research and precedent analysis
|
||
• Government contracting compliance and risk assessment
|
||
• Tender dispute resolution strategy development
|
||
• Academic public administration and procurement law study
|
||
• Policy analysis and regulatory interpretation
|
||
"""
|
||
return await call_mcp_tool("get_kik_document_markdown", {"decision_id": decision_id})
|
||
|
||
@app.post("/api/rekabet/search", tags=["Rekabet"], summary="Search Competition Authority")
|
||
async def search_rekabet(request: RekabetSearchRequest):
|
||
"""
|
||
Search Competition Authority (Rekabet Kurumu) decisions with comprehensive filtering for competition law and antitrust research.
|
||
|
||
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.
|
||
|
||
Key Features:
|
||
• Decision type filtering (Mergers, Violations, Exemptions, etc.)
|
||
• Title and content-based text search with exact phrase matching
|
||
• Publication date filtering
|
||
• Case year and decision number filtering
|
||
• Pagination support for large result sets
|
||
|
||
Competition Law Decision Types:
|
||
• Birleşme ve Devralma: Merger and acquisition approvals
|
||
• Rekabet İhlali: Competition violation investigations
|
||
• Muafiyet: Exemption and negative clearance decisions
|
||
• Geçici Tedbir: Interim measures and emergency orders
|
||
• Sektör İncelemesi: Sector inquiry and market studies
|
||
• Diğer: Other regulatory and interpretive decisions
|
||
|
||
Competition Law Areas:
|
||
• Anti-competitive agreements and cartels
|
||
• Abuse of dominant market position
|
||
• Merger control and market concentration
|
||
• Vertical agreements and distribution restrictions
|
||
• Unfair competition and consumer protection
|
||
• Market definition and economic analysis
|
||
|
||
Advanced Search:
|
||
• Exact phrase matching with double quotes for precise legal terms
|
||
• Content search across full decision texts (PdfText parameter)
|
||
• Title search for specific case names or topics
|
||
• Date range filtering for temporal analysis
|
||
|
||
Example for exact phrase search: PdfText=\"tender process\" consultancy
|
||
|
||
Use cases:
|
||
• Competition law research and precedent analysis
|
||
• Merger and acquisition due diligence
|
||
• Antitrust compliance and risk assessment
|
||
• Market analysis and competitive intelligence
|
||
• Academic competition economics study
|
||
• Legal strategy development for competition cases
|
||
|
||
Returns structured competition authority data with comprehensive metadata.
|
||
Use get_rekabet_document for full decision texts (paginated PDF conversion).
|
||
"""
|
||
args = {"page": request.page}
|
||
for field in ["KararTuru", "PdfText", "YayinlanmaTarihi"]:
|
||
if getattr(request, field):
|
||
args[field] = getattr(request, field)
|
||
return await call_mcp_tool("search_rekabet_kurumu_decisions", args)
|
||
|
||
@app.get("/api/rekabet/document/{karar_id}", tags=["Rekabet"])
|
||
async def get_rekabet_document(karar_id: str, page_number: int = 1):
|
||
"""
|
||
Retrieve the full text of a Competition Authority (Rekabet Kurumu) decision in paginated Markdown format converted from PDF.
|
||
|
||
This tool fetches complete competition authority decisions and converts them from PDF to clean,
|
||
readable Markdown format. Content is paginated for easier processing of lengthy competition law decisions.
|
||
|
||
Input Requirements:
|
||
• karar_id: GUID (kararId) from search_rekabet_kurumu_decisions results
|
||
• page_number: Page number for pagination (1-indexed, default: 1)
|
||
|
||
Output Format:
|
||
• Clean Markdown text converted from original PDF documents
|
||
• Organized sections: case summary, market analysis, legal reasoning, decision
|
||
• Proper formatting for competition law citations and references
|
||
• Paginated content with navigation information
|
||
• Metadata including PDF source link and document information
|
||
|
||
Competition Authority Decision Content:
|
||
• Complete competition law analysis and market assessment
|
||
• Detailed examination of anti-competitive practices
|
||
• Economic analysis and market definition studies
|
||
• Citation of competition laws, regulations, and precedents
|
||
• Final determination on competition violations with remedies
|
||
• Merger and acquisition approval conditions
|
||
• Regulatory guidance and policy interpretations
|
||
|
||
Use for:
|
||
• Reading full competition authority decisions
|
||
• Competition law research and precedent analysis
|
||
• Market analysis and economic impact assessment
|
||
• Antitrust compliance and risk evaluation
|
||
• Academic competition economics and law study
|
||
• Legal strategy development for competition cases
|
||
"""
|
||
return await call_mcp_tool("get_rekabet_kurumu_document", {
|
||
"karar_id": karar_id, "page_number": page_number
|
||
})
|
||
|
||
# ============================================================================
|
||
# SAYISTAY (COURT OF ACCOUNTS) ENDPOINTS - 6 TOOLS
|
||
# ============================================================================
|
||
|
||
@app.post("/api/sayistay/search-genel-kurul", tags=["Sayıştay"], summary="Search Court of Accounts (General Assembly)")
|
||
async def search_sayistay_genel_kurul(request: SayistaySearchRequest):
|
||
"""
|
||
Search Sayıştay Genel Kurul (General Assembly) decisions - highest-level audit precedents and interpretive rulings with keyword-based filtering.
|
||
|
||
The General Assembly represents the highest decision-making body of Turkey's Court of Accounts,
|
||
issuing authoritative interpretations of audit laws, precedential rulings on complex accountability
|
||
issues, and binding guidance for audit practice. These decisions establish fundamental principles
|
||
for public financial oversight and accountability standards.
|
||
|
||
Key Features:
|
||
• Keyword-based search with AND logic for precise case finding
|
||
• Highest-level audit precedent identification
|
||
• Interpretive ruling analysis and legal guidance extraction
|
||
• Complex accountability issue resolution tracking
|
||
• Pagination support for comprehensive result sets
|
||
|
||
General Assembly Decision Authority:
|
||
• Ultimate audit law interpretation and clarification
|
||
• Precedential rulings binding on all audit chambers
|
||
• Complex inter-chamber jurisdiction dispute resolution
|
||
• Policy guidance for audit methodology and standards
|
||
• Final determination on constitutional audit questions
|
||
|
||
Public Audit Areas:
|
||
• Government budget execution and compliance
|
||
• Public institution financial management
|
||
• State-owned enterprise oversight and accountability
|
||
• Local government and municipal audit standards
|
||
• Public procurement oversight and compliance monitoring
|
||
• Performance audit methodology and effectiveness standards
|
||
• Public revenue collection and tax administration audit
|
||
|
||
Use Cases:
|
||
• Research authoritative audit law interpretations
|
||
• Find binding precedents for complex audit questions
|
||
• Study evolution of public accountability standards
|
||
• Analyze audit methodology development and refinement
|
||
• Academic public administration and audit research
|
||
• Government policy and accountability framework analysis
|
||
|
||
Returns structured General Assembly data with comprehensive legal precedent metadata.
|
||
Use get_sayistay_genel_kurul_document for full decision texts with detailed reasoning.
|
||
"""
|
||
return await call_mcp_tool("search_sayistay_genel_kurul", {
|
||
"keywords": request.keywords, "page_to_fetch": request.page_to_fetch
|
||
})
|
||
|
||
@app.get("/api/sayistay/genel-kurul-document", tags=["Sayıştay"])
|
||
async def get_sayistay_genel_kurul_document(document_url: str, page_number: int = 1):
|
||
"""
|
||
Retrieve the full text of a Sayıştay Genel Kurul decision document in Markdown format for detailed analysis.
|
||
|
||
This tool converts the original General Assembly decision document into clean,
|
||
readable Markdown format suitable for legal analysis and research.
|
||
|
||
Input Requirements:
|
||
• decision_id: Use the ID from search_sayistay_genel_kurul results
|
||
• Decision ID must be non-empty string
|
||
|
||
Output Format:
|
||
• Clean Markdown text with legal formatting preserved
|
||
• Structured content with reasoning and conclusions
|
||
• Removes technical artifacts from source documents
|
||
|
||
Use for:
|
||
• Detailed analysis of audit precedents
|
||
• Research on public accountability standards
|
||
• Citation and reference building
|
||
• Legal interpretation and case study development
|
||
"""
|
||
return await call_mcp_tool("get_sayistay_genel_kurul_document_markdown", {
|
||
"document_url": document_url, "page_number": page_number
|
||
})
|
||
|
||
@app.post("/api/sayistay/search-temyiz-kurulu", tags=["Sayıştay"], summary="Search Court of Accounts (Appeals Board)")
|
||
async def search_sayistay_temyiz_kurulu(request: SayistaySearchRequest):
|
||
"""
|
||
Search Sayıştay Temyiz Kurulu (Appeals Board) decisions - appellate review of audit chamber findings with advanced filtering and institutional analysis.
|
||
|
||
The Appeals Board serves as the intermediate appellate authority in Turkey's audit system,
|
||
reviewing first-instance chamber decisions on audit findings, liability determinations,
|
||
and sanctions. Appeals Board decisions refine audit standards and ensure consistency
|
||
across different audit chambers.
|
||
|
||
Key Features:
|
||
• Chamber-specific filtering for targeted appeals analysis
|
||
• Institutional type categorization for audit pattern analysis
|
||
• Decision and account year filtering for temporal trends
|
||
• Audit subject matter classification and content search
|
||
• Appeal outcome tracking and precedent identification
|
||
• Pagination support for comprehensive coverage
|
||
|
||
Appeals Board Authority:
|
||
• Review and modification of chamber audit findings
|
||
• Standardization of audit liability determinations
|
||
• Consistency enforcement across audit chambers
|
||
• Intermediate precedent development for audit practice
|
||
• Quality control for first-instance audit decisions
|
||
|
||
Audit Review Areas:
|
||
• Government agency financial accountability appeals
|
||
• Municipality and local government audit review
|
||
• State enterprise oversight and performance audit appeals
|
||
• Educational institution audit finding review
|
||
• Healthcare system financial accountability appeals
|
||
• Public procurement oversight and compliance review
|
||
• Tax administration and revenue audit appeals
|
||
|
||
Use Cases:
|
||
• Research audit appeals patterns and outcomes
|
||
• Study chamber decision consistency and standards
|
||
• Analyze audit liability determination evolution
|
||
• Find precedents for specific audit finding types
|
||
• Track institutional audit patterns and compliance
|
||
• Academic public accountability and audit law research
|
||
|
||
Returns structured Appeals Board data with comprehensive appellate analysis metadata.
|
||
Use get_sayistay_temyiz_kurulu_document for full appeals decisions with detailed reasoning.
|
||
"""
|
||
return await call_mcp_tool("search_sayistay_temyiz_kurulu", {
|
||
"keywords": request.keywords, "page_to_fetch": request.page_to_fetch
|
||
})
|
||
|
||
@app.get("/api/sayistay/temyiz-kurulu-document", tags=["Sayıştay"])
|
||
async def get_sayistay_temyiz_kurulu_document(document_url: str, page_number: int = 1):
|
||
"""
|
||
Retrieve the full text of a Sayıştay Temyiz Kurulu decision document in Markdown format for detailed appeals analysis.
|
||
|
||
This tool converts the original Appeals Board decision document into clean,
|
||
readable Markdown format for analysis of appellate reasoning and standards.
|
||
|
||
Input Requirements:
|
||
• decision_id: Use the ID from search_sayistay_temyiz_kurulu results
|
||
• Decision ID must be non-empty string
|
||
|
||
Output Format:
|
||
• Clean Markdown text with appellate reasoning preserved
|
||
• Structured content with original findings and appeals analysis
|
||
• Removes technical artifacts from source documents
|
||
|
||
Use for:
|
||
• Analysis of appeals board reasoning and standards
|
||
• Research on audit liability determination evolution
|
||
• Understanding chamber decision review criteria
|
||
• Precedent analysis for audit appeal cases
|
||
"""
|
||
return await call_mcp_tool("get_sayistay_temyiz_kurulu_document_markdown", {
|
||
"document_url": document_url, "page_number": page_number
|
||
})
|
||
|
||
@app.post("/api/sayistay/search-daire", tags=["Sayıştay"], summary="Search Court of Accounts (Chambers)")
|
||
async def search_sayistay_daire(request: SayistaySearchRequest):
|
||
"""
|
||
Search Sayıştay Daire (Chamber) decisions - first-instance audit findings and sanctions from individual audit chambers with comprehensive filtering and subject categorization.
|
||
|
||
Chamber decisions represent first-instance audit findings, sanctions, and
|
||
liability determinations issued by specialized audit chambers. These form
|
||
the foundation of Turkey's public financial accountability system.
|
||
|
||
Key Features:
|
||
• Chamber-specific filtering (8 specialized audit chambers)
|
||
• Decision and account year filtering (2012-2025)
|
||
• Public administration type categorization
|
||
• Subject matter classification and full-text search
|
||
• Audit report tracking and institutional analysis
|
||
|
||
Use Cases:
|
||
• Research specific audit findings and sanctions
|
||
• Study chamber specialization and jurisdiction
|
||
• Analyze audit patterns by institution type
|
||
• Find precedents for financial irregularities
|
||
• Track audit evolution across fiscal years
|
||
"""
|
||
return await call_mcp_tool("search_sayistay_daire", {
|
||
"keywords": request.keywords, "page_to_fetch": request.page_to_fetch
|
||
})
|
||
|
||
@app.get("/api/sayistay/daire-document", tags=["Sayıştay"])
|
||
async def get_sayistay_daire_document(document_url: str, page_number: int = 1):
|
||
"""
|
||
Retrieve the full text of a Sayıştay Daire decision document in Markdown format for detailed audit findings analysis.
|
||
|
||
This tool converts the original chamber decision document into clean,
|
||
readable Markdown format for analysis of first-instance audit findings.
|
||
|
||
Input Requirements:
|
||
• decision_id: Use the ID from search_sayistay_daire results
|
||
• Decision ID must be non-empty string
|
||
|
||
Output Format:
|
||
• Clean Markdown text with audit findings preserved
|
||
• Structured content with violations and sanctions
|
||
• Removes technical artifacts from source documents
|
||
|
||
Use for:
|
||
• Detailed analysis of audit findings and methodology
|
||
• Research on specific types of financial irregularities
|
||
• Understanding chamber jurisdiction and specialization
|
||
• Case study development for audit training and compliance
|
||
"""
|
||
return await call_mcp_tool("get_sayistay_daire_document_markdown", {
|
||
"document_url": document_url, "page_number": page_number
|
||
})
|
||
|
||
# ============================================================================
|
||
# ADDITIONAL API ENDPOINTS
|
||
# ============================================================================
|
||
|
||
@app.get("/api/databases")
|
||
async def list_databases():
|
||
"""Comprehensive database information with tool mappings"""
|
||
return {
|
||
"total_tools": 33,
|
||
"databases": {
|
||
"yargitay": {
|
||
"name": "Yargıtay (Court of Cassation)",
|
||
"description": "Turkey's Supreme Court for civil and criminal matters",
|
||
"tools": 4,
|
||
"chambers": 52,
|
||
"search_tools": ["search_yargitay", "search_yargitay_bedesten"],
|
||
"document_tools": ["get_yargitay_document", "get_yargitay_bedesten_document"]
|
||
},
|
||
"danistay": {
|
||
"name": "Danıştay (Council of State)",
|
||
"description": "Turkey's Supreme Administrative Court",
|
||
"tools": 5,
|
||
"chambers": 27,
|
||
"search_tools": ["search_danistay_keyword", "search_danistay_detailed", "search_danistay_bedesten"],
|
||
"document_tools": ["get_danistay_document", "get_danistay_bedesten_document"]
|
||
},
|
||
"anayasa": {
|
||
"name": "Anayasa Mahkemesi (Constitutional Court)",
|
||
"description": "Constitutional review and individual applications",
|
||
"tools": 4,
|
||
"features": ["norm_control", "individual_applications", "human_rights"]
|
||
},
|
||
"rekabet": {
|
||
"name": "Rekabet Kurumu (Competition Authority)",
|
||
"description": "Antitrust and merger control",
|
||
"tools": 2,
|
||
"coverage": ["mergers", "cartels", "market_abuse", "sector_inquiries"]
|
||
},
|
||
"kik": {
|
||
"name": "Kamu İhale Kurulu (Public Procurement Authority)",
|
||
"description": "Government procurement disputes",
|
||
"tools": 2,
|
||
"coverage": ["procurement_disputes", "regulatory_decisions", "tender_violations"]
|
||
},
|
||
"sayistay": {
|
||
"name": "Sayıştay (Court of Accounts)",
|
||
"description": "Public audit and financial accountability",
|
||
"tools": 6,
|
||
"levels": ["general_assembly", "appeals_board", "audit_chambers"]
|
||
},
|
||
"emsal": {
|
||
"name": "Emsal (UYAP Precedents)",
|
||
"description": "Cross-court precedent database",
|
||
"tools": 2,
|
||
"coverage": ["multi_court", "precedent_analysis"]
|
||
},
|
||
"uyusmazlik": {
|
||
"name": "Uyuşmazlık Mahkemesi (Jurisdictional Disputes)",
|
||
"description": "Inter-court jurisdiction disputes",
|
||
"tools": 2,
|
||
"specialization": "jurisdictional_conflicts"
|
||
},
|
||
"bedesten_courts": {
|
||
"name": "Bedesten API Courts (Local/Appellate/KYB)",
|
||
"description": "First instance, appellate, and extraordinary appeal courts",
|
||
"tools": 6,
|
||
"courts": ["yerel_hukuk", "istinaf_hukuk", "kyb"],
|
||
"coverage": "complete_court_hierarchy"
|
||
}
|
||
}
|
||
}
|
||
|
||
@app.get("/api/stats")
|
||
async def get_statistics():
|
||
"""Comprehensive API statistics and capabilities"""
|
||
uptime = (datetime.now() - SERVER_START_TIME).total_seconds()
|
||
return {
|
||
"server": {
|
||
"uptime_seconds": uptime,
|
||
"start_time": SERVER_START_TIME.isoformat(),
|
||
"version": "1.0.0",
|
||
"status": "operational"
|
||
},
|
||
"coverage": {
|
||
"total_tools": 33,
|
||
"total_databases": 9,
|
||
"total_chambers": 79, # 52 Yargıtay + 27 Danıştay
|
||
"search_tools": 16,
|
||
"document_tools": 17
|
||
},
|
||
"capabilities": {
|
||
"advanced_search_operators": True,
|
||
"exact_phrase_search": True,
|
||
"date_range_filtering": True,
|
||
"chamber_filtering": True,
|
||
"boolean_logic": True,
|
||
"wildcard_search": True,
|
||
"pagination": True,
|
||
"markdown_conversion": True,
|
||
"pdf_processing": True,
|
||
"dual_api_support": True
|
||
},
|
||
"legal_coverage": {
|
||
"supreme_courts": ["Yargıtay", "Danıştay"],
|
||
"constitutional_law": "Anayasa Mahkemesi",
|
||
"administrative_law": "Full coverage",
|
||
"competition_law": "Rekabet Kurumu",
|
||
"public_procurement": "KİK",
|
||
"public_audit": "Sayıştay",
|
||
"court_hierarchy": "Complete (Local → Appellate → Supreme)",
|
||
"specialized_courts": ["Uyuşmazlık", "Constitutional", "Administrative"]
|
||
}
|
||
}
|
||
|
||
if __name__ == "__main__":
|
||
import uvicorn
|
||
uvicorn.run(app, host="0.0.0.0", port=8000)
|