npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@cyanheads/ris-austria-mcp-server

v0.6.2

Published

Search Austrian consolidated federal & state law, court decisions, and the authentic Bundesgesetzblatt from the official RIS via MCP. Keyless. STDIO or Streamable HTTP.

Readme

Version License Docker MCP SDK npm TypeScript Bun

Install in Claude Desktop Install in Cursor Install in VS Code

Framework

Public Hosted Server: https://ris-austria.caseyjhand.com/mcp


Overview

Austrian law from RIS, the government's official legal information system: federal, state, and municipal law, court decisions, official gazettes back to 1848, draft legislation, and ministerial decrees. Every document is labeled with its binding status. No API key required.

Tools

| Tool | Description | |:---|:---| | ris_search_legislation | Search consolidated federal, state, and municipal law as in force on a date (default today), plus English translations of selected laws | | ris_search_case_law | Search case law in one court or tribunal per call, across 17 court codes | | ris_search_gazette | Browse the federal, state, district, and municipal gazettes, with federal history auto-routed back to 1848 | | ris_search_drafts | Search ministerial review drafts (Begutachtungsentwürfe) and government bills (Regierungsvorlagen) | | ris_search_announcements | Search seven sectoral collections, from social-insurance notices to ministerial decrees and council-of-ministers minutes | | ris_lookup_citation | Resolve one Austrian legal citation ("§ 6 DSG", "BGBl. I Nr. 165/1999", a Geschäftszahl, ECLI, Rechtssatz number, or RIS ELI link) to its document | | ris_get_document | Fetch one document as markdown, HTML, or XML, or just its rendition URLs, with its binding status | | ris_track_changes | List every document added, changed, or deleted in one application within a date window | | ris_list_reference | Look up RIS vocabularies offline: applications, courts, states, ministries, gazette parts, citation formats, search syntax |

Resources

| Resource | Description | |:---|:---| | ris://document/{application}/{documentNumber} | Markdown text of one RIS document |

The resource mirrors ris_get_document, so tool-only clients lose nothing.

Capability reference

ris_search_legislation tool

  • Search by query (full text) or title (title, short title, or abbreviation such as "DSG"). scope is federal (default) or a Bundesland, municipality switches a state scope to municipal law, and language: english searches the ~138 English translations
  • in_force_as_of defaults to today in Austria and is echoed as appliedInForceAsOf; include_all_versions and the entered_force_* / left_force_* windows are mutually exclusive alternatives
  • Records carry law_id (filter on it for every section of a law), section_label, abbreviation, keywords, in-force dates, eli, celex_references, and content_urls. Consolidated records carry the cites that make up promulgation as original_gazette, latest_change_gazette, and latest_change_relation

ris_search_case_law tool

  • court is required, one code per call. Filter by query, cited norm ("DSG §1"), case_number, decided_from/decided_to, and decision_type (headnote, full_text, or all, the default). Court-specific filters include court_name (justiz), state (lvwg/uvs), and collection_number (vfgh/vwgh/uvs); one sent to the wrong court fails as court_filter_mismatch
  • norm searches an article in any spelling ("Art. 6 DSGVO", "DSGVO Art6", "Artikel 6 MRK") under all three spellings RIS indexes, and the notice names the expression sent
  • Records carry case_numbers (a headnote lists every decision it covers), decision_date, ecli, norms_cited, and guiding_principle on headnotes; justiz records add legal_areas, and justiz headnotes rechtssatz_numbers
  • court: normenliste returns indexed laws under norm_index instead of decisions

ris_search_gazette tool

  • scope is federal (default), a Bundesland, district, or municipal. Filter by number, part, type, published_from/published_to, issuer, district_authority, or municipality; state scopes also take series and state_era
  • Federal queries are served from one era (BgblAuth 2004+, BgblPdf 1945–2003, BgblAlt 1848–1940), echoed as servedApplication; a date range spanning two eras fails as cross_tier_range with the dates to split at
  • Records carry application (the code ris_get_document takes with document_number, equal to servedApplication), binding (authentic, historical_record, consolidated_informational), authentic_pdf_url where one exists, alex_url (ÖNB scan) for 1848–1940, celex_references where applicable, and promulgation on federal entries from 1848–2003

