Türk Hukuku İçtihat MCP

Jurisprudência turca de bancos de dados oficiais: decisões do Tribunal de Cassação e tribunais regionais de apelação via UYAP Emsal, Conselho de Estado e aplicações individuais do Tribunal Constitucional, com citações verificáveis.

GitHub
14

Documentação

turk-hukuku-ictihat-mcp

Um servidor MCP que disponibiliza decisões judiciais turcas a ferramentas de inteligência artificial a partir da fonte oficial: Tribunal de Cassação (Ministério da Justiça, Legislação e Jurisprudência), Tribunais Regionais de Apelação e de primeira instância (UYAP Emsal), jurisdição administrativa (Conselho de Estado) e jurisdição constitucional (Banco de Dados de Decisões do AYM).

O objetivo em uma frase: quando o modelo fizer referência a uma decisão, a referência (tribunal, câmara, número do processo/decisão, data) deve vir da fonte oficial, não da memória. A referência é retornada de forma estruturada e cada resultado contém um link para a página oficial da decisão (kaynak). O modelo ainda pode errar; confirme cada referência por meio desse link.

Não é aconselhamento jurídico. Esta ferramenta facilita o acesso à jurisprudência; avalie você mesmo a atualidade da decisão, seu status de trânsito em julgado e sua adequação ao caso concreto. A vinculatividade e o valor de precedente de uma decisão exigem uma análise jurídica separada.

Detalhes: SORUMLULUK-REDDI.md · PRIVACY.md (sem coleta de dados, sem telemetria; links externos apenas para sites oficiais de decisões).

Documentação e guia de instalação: turk-hukuku.com/mcp · Se você não usa terminal, o aplicativo de desktop instala e executa este servidor automaticamente (Mac e Windows).

O que faz

FerramentaFunção
ictihat_ara(ifade, mahkeme, adet, sayfa)Busca decisões; retorna referência + citação + id
karar_getir(karar_id, mahkeme)Texto completo oficial de uma decisão (referência + fundamentação + dispositivo)

mahkeme aceita os seguintes valores:

ValorEscopoFonte
adli (padrão)Tribunal de Cassação + Tribunais Regionais de Apelação e de primeira instância, juntosBedesten + UYAP Emsal
yargitayCâmaras e conselhos do Tribunal de CassaçãoBedesten (mevzuat.adalet.gov.tr)
emsalCâmaras cíveis dos Tribunais Regionais de Apelação e de primeira instânciaUYAP Emsal
idariConselho de Estadokarararama.danistay.gov.tr
anayasaReclamações individuais ao AYMkararlarbilgibankasi.anayasa.gov.tr
normControle normativo do AYM (anulação/objeção)mesma fonte

Passe o valor de mahkeme que você usou na busca exatamente igual para karar_getir (o id com prefixo yargitay: sempre vem do Tribunal de Cassação). As palavras são pesquisadas em conjunto; todas devem estar presentes; use aspas duplas para expressões exatas ("ihtiyaç nedeniyle tahliye"). Na busca do Tribunal de Cassação, Emsal e AYM, o sinal de menos no início exclui termos (-ceza), e OR significa "ou". O sufixo após o apóstrofo é descartado ("TMK'nın" → "TMK"). Na busca adli, adet é no mínimo 2.

Fluxo típico: ictihat_ara("ihtiyaç nedeniyle tahliye", mahkeme="yargitay") → selecione um id do resultado → karar_getir(id, mahkeme="yargitay") → texto completo da decisão. Cada resultado traz uma atif pronta: "Yargıtay 6. Hukuk Dairesi, E.2015/2565 K.2016/25, T.18.01.2016" · "Danıştay 6. Daire, E.2023/1084 K.2025/10046" · "AYM, B. No: 2020/36883, K.T. 16/12/2025". Cada resultado também fornece a página pública da decisão (kaynak); as decisões do Tribunal de Cassação e do UYAP Emsal são abertas em formato legível em mevzuat.adalet.gov.tr/ictihat/<id>.

