Eigen AI-agent bovenop het juridische corpus van Europaius

Voor interactief gebruik verloopt de aanmelding via de standaard OAuth-flow in de browser; het MCP SDK voor zowel Python als TypeScript kan dit afhandelen. Voor server-agents en automatiseringen is er de API-sleutel uit de prijslijst van Europaius: bij het aanmelden voert u deze in plaats van uw e-mailadres in, of uw eigen OAuth-client doorloopt de autorisatie eenmalig en slaat een refresh token op. De sleutel begint met het voorvoegsel eur_ en is gekoppeld aan het account en de bijbehorende limieten.

• search(query, states): geeft JSON {"results":[{id,title,url,snippet}]} terug over wetgeving en jurisprudentie heen.
• fetch(id): volledige tekst van het document op basis van de identifier, inclusief metadata (rechtbank, datum, ECLI, land).
• search_law, find_caselaw, find_caselaw_cz: gericht zoeken in wetgeving of jurisprudentie met parameters.
• get_paragraf(state, law, paragraf): exacte tekst van een § op basis van het wetsnummer.
• souvislosti(para_id): geverifieerde citatieverbanden van een paragraaf.
• compare_norm(query, states): de meest relevante bepalingen uit elk land.
• vyklad, list_states: uitleg van een Tsjechische paragraaf, overzicht van de dekking.

Identifiers uit de tool search zijn stabiel en kunnen worden opgeslagen. Uitspraken van Tsjechische rechtbanken: case:<soud>:<slug>, waarbij soud staat voor ns, nss, us of justice (Tsjechische bronnen). Paragraaf: para:CZ:89/2012:§2991. Document van een ander land: eu:DE:<id>. De tool fetch geeft bij uitspraken de rechtsregel, het dictum en de motivering als één tekst terug, tot 80.000 tekens.

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": "promlčení pohledávky", "states": ["CZ"]}). Het resultaat is tekst met JSON, die u op de gebruikelijke manier inleest. De token verkrijgt u via de OAuth-flow of via aanmelding met de API-sleutel.

• Geef de agent een systeeminstructie om bij elke juridische bewering een tool aan te roepen en in het antwoord de URL uit het resultaat te vermelden.
• Sla documentidentifiers op, niet de teksten zelf; laad de volledige tekst pas wanneer dat nodig is.
• Houd er rekening mee dat de eerste query naar een buitenlandse jurisdictie langer duurt; gebruik een time-out van minimaal 120 seconden.
• Respecteer de accountlimieten; een agent in een lus verbruikt snel 100 queries, gebruik voor productie een abonnement.