ris_search_drafts tool

  • stage is required: review_drafts (with in_review_on) or government_bills (2004+, with decided_from/decided_to); ministry accepts an abbreviation such as "BMF" or a full designation
  • Records carry review_start and review_deadline or decided, abbreviation and keywords where RIS supplies them, plus materials[] (Erläuterungen, Textgegenüberstellung, Vorblatt/WFA, annexes) classified by type. Pass a materials[].url to ris_get_document to read one

ris_search_announcements tool

  • collection is required: social_insurance, veterinary, court_rules, trade_exam_rules, health_structure_plans, ministerial_decrees, or council_minutes. A filter its collection doesn't accept fails as collection_filter_mismatch, including changed_since on social_insurance and veterinary. issuer expands ministry ("BMF") and social-insurance carrier ("ÖGK") abbreviations
  • Records carry binding (authentic, administrative_directive, or preparatory), authentic_pdf_url, and document_url, the only browsable view of council minutes and decrees
  • Each collection adds its own metadata where RIS supplies it, such as case_numbers, in_force_from/in_force_until, keywords, court_name, plan_state, and session_number

ris_lookup_citation tool

  • One citation per call, classified as a norm ("§ 6 DSG"), gazette number ("BGBl. I Nr. 165/1999"), case number ("VfGH G 13/2025"), ECLI, Justiz Rechtssatz number ("RS0022961"), collection number ("VfSlg 19.632/2012"), or RIS ELI link. kind forces a route, court and state narrow it, and in_force_as_of pins a norm's version (default today)
  • Returns found, kind, and a record in the matching search tool's shape, with alternatives_count when several documents matched. A miss returns found: false with guidance instead of an error
  • A norm resolves to the cited law:
    • the law is matched as RIS files it ("§ 2 EStG" → EStG 1988 § 2; "AlVG 1977" → the AlVG, filed without its year; "VwGVG 2014 §28" → VwGVG § 28), and a long title is read by its short form ("StaatsanwaltschaftsG - StAG §35" → StAG § 35)
    • sub-provisions and a trailing ";" are set aside ("Art. 6 (1) B-VG" → B-VG Art 6), and an ordinal-led abbreviation reads like any other ("1. COVID-19-JuBG §1")
    • a cited version is set aside ("ABGB idF BGBl I 2010/28 §988" → ABGB § 988 as in force on the requested date, never the amending act's gazette entry), with a note saying the cited version was not applied
    • an entry citing several provisions ("DSG §1, §24", "ZPO §179. ZPO §275 Abs2") resolves the first and names the rest
  • An EU act RIS does not consolidate ("DSGVO Art32", "RL 2006/123/EG", "VO (EG) 178/2002 Art3") returns found: false with its EUR-Lex link, without a RIS request
  • A gazette number without its part ("BGBl. Nr. 50/2025") comes back ambiguous, naming parts I, II, and III
  • A string of several gazette cites, as a consolidated record's promulgation joins them ("BGBl. Nr. 267/1967 zuletzt geändert durch BGBl. I Nr. 17/2026"), resolves by its first cite and names the others; a first cite in a gazette the lookup does not read returns found: false without a search. A state organ carrying its Bundesland ("LGBlNÖ Nr. 72/2016") needs no state hint, and a disagreeing hint is reported as not applied
  • An RIS ELI link (a consolidated-law or authentic-gazette record's eli or document_url, over https or http, with or without the scheme) resolves to the provision or entry it names, whatever version is in force; in_force_as_of and state don't apply. A path that spells a gazette cite (/eli/bgbl/{I|II|III}/{year}/{number}, /eli/lgbl/{state}/{year}/{number}, or /eli/{bgbl|rgbl|stgbl|gbloe}/{year}/{number} with no part, as before 1997) followed by nothing but date, language, or format segments resolves as that cite (/eli/bgbl/II/2026/317, /eli/bgbl/1974/60). Other /eli/ layouts, including a provision's path cut before its document number (/eli/bgbl/i/1999/165/A2P4), return found: false, kind: unknown, without a request
  • A Rechtssatz number ("RS0022961", "RIS-Justiz RS0022961 [T3]", "RW0001127") resolves to that headnote through Justiz whatever the court hint; a bracketed T number is not searched
  • A VwSlg cite VwGH stores in another shape ("VwSlg 0017 F/1947", "VwSlg. 1485 A/1950", "VwSlg 1809/50") resolves through one more search within the cited year

ris_get_document tool

  • Address by document_number + application, or by a document_url: a record's own document_url or eli (an ELI or Dokument.wxe web view, read for the document it names), a content_urls entry, or a draft's materials[].url; format is markdown (default), html, xml, or urls_only
  • Every result carries binding_status and authentic_pdf_url where one exists. Where a PDF is the only rendition (district and municipal promulgations, court rules, party-transparency decisions, council minutes, and draft companions filed without HTML), markdown returns the text extracted from it: plain text with a --- Page N of M --- line before each page, text_source: pdf, and a notice naming the PDF. A scanned PDF with no text layer, one over 16 MiB, or one that cannot be fetched in time returns a notice with the usable URL instead of failing, as do html and xml there and the 1848–1940 gazettes, which have no PDF to read
  • Markdown writes image references as absolute URLs on the content host. A rendition that is nothing but page images reads its PDF's text, and keeps the image URLs with a notice when the PDF has none
  • Markdown over 40,000 bytes returns kind: outline; re-call with sections to fetch entries. html and xml over 40,000 bytes return kind: link with byte_size and content_urls, so read with markdown

ris_track_changes tool

  • application (any of the 39 codes) plus changed_from/changed_to; include_deleted adds removals, which no other tool reports
  • Records carry changed, published, and binding_status; deletions set deleted: true with deleted_at
  • Law rows carry section_label, law_id, and in_force_from/in_force_until (no end date is not the same as in force now), and decision rows carry case_numbers and decision_date

ris_list_reference tool

  • topic selects one of 17 static tables: applications, courts, states, decision types and kinds, issuing bodies, ministries, collections, stages, changed-since intervals, section types, gazette parts, law types, district authorities, justiz subject areas, search syntax, and citation formats
  • Returns summary and entries (value, label, details) with no upstream call

ris://document/{application}/{documentNumber} resource

  • text/markdown of one document, addressed by application + documentNumber from a search or lookup result; same content as ris_get_document with format: markdown
  • Applications that publish only a PDF return its extracted text in a fenced block with a note naming the PDF; the 1848–1940 gazettes and a PDF with no extractable text return a note pointing at the PDF or scan. Oversized text returns the outline, so use the tool to fetch an entry

Features

Built on @cyanheads/mcp-ts-core: stdio and Streamable HTTP transports, pluggable auth (none / jwt / oauth), swappable storage (in-memory, filesystem, Supabase, Cloudflare KV/R2/D1), structured logging with optional OpenTelemetry tracing.

RIS-specific:

  • All 39 OGD applications: consolidated law, federal, state, district, and municipal gazettes, 17 court and tribunal collections, the lawmaking pipeline, and sectoral announcements
  • Citations resolve through exact filters (section plus title, gazette number, Geschäftszahl, Sammlungsnummer) rather than keyword search
  • Dates are YYYY-MM-DD; search tools page with page and page_size (1–100, served as pages of 10 or 20; default 20); omit a text filter rather than sending it blank
  • Court, application, state, and ministry codes come from ris_list_reference
  • Tool descriptions are English; titles, field values, and RIS error messages stay German

Agent-friendly output:

  • Every record carries a typed binding status (authentic, consolidated_informational, historical_record, decision, preparatory, administrative_directive, translation)
  • Paged results report totalCount and truncated and echo what the server applied, such as appliedInForceAsOf and servedApplication
  • Typed error reasons (court_filter_mismatch, cross_tier_range, invalid_query, document_not_found, …) and zero-hit notices name the next call

Getting started

Connect to the hosted instance, no install:

claude mcp add --transport http ris-austria-mcp-server https://ris-austria.caseyjhand.com/mcp

Or run it locally:

claude mcp add ris-austria-mcp-server -- npx -y @cyanheads/ris-austria-mcp-server

For other clients, add this to the MCP config file:

{
  "mcpServers": {
    "ris-austria-mcp-server": {
      "command": "npx",
      "args": ["-y", "@cyanheads/ris-austria-mcp-server"]
    }
  }
}

No API key is needed. For Docker or a source build, see Running the server.

Configuration

| Variable | Description | Default | |:---|:---|:---| | RIS_API_BASE_URL | RIS OGD REST API base URL. | https://data.bka.gv.at/ris/api/v2.6 | | RIS_CONTENT_BASE_URL | Document content host that rendition URLs are built on and documents are fetched from. https://www.ris.bka.gv.at answers automated clients with a bot-check page. | https://ogd.ris.bka.gv.at | | RIS_CONTACT | Contact string appended to the User-Agent. | none | | RIS_FOLD_INPUT_SPELLINGS | Accept a court or application code in any letter case, and a state by its German or English name, folding it to the code before validation. false restores strict validation for every such field. | true | | MCP_TRANSPORT_TYPE | Transport: stdio or http. | stdio | | MCP_HTTP_PORT | HTTP server port. | 3010 | | MCP_SESSION_MODE | HTTP session mode: stateless, stateful, or auto. | stateless | | MCP_AUTH_MODE | Authentication: none, jwt, or oauth. | none | | MCP_LOG_LEVEL | Log level (debug, info, warning, error, etc.). | info | | OTEL_ENABLED | Enable OpenTelemetry. | false |

See .env.example for the full list of optional overrides.

Running the server

Local development

Requires Bun v1.4.4 or higher (or Node.js v24+).

  • Clone and install:

    git clone https://github.com/cyanheads/ris-austria-mcp-server.git
    cd ris-austria-mcp-server && bun install
  • Build and run:

    # One-time build
    bun run rebuild
    
    # Run the built server
    bun run start:stdio
    # or
    bun run start:http
  • Run checks and tests:

    bun run devcheck   # Lint, format, typecheck, security
    bun run test       # Vitest test suite
    bun run lint:mcp   # Validate MCP definitions against spec

Docker

docker run --rm -p 3010:3010 ghcr.io/cyanheads/ris-austria-mcp-server:latest

The image defaults to HTTP transport, stateless session mode, and logs to /var/log/ris-austria-mcp-server. To run it over stdio from an MCP client, use "command": "docker" with "args": ["run", "-i", "--rm", "-e", "MCP_TRANSPORT_TYPE=stdio", "ghcr.io/cyanheads/ris-austria-mcp-server:latest"]. To build locally, docker build -t ris-austria-mcp-server .; OpenTelemetry peer dependencies are installed by default — build with --build-arg OTEL_ENABLED=false to omit them.

Project structure

| Directory | Purpose | |:---|:---| | src/index.ts | createApp() entry point — registers tools and resources. | | src/config | Optional RIS endpoint, contact, and input-fold configuration, parsed with Zod. | | src/mcp-server/tools | Tool definitions (*.tool.ts). | | src/mcp-server/resources | Resource definitions (*.resource.ts). | | src/services/ris | RIS request building, HTTP access, normalization, and static reference data. | | docs/design.md | Design notes: tool surface, service spec, live-confirmed RIS API reference. | | tests/ | Unit and integration tests mirroring src/. | | framework-skills/ | Development skills synced from @cyanheads/mcp-ts-core. |

Development guide

See CLAUDE.md / AGENTS.md for development guidelines and architectural rules. The short version:

  • Handlers throw, framework catches — no try/catch in tool logic
  • Use ctx.log for request-scoped logging, ctx.state for tenant-scoped storage
  • Register new tools and resources via createApp() in src/index.ts
  • Wrap the RIS API: validate raw → normalize to domain type → return output schema; never fabricate missing fields

Contributing

Issues are welcome. Run checks and tests before submitting:

bun run devcheck
bun run test

License

Apache-2.0 — see LICENSE for details.

RIS OGD data is CC BY 4.0 (attribution: RIS, Bundeskanzleramt Österreich). The underlying legal texts are copyright-free official works. Only the authentic, amtssignierte gazette wording is legally binding — consolidated RIS text is informational.