Agente AI proprio sul corpus giuridico Europaius

Per l'uso interattivo si esegue il consueto login OAuth nel browser; l'MCP SDK, sia per Python che per TypeScript, è in grado di gestirlo. Per agenti server e automazioni si usa l'API key indicata nel listino prezzi di Europaius: al momento del login la si inserisce al posto dell'e-mail, oppure un client OAuth proprio completa l'autorizzazione una sola volta e salva il refresh token. La chiave inizia con il prefisso eur_ ed è legata all'account e ai relativi limiti.

• search(query, states): restituisce il JSON {"results":[{id,title,url,snippet}]} su leggi e giurisprudenza.
• fetch(id): testo integrale del documento in base all'identificatore, inclusi i metadati (corte, data, ECLI, stato).
• search_law, find_caselaw, find_caselaw_cz: ricerca mirata nella legislazione o nella giurisprudenza con parametri specifici.
• get_paragraf(state, law, paragraf): testo esatto dell'articolo in base al numero di legge.
• souvislosti(para_id): collegamenti citazionali verificati dell'articolo.
• compare_norm(query, states): le disposizioni più rilevanti per ciascuno stato.
• vyklad, list_states: interpretazione dell'articolo ceco, panoramica della copertura.

Gli identificatori restituiti dallo strumento search sono stabili e possono essere salvati. Decisioni dei tribunali cechi: case:<soud>:<slug>, dove il tribunale è ns, nss, us o justice (fonti ceche). Articolo: para:CZ:89/2012:§2991. Documento di uno stato estero: eu:DE:<id>. Lo strumento fetch restituisce per le decisioni la massima, il dispositivo e la motivazione in un unico testo, fino a 80 mila caratteri.

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": "prescrizione del credito", "states": ["CZ"]}). Il risultato è un testo con JSON, che si può caricare in modo standard. Il token si ottiene tramite il flusso OAuth oppure a partire dal login con API key.

• Date all'agente un'istruzione di sistema che lo obblighi a richiamare lo strumento per ogni affermazione giuridica e a citare nella risposta l'URL presente nel risultato.
• Salvate gli identificatori dei documenti, non i testi; caricate il testo integrale solo quando serve.
• Tenete conto che la prima richiesta relativa a uno stato estero richiede più tempo; usate un timeout di almeno 120 s.
• Rispettate i limiti dell'account; un agente in un ciclo consuma rapidamente 100 richieste, per la produzione usate un abbonamento.