check_government_servers_health
Use this when checking if Turkish legal database servers are online and responding.
LABSCO SUMMARY
Turkish legal research becomes one query surface instead of eleven websites.
What it takes off you is knowing which portal holds the answer: a competition question, a tax ruling and a Constitutional Court judgment come from three different institutions, and here they are three calls with the same shape. Every search has a matching fetch that returns the full text as Markdown, so the citation and the passage behind it arrive together rather than as a link you go and open.
What it is
A research layer over Türkiye's official legal databases. Every source has a search call and a matching call that returns the full decision text as Markdown. Run it locally.
What you get
- Court decisions from Yargıtay, Danıştay, local courts, appeals courts and KYB through Bedesten, filtered by chamber, court type and decision date
- UYAP Emsal precedent decisions, searchable by keyword, court, case and decision numbers and date range
- Constitutional Court decisions — norm control and individual applications — with the type auto-detected from the URL when fetching
- Jurisdictional dispute decisions from the Uyuşmazlık Mahkemesi, which resolve conflicts between the civil and administrative courts
- Public procurement decisions from KİK, across dispute, regulatory and court types
- Competition and antitrust decisions from the Rekabet Kurumu
- Court of Accounts audit decisions from Sayıştay, across its general assembly, appeals board and chambers
- Data protection decisions from KVKK, on privacy, consent and data breaches
- Banking regulation decisions from BDDK, covering licences, fintech and payment services
- BTK board decisions, by title keyword, decision number, decision date, publication date and department
- GİB özelge tax rulings — 18k+ of them, on VAT, income tax, corporate tax and stamp duty
- Insurance arbitration decisions from 64 Hakem Karar Dergisi issues covering 2010 to 2025, searchable across issues or inside a single issue, which is split into individual decisions and ranked by relevance
- A health check reporting whether the government servers are answering
Requirements
You need uv to run uvx yargi-mcp on your own machine. Network access to the government databases is required: every answer is a live query against them. Bedesten is rate-limited upstream, and searches and document fetches count against the same limit, and a throttled request comes back telling you how long to wait.
Setup effort
One command — uvx yargi-mcp
USE CASES
01
Finding precedent on a point of law
Search the higher courts through Bedesten by chamber and date, then pull the decisions worth reading as full Markdown.
02
Checking how the Constitutional Court has ruled
Search norm control decisions and individual applications together, then read the judgment itself rather than a summary.
03
Answering a tax question with an official ruling
Search the Revenue Administration's özelge collection on the tax at issue and retrieve the ruling in full.
04
Researching a regulator's line on something
Competition, data protection, banking and telecoms decisions each have their own search and fetch pair, so one question spans all four without changing tools.
05
Digging into insurance arbitration
Search across the journal issues, then search inside the one issue that matters — it is split into individual decisions for you.
06
Telling a dead lookup from an empty result
Check whether the government servers are answering before concluding that nothing matched.
28 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
fetch
Only for ChatGPT Deep Research. Retrieves one Turkish legal document by numeric Bedesten ID. For regular MCP use, prefer get_bedesten_document_markdown. This performs one Bedesten document request and avoids an extra metadata lookup to respect upstream rate limits.
get_anayasa_document_unified
Use this when retrieving full text of a Constitutional Court decision. Auto-detects decision type from URL.
get_bddk_document_markdown
Use this when retrieving full text of a BDDK banking regulation decision. Returns paginated Markdown format.
get_bedesten_document_markdown
Use this when retrieving full text of a Bedesten search result by documentId. Counts against the same Bedesten upstream rate limit as search; after 429, wait retry_after seconds before retrying.
get_btk_document_markdown
Use this when retrieving full text of a BTK Board decision PDF. Returns paginated Markdown.
get_emsal_document_markdown
Use this when retrieving full text of an Emsal precedent decision. Returns clean Markdown format.
get_gib_ozelge_document_markdown
Retrieve full text of a GİB özelge (tax ruling) by numeric ID. Returns paginated Markdown (5000-char chunks) with title, reference number, date and law metadata.
get_kik_v2_document_markdown
Use this when retrieving full text of a KİK procurement decision. Returns document in Markdown format.
get_kvkk_document_markdown
Use this when retrieving full text of a KVKK data protection decision. Returns paginated Markdown with metadata.
get_rekabet_kurumu_document
Use this when retrieving full text of a Competition Authority decision. Returns paginated Markdown format.
get_sayistay_document_unified
Use this when retrieving full text of a Sayıştay audit decision. Returns clean Markdown format.
get_sigorta_tahkim_document_markdown
Retrieve full PDF content of a Sigorta Tahkim Komisyonu Hakem Karar Dergisi issue by number. Returns paginated Markdown. Issues 1-64 available (2010-2025).
get_uyusmazlik_document_markdown_from_url
Use this when retrieving full text of an Uyuşmazlık Mahkemesi decision. Returns clean Markdown format.
search
Only for ChatGPT Deep Research. Searches Bedesten-supported Turkish court databases and returns OpenAI Deep Research compatible results (id, title, text, url). For regular MCP use, prefer search_bedesten_unified. This tool does not fetch document bodies during search so one query stays within Bedesten upstream rate limits; call fetch only for selected result IDs.
search_anayasa_unified
Use this when searching Turkish Constitutional Court decision records. Supports norm control decisions and individual application decisions. Norm control filters include reviewed norm metadata; results are court decisions.
search_bddk_decisions
Use this when searching Turkish banking regulation (BDDK) decisions. For banking licenses, fintech, and payment services.
search_bedesten_unified
Use this for Turkish court decision records from Yargıtay, Danıştay, Local Courts, Appeals Courts, and KYB via Bedesten. Prefer narrow court_types over all courts. pageSize is intentionally fixed to 10 results per page. Bedesten is upstream rate-limited; avoid parallel repeated calls and wait retry_after seconds after 429 responses.
search_btk_decisions
Use this when searching BTK Board decisions (Bilgi Teknolojileri ve Iletisim Kurumu Kurul Kararlari). Supports decision title keywords, decision number, decision date, publication date, and related department filters.
search_emsal_detailed_decisions
Use this when searching UYAP precedent decisions (Emsal). For lower court decisions and case law.
search_gib_ozelge
Search Turkish GİB özelge records (Revenue Administration tax rulings) - 18k+ rulings on VAT, income tax, corporate tax, stamp duty interpretations. kanunNo filters the related law number; returned documents are özelge/tax ruling records.
search_kik_v2_decisions
Use this when searching Turkish public procurement disputes (KİK). Supports dispute, regulatory, and court decision types.
search_kvkk_decisions
Use this when searching Turkish data protection (KVKK/GDPR equivalent) decisions. For privacy, consent, and data breach cases.
search_rekabet_kurumu_decisions
Use this when searching Turkish competition law and antitrust decisions (Rekabet Kurumu).
search_sayistay_unified
Use this when searching Turkish Court of Accounts (Sayıştay) audit decisions. Supports Genel Kurul, Temyiz Kurulu, and Daire decisions.
search_sigorta_tahkim_decisions
Search Sigorta Tahkim Komisyonu (Insurance Arbitration Commission) decisions from Hakem Karar Dergisi journals (64 issues, 2010-2025). Covers insurance disputes: traffic, health, fire, DASK, life insurance.
search_uyusmazlik_decisions
Use this when searching jurisdictional dispute court (Uyuşmazlık Mahkemesi) decisions. Resolves conflicts between civil and administrative courts.
search_within_sigorta_tahkim_issue
Search within a specific Sigorta Tahkim Komisyonu journal issue for keywords. Downloads the PDF, splits into individual decisions, and returns matching decisions with excerpts sorted by relevance.
BEFORE YOU INSTALL
What to know first
Tools you get
28 tools when we connected. A 29th tool, semantic search, appears only with an embedding provider set: EMBEDDING_PROVIDER=local with a local OpenAI-compatible server, or OPENROUTER_API_KEY or ORCAROUTER_API_KEY. The documentation prints both 26 and 28; 28 is right.
Requires
- uvx on PATH
- Python 3.11 or later
CONTEXT COST
Moderate Standing cost
Rated by the size of the 28 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
5ire
TERMINAL
uvx yargi-mcpMCP Clients
Claude Desktop — local, Antigravity — local
JSON
{
"mcpServers": {
"yargi-mcp": {
"command": "uvx",
"args": [
"yargi-mcp"
]
}
}
}Gemini CLI
GEMINI CLI · JSON
{
"mcpServers": {
"yargi_mcp": {
"command": "uvx",
"args": [
"yargi-mcp"
]
}
}
}
