bazaligjore

An MCP (Model Context Protocol) server for researching Albanian legislation. It exposes a structured index of the Official Gazette (Fletorja Zyrtare, 2000–present, ~43,500 acts with OCR full text), the official amendment graph between acts, and ~1,470 Constitutional Court (Gjykata Kushtetuese) decisions — all built from the public sources at qbz.gov.al and gjykatakushtetuese.gov.al.

Albania has no official consolidated legal database. This server lets any MCP client — for example Claude, via Settings → Connectors → Add custom connector — research Albanian law with correct method: stable ELI-URI citations, in-force tracing through repeal links instead of unreliable flags, and OCR-aware search.

Connector URL: https://bazaligjore.azurewebsites.net/mcp (no auth, read-only)

Tools

Tool	Purpose
search_acts	Full-text or substring search over all acts (title + OCR body)
get_act	Metadata, gazette reference, PDF link, amendment relations
get_act_text	Paged slices of an act's OCR text, with find-jump
get_amendment_family	Walks the official amendment graph; renders an interactive timeline (MCP App)
browse_gazette	Issues of a year / table of contents of one issue
search_court_decisions	Constitutional Court decisions, full text
get_court_decision_text	Paged slices of a decision
get_guide	Built-in expert guides: research methodology, legal-system map, amendment mechanics, data caveats, SQL schema, external sources
query_sql	Ad-hoc read-only SQL (single SELECT/WITH, 200-row cap, 15s timeout)

Prompts: is_law_in_force, trace_amendments, research_topic.

The guides (also exposed as guide:// resources) carry the domain knowledge an assistant needs to use the corpus correctly — start with get_guide('methodology').

Running it yourself

Requires Node 22+ and a PostgreSQL database with the expected schema (see get_guide('schema') / knowledge/schema.md).

npm install
npm run build:ui        # bundles the MCP App UI into dist/ui/
PGHOST=... PGDATABASE=... PGUSER=... PGPASSWORD=... npm start
# MCP endpoint at http://localhost:3200/mcp (stateless streamable HTTP)

Environment: PGHOST PGPORT PGDATABASE PGUSER PGPASSWORD (PGSSLMODE=require for managed Postgres), PORT (default 3200). Connections are forced default_transaction_read_only = on with a 15s statement timeout — run it with a read-only database role regardless.

A Dockerfile is included; .github/workflows/deploy.yml shows a container deploy driven entirely by repository secrets.

License

MIT