Lasten AI agent nad pravnim korpusom Europaius

Za interaktivno uporabo poteka standardna OAuth prijava v brskalniku; MCP SDK za Python in TypeScript jo zna izvesti. Za strežniške agente in avtomatizacije služi API ključ iz cenika Europaius: pri prijavi ga vnesete namesto e-poštnega naslova, ali pa lasten OAuth odjemalec opravi avtorizacijo enkrat in shrani osvežitveni žeton (refresh token). Ključ se začne s predpono eur_ in je vezan na račun ter njegove omejitve.

• search(query, states): vrne JSON {"results":[{id,title,url,snippet}]} po zakonih in sodni praksi.
• fetch(id): celotno besedilo dokumenta po identifikatorju, vključno z metapodatki (sodišče, datum, ECLI, država).
• search_law, find_caselaw, find_caselaw_cz: ciljno iskanje v zakonodaji ali sodni praksi s parametri.
• get_paragraf(state, law, paragraf): natančno besedilo člena/paragrafa po številki zakona.
• souvislosti(para_id): preverjene citacijske povezave paragrafa.
• compare_norm(query, states): najrelevantnejše določbe iz vsake države.
• vyklad, list_states: razlaga češkega paragrafa, pregled pokritosti.

Identifikatorji iz orodja search so stabilni in jih lahko shranjujete. Odločbe čeških sodišč: case:<soud>:<slug>, kjer je sodišče ns, nss, us ali justice (gre za češke vire). Paragraf: para:CZ:89/2012:§2991. Dokument tuje države: eu:DE:<id>. Orodje fetch pri odločbah vrne pravni stavek, izrek in obrazložitev v enem besedilu, do 80 tisoč znakov.

from mcp import ClientSession; from mcp.client.streamable_http import streamablehttp_client; async with streamablehttp_client("https://mcp.europaius.com/mcp", headers={"Authorization": "Bearer <token>"}) as (r, w, _): async with ClientSession(r, w) as s: await s.initialize(); res = await s.call_tool("search", {"query": "zastaranje terjatve", "states": ["CZ"]}). Rezultat je besedilo z JSON-om, ki ga naložite na standarden način. Žeton pridobite z OAuth postopkom ali s prijavo z API ključem.

• Agentu dajte sistemsko navodilo, naj za vsako pravno trditev pokliče orodje in v odgovoru navede URL iz rezultata.
• Shranjujte identifikatorje dokumentov, ne besedil; celotno besedilo naložite šele, ko ga potrebujete.
• Upoštevajte, da prva poizvedba za tujo državo traja dlje; uporabite časovno omejitev vsaj 120 s.
• Upoštevajte omejitve računa; agent v zanki hitro porabi 100 poizvedb, za produkcijo uporabite naročnino.