Vlastiti AI agent nad pravnim korpusom Europaius

Za interaktivnu upotrebu provodi se standardna OAuth prijava u pregledniku; MCP SDK za Python i TypeScript to podržava. Za poslužiteljske agente i automatizacije koristi se API ključ iz cjenika Europaius: pri prijavi ga unesete umjesto e-mail adrese, ili vlastiti OAuth klijent jednom prođe autorizaciju i pohrani obnovljivi token (refresh token). Ključ počinje prefiksom eur_ i vezan je za korisnički račun i njegova ograničenja.

• search(query, states): vraća JSON {"results":[{id,title,url,snippet}]} iz zakona i sudske praxe.
• fetch(id): cjeloviti tekst dokumenta prema identifikatoru, uključujući metapodatke (sud, datum, ECLI, država).
• search_law, find_caselaw, find_caselaw_cz: ciljano pretraživanje zakonodavstva ili sudske praxe s parametrima.
• get_paragraf(state, law, paragraf): točan tekst članka prema broju zakona.
• souvislosti(para_id): provjerene citatne veze članka.
• compare_norm(query, states): najrelevantnije odredbe iz svake države.
• vyklad, list_states: tumačenje češkog članka, pregled pokrivenosti.

Identifikatori iz alata search su stabilni i mogu se pohranjivati. Odluke čeških sudova: case:<soud>:<slug>, gdje je soud ns, nss, us ili justice — riječ je o češkim izvorima. Članak: para:CZ:89/2012:§2991. Dokument druge države: eu:DE:<id>. Alat fetch kod odluka vraća pravnu rečenicu, izreku i obrazloženje u jednom tekstu, do 80 tisuća znakova.

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": "zastara potraživanja", "states": ["CZ"]}). Rezultat je tekst s JSON-om koji učitavate na standardan način. Token dobivate OAuth postupkom ili prijavom API ključem.

• Dajte agentu sistemsku instrukciju da za svaku pravnu tvrdnju pozove alat i u odgovoru navede URL iz rezultata.
• Pohranjujte identifikatore dokumenata, a ne tekstove; cjeloviti tekst dohvaćajte samo kad je potreban.
• Uzmite u obzir da prvi upit za drugu državu traje dulje; koristite vremensko ograničenje od najmanje 120 s.
• Poštujte ograničenja računa; agent u petlji brzo potroši 100 upita, za produkciju koristite pretplatu.