Skip to main content
Glama

19

1,007

0

MCP tools in this public edition

offline tests, no network

free-text queries sent to the sources in the legal profile

I built Yurko so that a model stops quoting the law from memory. A Claude Code skill drafts a legal position on top of the server, and every legal statement in the draft sits under a verbatim quote from the source, with the article and the version it came from.

Install

Python 3.12 or newer and uv. From the folder you clone into:

git clone https://github.com/prodelt/yurko && cd yurko
claude mcp add yurko -s user -- uv run --quiet --no-project --python 3.12 --with-requirements "$PWD/requirements.txt" python "$PWD/server_env.py"

Then ask Claude to quote article 3 of the Constitution of Ukraine and check the quote.

Related MCP server: ruslaw

What verify_quote returns

Real calls on 6 October 2026 against article 3 of the Constitution of Ukraine. A missing document and a missing article are different answers (not_found, path_not_found), and an unreachable source says so (source_unavailable).

Sources and tools

The server reads Ukrainian legislation from the Verkhovna Rada site, EU law through Cellar, ELI and CELEX, case law of the European Court of Human Rights and the Court of Justice of the EU, case cards of the International Court of Justice, and public Ukrainian registries: court decisions, debtors and Prozorro tenders. The legal order is a parameter (legal_order), so adding a jurisdiction adds a value rather than a new set of tools. list_coverage says which operations have been tested for each source.

Group

Tools

Legislation

resolve_law_id, query_law, get_article, get_multiple_articles, get_law_metadata, list_laws, discover_laws, search_across_laws, search_articles

Case law

search_decisions, get_decision, get_case

Registries

search_debtors, search_tenders, get_tender, list_registries, discover_registries

Checks

verify_quote, list_coverage

The legal profile

The default profile is built for work on real matters:

  • free text from the user is never sent to the sources;

  • the server refuses to start with someone else's database or a model API key;

  • the server process sees only environment variables from an allow-list (server_env.py);

  • no tool accepts a file or a path, so case materials cannot reach the server.

What Yurko does not do

It does not give legal advice, and a match from verify_quote proves only that the words are in the source. Procedural deadlines are left to a lawyer. This public edition exposes 19 of the 23 tools I run.

The /yurko skill

An orchestrator is the only author of documents. Sub-agents read, search, argue the other side and check the draft. Risks are given as categories, never as a percentage chance. The run keeps its state in files, so it can stop and resume, and it records its own cost.

A separate court cycle runs an adversarial simulation with information barriers between the roles and a blind panel of three models. It is back-tested on cases whose outcome is already known.

In production

The server runs on Render with a Postgres corpus. In production the Ukrainian corpus is searched with full-text search only, so query text never goes to an embedding provider. Hybrid search (full text plus vectors, merged with reciprocal rank fusion) is in the code but switched off.

Run it locally

Dependency versions are pinned: uv.lock is the single source, and requirements.txt (stdio mode) and requirements-hosted.txt (Docker, with Postgres and Playwright) are exported from it with hashes.

With uv, without installing anything into the code folder:

uv run --quiet --no-project --python 3.12 --with-requirements requirements.txt python server_env.py

With your own virtual environment:

python -m venv .venv
.venv/bin/pip install -r requirements.txt          # Windows: .venv\Scripts\pip
.venv/bin/python server_env.py                     # stdio; the entry point builds an allow-listed environment

HTTP mode for a hosted server: MCP_TRANSPORT=http, PORT and UKRAINE_LAWS_API_KEY. The image and the deployment are in Dockerfile and render.yaml.

Settings

Variable

Default

What it does

YURKO_PROFILE

legal

legal keeps free text away from the sources and will not start with a foreign database or a model API key; engineering is for development

YURKO_CACHE_DIR

the OS cache directory

where the server writes its cache; it never writes into the code folder

USE_PG_BACKEND, DATABASE_URL

0

use Postgres instead of the file cache

RADA_LIVE_CHANNEL

1

0 turns off live reads from the Rada site

COURT_REGISTRY_URL, ERB_API_URL, PROZORRO_API_URL, PROZORRO_SEARCH_URL, DATA_GOV_UA_API_URL

official endpoints

override a registry endpoint

Development

Tests never touch the network or the code folder. tests/conftest.py fails any test that tries to go online, points YURKO_CACHE_DIR at a temporary folder and checks that cache/ in the code folder stays unchanged. Tests that really need the network are marked live and run only with YURKO_LIVE=1.

uv sync --frozen --extra dev
.venv/bin/python -m pytest -q          # Windows: .venv\Scripts\python

.mcp.json connects the server when you open this folder in Claude Code on Windows; on macOS and Linux change its command to .venv/bin/python.

Known quirks of the Rada site, such as TLS resets on large handshakes and ignored search filters, are written up in docs/.

License

MIT, see LICENSE. The skill under skill/ adapts parts of other open-source projects; see skill/NOTICE.md.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables Brazilian legal practitioners to search and verify case law, súmulas, and federal legislation against official sources, and to audit entire draft documents citation by citation with source provenance, collection dates, and verification status. Every response carries its own verification flag so a failed source lookup never silently becomes "no results", and citations blocked by anti-bot protections are returned as pending manual review with an official search link.
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI agents to search Russian legislation, extract verbatim article texts, verify the current status of norms (including repealed and upcoming amendments), and track State Duma bills against official sources. Anchor responses to the current system date, flag future effective editions, and return verifiable ConsultantPlus, Garant, pravo.gov.ru, and SOZD links to prevent hallucinations.
      4
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables MCP clients such as Claude to search and retrieve official Polish legislation from the Sejm ELI API and court decisions from SAOS, fetch exact provision wording, check amendments, and verify legal citations. Every result carries explicit, component-level verification statuses so users can distinguish sourced, confirmed material from claims that could not be established.
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables read-only searching of Greek enacted legislation, official gazette publications, and case law across all three judicial tiers (first instance, appellate/regional, and supreme/constitutional), with full-text retrieval converted to clean Markdown. It also verifies statutory and case law citations against official national registries such as et.gr, areiospagos.gr, and adjustice.gr.
      6
      MIT