Vlastní AI agent nad právním korpusem Europaius

Přihlášení z kódu

Pro interaktivní použití proběhne standardní OAuth přihlášení v prohlížeči; MCP SDK pro Python i TypeScript ho umí obsloužit. Pro serverové agenty a automatizace slouží API klíč z ceníku Europaius: při přihlášení ho vložíte místo e-mailu, nebo vlastní OAuth klient projde autorizací jednou a uloží si obnovovací token. Klíč začíná předponou eur_ a je vázaný na účet a jeho limity.

Nástroje

• search(query, states): vrátí JSON {"results":[{id,title,url,snippet}]} napříč zákony a judikaturou.
• fetch(id): plný text dokumentu podle identifikátoru, včetně metadat (soud, datum, ECLI, stát).
• search_law, find_caselaw, find_caselaw_cz: cílené vyhledávání v legislativě nebo judikatuře s parametry.
• get_paragraf(state, law, paragraf): přesné znění § podle čísla zákona.
• souvislosti(para_id): ověřené citační vazby paragrafu.
• compare_norm(query, states): nejrelevantnější ustanovení z každého státu.
• vyklad, list_states: výklad českého paragrafu, přehled pokrytí.

Identifikátory

Identifikátory z nástroje search jsou stabilní a lze je ukládat. Rozhodnutí českých soudů: case:<soud>:<slug>, kde soud je ns, nss, us nebo justice. Paragraf: para:CZ:89/2012:§2991. Dokument zahraničního státu: eu:DE:<id>. Nástroj fetch vrací u rozhodnutí právní větu, výrok a odůvodnění v jednom textu, do 80 tisíc znaků.

Ukázka v Pythonu

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"]}). Výsledek je text s JSON, který načtete standardně. Token získáte OAuth průchodem nebo z přihlášení API klíčem.

Doporučení pro agenty

• Dejte agentovi systémovou instrukci, aby pro každé právní tvrzení zavolal nástroj a v odpovědi uvedl URL z výsledku.
• Ukládejte identifikátory dokumentů, ne texty; plný text načítejte až při potřebě.
• Počítejte s tím, že první dotaz na zahraniční stát trvá déle; použijte časový limit alespoň 120 s.
• Respektujte limity účtu; agent v cyklu spotřebuje 100 dotazů rychle, pro produkci použijte předplatné.

Časté otázky

Související průvodci

Orientační informace, nenahrazují právní poradenství. Připojení konektoru vyžaduje účet Europaius (zdarma). Více o Europaius · Právní rádce