Własny agent AI oparty na korpusie prawnym Europaius

Do interaktywnego użycia służy standardowe logowanie OAuth w przeglądarce; MCP SDK dla Pythona i TypeScript umie je obsłużyć. Dla agentów serwerowych i automatyzacji przeznaczony jest klucz API z cennika Europaius: przy logowaniu wpisuje się go w miejsce e-maila, albo własny klient OAuth przechodzi autoryzację jednorazowo i zapisuje token odświeżający. Klucz zaczyna się od przedrostka eur_ i jest powiązany z kontem oraz jego limitami.

• search(query, states): zwraca JSON {"results":[{id,title,url,snippet}]} obejmujący przepisy i orzecznictwo.
• fetch(id): pełny tekst dokumentu na podstawie identyfikatora, wraz z metadanymi (sąd, data, ECLI, państwo).
• search_law, find_caselaw, find_caselaw_cz: ukierunkowane wyszukiwanie w przepisach lub orzecznictwie z parametrami.
• get_paragraf(state, law, paragraf): dokładna treść paragrafu według numeru ustawy.
• souvislosti(para_id): zweryfikowane powiązania cytowań paragrafu.
• compare_norm(query, states): najbardziej relewantne przepisy z każdego państwa.
• vyklad, list_states: interpretacja czeskiego paragrafu, przegląd zakresu.

Identyfikatory z narzędzia search są stabilne i można je zapisywać. Orzeczenia czeskich sądów: case:<soud>:<slug>, gdzie soud to ns, nss, us lub justice (czeskie źródła). Paragraf: para:CZ:89/2012:§2991. Dokument z zagranicznego państwa: eu:DE:<id>. Narzędzie fetch zwraca dla orzeczenia tezę prawną, rozstrzygnięcie i uzasadnienie w jednym tekście, do 80 tysięcy znaków.

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"]}). Wynik to tekst z JSON, który wczytujecie w standardowy sposób. Token uzyskuje się przez przejście OAuth albo z logowania kluczem API.

• Dajcie agentowi instrukcję systemową, aby przy każdym twierdzeniu prawnym wywołał narzędzie i podał w odpowiedzi URL z wyniku.
• Zapisujcie identyfikatory dokumentów, nie teksty; pełny tekst wczytujcie tylko w razie potrzeby.
• Liczcie się z tym, że pierwsze zapytanie dotyczące zagranicznego państwa trwa dłużej; ustawcie limit czasu co najmniej 120 s.
• Respektujcie limity konta; agent w pętli szybko wykorzysta 100 zapytań, do produkcji użyjcie abonamentu.