Escopo

  • Tribunal de Cassação (mahkeme="yargitay"): decisões das câmaras cíveis e criminais e dos conselhos; backend do Programa de Legislação e Jurisprudência do Ministério da Justiça (bedesten.adalet.gov.tr). Página pública de cada decisão: https://mevzuat.adalet.gov.tr/ictihat/<id>.
  • Tribunais Regionais de Apelação e de primeira instância (mahkeme="emsal"): câmaras cíveis dos Tribunais Regionais de Apelação e alguns tribunais de primeira instância (tribunal comercial de primeira instância, direitos de propriedade intelectual e industrial); UYAP Emsal. O UYAP Emsal público não contém decisões do Tribunal de Cassação.
  • Jurisdição comum, em conjunto (mahkeme="adli", padrão): busca nas duas fontes ao mesmo tempo; o id dos resultados do Tribunal de Cassação tem o prefixo yargitay:.
  • Jurisdição administrativa (mahkeme="idari"): decisões do Conselho de Estado (karararama.danistay.gov.tr, mais de 390.000 documentos).
  • Jurisdição constitucional (mahkeme="anayasa"): decisões de reclamações individuais do AYM (kararlarbilgibankasi.anayasa.gov.tr).
  • Controle normativo (mahkeme="norm"): decisões de anulação/objeção do AYM; a referência é retornada com os números E./K. e informações do Diário Oficial (mesma fonte).

Como funciona

Cada fonte oferece um endpoint de busca e um de documento:

Bedesten   : POST /emsal-karar/searchDocuments       + POST /emsal-karar/getDocumentContent
UYAP Emsal : POST /aramalist (aranan)               + GET /getDokuman?id
Danıştay   : POST /aramalist (andKelimeler[])        + GET /getDokuman?id&arananKelime
AYM        : POST /api/core/public/search (JSON; arama da tam metin de aynı uçtan)

O servidor realiza a busca, retorna as referências de forma estruturada e converte o texto em texto simples legível (limpo da codificação HTML aninhada do Conselho de Estado e do corpo exportado em Word do AYM). É totalmente local; nenhum dado é coletado.

Respeito aos sites oficiais

  • Identifica-se. Envia seu próprio User-Agent em cada solicitação: turk-hukuku-ictihat-mcp/<sürüm> (+https://turk-hukuku.com/mcp/). Não se passa por navegador nem por aplicativo web oficial; não adiciona cabeçalhos para esse fim.
  • Solicitações limitadas por site. Apenas uma solicitação por vez é enviada ao mesmo site, com um intervalo de pelo menos um segundo entre solicitações (aproximadamente uma solicitação por segundo por site).
  • Cache na sessão. As decisões obtidas (no máximo 256 decisões) são mantidas apenas na memória durante a sessão; se a mesma decisão for solicitada novamente, o site não é acessado de novo. Nada é gravado em disco.
  • Não resolve nem ignora captcha; para no limite. Se o site solicitar verificação (captcha), recusar o acesso (HTTP 403), informar limite de acesso (HTTP 429), redirecionar para outra página em vez dos dados esperados ou retornar uma página web, o servidor para, não repete a solicitação e direciona você para o site oficial. Ele não envia novas solicitações a esse site por um período (aproximadamente dois minutos ou o tempo informado pelo site). A solicitação de verificação é identificada apenas pela caixa de verificação na página ou pela flag de verificação do site; uma decisão que mencione "não sou um robô" não interrompe o servidor.
  • Fornece uma mensagem curta em erros temporários. Se houver uma falha temporária no site (HTTP 5xx), uma resposta "não encontrado" (HTTP 404) ou um erro de rede, o servidor informa isso com uma mensagem curta em turco e não repete a solicitação; nesse caso, o período de espera não é aplicado.

Instalação

Publicado no PyPI; funciona com uv sem necessidade de instalação separada.

Claude Code

claude mcp add turk-hukuku-ictihat -- uvx --from turk-hukuku-ictihat-mcp turk-hukuku-ictihat

OpenAI Codex

~/.codex/config.toml:

[mcp_servers.turk-hukuku-ictihat]
command = "uvx"
args = ["--from", "turk-hukuku-ictihat-mcp", "turk-hukuku-ictihat"]

Gemini CLI

Em mcpServers dentro de ~/.gemini/settings.json:

"turk-hukuku-ictihat": {
  "command": "uvx",
  "args": ["--from", "turk-hukuku-ictihat-mcp", "turk-hukuku-ictihat"]
}

Alternativa: pip

pip install turk-hukuku-ictihat-mcp
# komut: turk-hukuku-ictihat   (ya da: python -m turk_hukuku_ictihat)

Relacionado: para textos de leis/legislação, veja turk-hukuku-mevzuat-mcp.

Licença

MIT · © 2026 Aydın Can Polatkan

Os dados pertencem às instituições de origem (Ministério da Justiça, UYAP Emsal, Conselho de Estado, Tribunal Constitucional); este projeto é apenas um cliente independente que facilita o acesso a textos oficiais de decisões públicas.

Este trabalho é dedicado à memória eterna do meu pai, o Juiz Vahit Polatkan, que dedicou sua vida ao judiciário turco.