Ris Austria MCP Server

Official9 toolsLive

by cyanheads · TypeScript

Search Austrian federal and state law, court decisions, and the authentic Bundesgesetzblatt (RIS).

Topics

ai-agentaustriaaustrian-lawbunbundesgesetzblattcase-lawgazettelegal-researchlegislationmcpmcp-servermodel-context-protocolrisstdiostreamable-httptypescript

Captured live from the server via tools/list.

ris_search_legislation

Search Austrian consolidated law and English translations: federal law (scope: federal, the default), one Bundesland (scope: burgenland … wien), municipal law (municipality plus a state scope — selected norms in 6 Bundesländer), or English translations of selected federal laws (language: english, federal only, ~138 documents). One document is one § / Artikel / Anlage; fetch a whole law by filtering law_id. Searches apply the version in force today in Austria by default — set in_force_as_of for another date, include_all_versions: true for full version history, or an entered_force / left_force window for new-law and repeal tracking; the three version filters are mutually exclusive, and the applied date is echoed back in the result. query is full text (boolean UND/ODER/NICHT or AND/OR/NOT, trailing-only * wildcard); title matches title, short title, and abbreviation ("DSG"). For a specific citation like "§ 6 DSG", ris_lookup_citation resolves it deterministically instead. Consolidated text is informational, not legally binding — the authentic gazette artifact lives in ris_search_gazette.

Parameters21

query	string	optional	Full-text search (Suchworte). Boolean operators UND/ODER/NICHT or AND/OR/NOT, parentheses, quoted phrases; wildcard * is trailing-only ("Datenschutz", never "schutz"). Syntax: ris_list_reference topic search_syntax.
title	string	optional	Title search (Titel) — matches title, short title, and official abbreviation ("ABGB", "DSG"). Phrase field: * allowed leading or trailing with ≥2 characters beside it.
scope	string	optional	Jurisdiction: federal (default) searches consolidated federal law; a Bundesland searches that state’s consolidated law (or, with municipality set, its municipal law).
municipality	string	optional	Municipality name for municipal law (e.g. "Graz" — RIS’s spelling, not "Stadt Graz"). Requires a state scope; combines only with query, title, and in_force_as_of. Coverage is selected norms in 6 Bundesländer (no Burgenland/Tirol/Vorarlberg).
language	string	optional	german (default) searches the authoritative German corpus; english searches the ~138 unofficial English translations of selected federal laws (requires scope: federal; combines only with query and title).
in_force_as_of	string	optional	Return only the version in force on this date (YYYY-MM-DD). DEFAULTS TO TODAY in Austria — omitting it never searches all historical versions; opt into that with include_all_versions.
include_all_versions	boolean	optional	true searches every historical version (no in-force date filter) — version-history research. Overrides in_force_as_of; mutually exclusive with the force-window filters.
entered_force_from	string	optional	Provisions that entered force on/after this date (YYYY-MM-DD) — new-law tracking. Federal/state consolidated law only; mutually exclusive with in_force_as_of and include_all_versions.
entered_force_to	string	optional	Provisions that entered force on/before this date (YYYY-MM-DD).
left_force_from	string	optional	Provisions that left force on/after this date (YYYY-MM-DD) — repeal tracking. Same exclusivity as entered_force_from.
left_force_to	string	optional	Provisions that left force on/before this date (YYYY-MM-DD).
section_from	string	optional	Start of a § / Artikel / Anlage number range, digits with optional letter ("6", "1a"). Federal/state consolidated law only.
section_to	string	optional	End of the section range. Equal to section_from for a single section.
section_type	string	optional	Which section kind the range addresses. Defaults to Paragraph when a section range is set. Values: ris_list_reference topic section_types.
law_id	string	optional	Law-level grouping key (Gesetzesnummer, e.g. 10001597 = DSG) — exact match; returns every section of that law. Federal/state consolidated law only.
index	string	optional	Systematik classification filter (e.g. "10/10 Datenschutz"). Federal/state consolidated law only.
changed_since	string	optional	Coarse recency filter — documents changed in RIS within the interval. For exact windows and deletions use ris_track_changes.
sort_by	string	optional	Sort column: section (§/Artikel/Anlage label) or in_force_date. Default: upstream order. Federal/state consolidated law only.
sort_direction	string	optional	Sort direction; applies with sort_by.
page	integer	optional	1-based result page. Default 1.
page_size	any	optional	Documents per page — RIS accepts 10, 20, 50, or 100. Default 20.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Full-text search (Suchworte). Boolean operators UND/ODER/NICHT or AND/OR/NOT, parentheses, quoted phrases; wildcard * is trailing-only (\"Datenschutz*\", never \"*schutz\"). Syntax: ris_list_reference topic search_syntax.",
      "type": "string"
    },
    "title": {
      "description": "Title search (Titel) — matches title, short title, and official abbreviation (\"ABGB\", \"DSG\"). Phrase field: * allowed leading or trailing with ≥2 characters beside it.",
      "type": "string"
    },
    "scope": {
      "default": "federal",
      "description": "Jurisdiction: federal (default) searches consolidated federal law; a Bundesland searches that state’s consolidated law (or, with municipality set, its municipal law).",
      "type": "string",
      "enum": [
        "federal",
        "burgenland",
        "kaernten",
        "niederoesterreich",
        "oberoesterreich",
        "salzburg",
        "steiermark",
        "tirol",
        "vorarlberg",
        "wien"
      ]
    },
    "municipality": {
      "description": "Municipality name for municipal law (e.g. \"Graz\" — RIS’s spelling, not \"Stadt Graz\"). Requires a state scope; combines only with query, title, and in_force_as_of. Coverage is selected norms in 6 Bundesländer (no Burgenland/Tirol/Vorarlberg).",
      "type": "string"
    },
    "language": {
      "default": "german",
      "description": "german (default) searches the authoritative German corpus; english searches the ~138 unofficial English translations of selected federal laws (requires scope: federal; combines only with query and title).",
      "type": "string",
      "enum": [
        "german",
        "english"
      ]
    },
    "in_force_as_of": {
      "description": "Return only the version in force on this date (YYYY-MM-DD). DEFAULTS TO TODAY in Austria — omitting it never searches all historical versions; opt into that with include_all_versions.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "include_all_versions": {
      "description": "true searches every historical version (no in-force date filter) — version-history research. Overrides in_force_as_of; mutually exclusive with the force-window filters.",
      "type": "boolean"
    },
    "entered_force_from": {
      "description": "Provisions that entered force on/after this date (YYYY-MM-DD) — new-law tracking. Federal/state consolidated law only; mutually exclusive with in_force_as_of and include_all_versions.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "entered_force_to": {
      "description": "Provisions that entered force on/before this date (YYYY-MM-DD).",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "left_force_from": {
      "description": "Provisions that left force on/after this date (YYYY-MM-DD) — repeal tracking. Same exclusivity as entered_force_from.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "left_force_to": {
      "description": "Provisions that left force on/before this date (YYYY-MM-DD).",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "section_from": {
      "description": "Start of a § / Artikel / Anlage number range, digits with optional letter (\"6\", \"1a\"). Federal/state consolidated law only.",
      "type": "string"
    },
    "section_to": {
      "description": "End of the section range. Equal to section_from for a single section.",
      "type": "string"
    },
    "section_type": {
      "description": "Which section kind the range addresses. Defaults to Paragraph when a section range is set. Values: ris_list_reference topic section_types.",
      "type": "string",
      "enum": [
        "Alle",
        "Artikel",
        "Paragraph",
        "Anlage"
      ]
    },
    "law_id": {
      "description": "Law-level grouping key (Gesetzesnummer, e.g. 10001597 = DSG) — exact match; returns every section of that law. Federal/state consolidated law only.",
      "type": "string"
    },
    "index": {
      "description": "Systematik classification filter (e.g. \"10/10 Datenschutz\"). Federal/state consolidated law only.",
      "type": "string"
    },
    "changed_since": {
      "description": "Coarse recency filter — documents changed in RIS within the interval. For exact windows and deletions use ris_track_changes.",
      "type": "string",
      "enum": [
        "one_week",
        "two_weeks",
        "one_month",
        "three_months",
        "six_months",
        "one_year"
      ]
    },
    "sort_by": {
      "description": "Sort column: section (§/Artikel/Anlage label) or in_force_date. Default: upstream order. Federal/state consolidated law only.",
      "type": "string",
      "enum": [
        "section",
        "in_force_date"
      ]
    },
    "sort_direction": {
      "description": "Sort direction; applies with sort_by.",
      "type": "string",
      "enum": [
        "ascending",
        "descending"
      ]
    },
    "page": {
      "description": "1-based result page. Default 1.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "page_size": {
      "description": "Documents per page — RIS accepts 10, 20, 50, or 100. Default 20.",
      "anyOf": [
        {
          "type": "number",
          "const": 10
        },
        {
          "type": "number",
          "const": 20
        },
        {
          "type": "number",
          "const": 50
        },
        {
          "type": "number",
          "const": 100
        }
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

ris_search_case_law

Search Austrian case law (Judikatur) in ONE court or tribunal per call — court is required: vfgh (Constitutional Court), vwgh (Supreme Administrative Court), justiz (ordinary courts incl. OGH, selected decisions), bvwg (federal administrative), lvwg (state administrative), dsk (data protection authority), normenliste (VwGH norm index), dok, pvak, gbk, verg, upts (party transparency), and the historical uvs, asylgh, ubas, umse, bks. Cross-court research is one call per court (calls are cheap); historical bodies are closed windows with successors — codes, windows, and Geschäftszahl examples: ris_list_reference topic courts. Filter by full-text query, cited norm ("DSG §1", "DSGVO Art32" — the highest-value filter), exact case_number (Geschäftszahl), decision date range, decision_type (headnote vs full text), decision_kind, or the court-conditional filters: issuing_body (dsk/dok/pvak/verg), court_name/legal_area/subject_area (justiz), state (lvwg/uvs), party (upts), commission/senate/discrimination_ground (gbk), subject_law (bks), collection_number (vfgh/vwgh/uvs). For a known Geschäftszahl or VfSlg/VwSlg cite, ris_lookup_citation resolves it directly.

Parameters24

court	string	required	Which court/tribunal application to search — one per call. Codes, coverage windows, and successor mapping: ris_list_reference topic courts.
query	string	optional	Full-text search over decisions (Suchworte). Boolean UND/ODER/NICHT or AND/OR/NOT, quoted phrases, trailing-only * wildcard.
norm	string	optional	Cited-provision filter (Norm) — "DSG §1", "DSGVO Art32", "GewO 1994 §129", matching the format returned in norms_cited. The highest-value case-law filter.
case_number	string	optional	Exact Geschäftszahl — returns that decision’s documents. Formats differ per court (examples: ris_list_reference topic courts). Not available for normenliste.
decision_type	string	optional	Search headnotes (Rechtssätze), full decision texts (Entscheidungstexte), or both (all, the default). Not available for gbk, upts, or normenliste.
decided_from	string	optional	Earliest decision date (YYYY-MM-DD). Not available for normenliste.
decided_to	string	optional	Latest decision date (YYYY-MM-DD).
decision_kind	string	optional	Decision kind (Entscheidungsart) — per-court value sets, validated locally: ris_list_reference topic decision_kinds. No such parameter exists for normenliste, dok, pvak, umse, bks, or upts. For justiz the four documented values are not yet populated in the corpus (every value returns 0 hits, verified 2026-07-05) — filter justiz with query or norm instead.
collection_number	string	optional	Official collection number (Sammlungsnummer) — VfSlg/VwSlg cites. vfgh, vwgh, and uvs only.
issuing_body	string	optional	Deciding body (EntscheidendeBehoerde) — dsk, dok, pvak, and verg only. dsk: Datenschutzbehoerde (2014+) or Datenschutzkommission (up to 2013). Full value lists: ris_list_reference topic issuing_bodies.
court_name	string	optional	Filter within the ordinary courts (justiz only) — "OGH", "OLG Wien", "LG Linz".
legal_area	string	optional	Legal area (Rechtsgebiet, justiz only): civil (Zivilrecht) or criminal (Strafrecht).
subject_area	string	optional	Subject-area taxonomy filter (Fachgebiet, justiz only) — 39 exact German values like "Datenschutzrecht", validated locally: ris_list_reference topic justiz_subject_areas. The corpus carries no tagged documents yet (every value returns 0 hits, verified 2026-07-05) — filter with query or norm instead until RIS populates the tags.
state	string	optional	Which of the nine state administrative courts/senates to search (lvwg and uvs only).
party	string	optional	Political party the decision concerns (upts only). Documented values: ÖVP, SPÖ, FPÖ, KPÖ, BZÖ, Team Stronach — the filter is full-text, and further party names appear in live data (e.g. "Wandel").
commission	string	optional	Equal-treatment commission (gbk only): federal (Bundes-Gleichbehandlungskommission) or general (Gleichbehandlungskommission).
senate	string	optional	Commission senate (gbk only).
discrimination_ground	string	optional	Discrimination ground (gbk only): Alter (age), EthnischeZugehoerigkeit (ethnic origin), Geschlecht (gender/sex), Mehrfachdiskriminierung (multiple grounds), Religion (religion), SexuelleOrientierung (sexual orientation), Weltanschauung (worldview/belief). Upstream German enum values, sent verbatim.
subject_law	string	optional	Media statute the case concerns (Bereich, bks only) — e.g. "ORF-Gesetz", "Privatradiogesetz".
changed_since	string	optional	Coarse recency filter — decisions changed in RIS within the interval. For exact windows use ris_track_changes.
sort_by	string	optional	Sort column. Default: upstream order.
sort_direction	string	optional	Sort direction; applies with sort_by.
page	integer	optional	1-based result page. Default 1.
page_size	any	optional	Documents per page — RIS accepts 10, 20, 50, or 100. Default 20.

Raw schema

{
  "type": "object",
  "properties": {
    "court": {
      "type": "string",
      "enum": [
        "vfgh",
        "vwgh",
        "justiz",
        "bvwg",
        "lvwg",
        "dsk",
        "normenliste",
        "dok",
        "pvak",
        "gbk",
        "uvs",
        "asylgh",
        "ubas",
        "umse",
        "bks",
        "verg",
        "upts"
      ],
      "description": "Which court/tribunal application to search — one per call. Codes, coverage windows, and successor mapping: ris_list_reference topic courts."
    },
    "query": {
      "description": "Full-text search over decisions (Suchworte). Boolean UND/ODER/NICHT or AND/OR/NOT, quoted phrases, trailing-only * wildcard.",
      "type": "string"
    },
    "norm": {
      "description": "Cited-provision filter (Norm) — \"DSG §1\", \"DSGVO Art32\", \"GewO 1994 §129\", matching the format returned in norms_cited. The highest-value case-law filter.",
      "type": "string"
    },
    "case_number": {
      "description": "Exact Geschäftszahl — returns that decision’s documents. Formats differ per court (examples: ris_list_reference topic courts). Not available for normenliste.",
      "type": "string"
    },
    "decision_type": {
      "default": "all",
      "description": "Search headnotes (Rechtssätze), full decision texts (Entscheidungstexte), or both (all, the default). Not available for gbk, upts, or normenliste.",
      "type": "string",
      "enum": [
        "headnote",
        "full_text",
        "all"
      ]
    },
    "decided_from": {
      "description": "Earliest decision date (YYYY-MM-DD). Not available for normenliste.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "decided_to": {
      "description": "Latest decision date (YYYY-MM-DD).",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "decision_kind": {
      "description": "Decision kind (Entscheidungsart) — per-court value sets, validated locally: ris_list_reference topic decision_kinds. No such parameter exists for normenliste, dok, pvak, umse, bks, or upts. For justiz the four documented values are not yet populated in the corpus (every value returns 0 hits, verified 2026-07-05) — filter justiz with query or norm instead.",
      "type": "string"
    },
    "collection_number": {
      "description": "Official collection number (Sammlungsnummer) — VfSlg/VwSlg cites. vfgh, vwgh, and uvs only.",
      "type": "string"
    },
    "issuing_body": {
      "description": "Deciding body (EntscheidendeBehoerde) — dsk, dok, pvak, and verg only. dsk: Datenschutzbehoerde (2014+) or Datenschutzkommission (up to 2013). Full value lists: ris_list_reference topic issuing_bodies.",
      "type": "string"
    },
    "court_name": {
      "description": "Filter within the ordinary courts (justiz only) — \"OGH\", \"OLG Wien\", \"LG Linz\".",
      "type": "string"
    },
    "legal_area": {
      "description": "Legal area (Rechtsgebiet, justiz only): civil (Zivilrecht) or criminal (Strafrecht).",
      "type": "string",
      "enum": [
        "civil",
        "criminal"
      ]
    },
    "subject_area": {
      "description": "Subject-area taxonomy filter (Fachgebiet, justiz only) — 39 exact German values like \"Datenschutzrecht\", validated locally: ris_list_reference topic justiz_subject_areas. The corpus carries no tagged documents yet (every value returns 0 hits, verified 2026-07-05) — filter with query or norm instead until RIS populates the tags.",
      "type": "string"
    },
    "state": {
      "description": "Which of the nine state administrative courts/senates to search (lvwg and uvs only).",
      "type": "string",
      "enum": [
        "burgenland",
        "kaernten",
        "niederoesterreich",
        "oberoesterreich",
        "salzburg",
        "steiermark",
        "tirol",
        "vorarlberg",
        "wien"
      ]
    },
    "party": {
      "description": "Political party the decision concerns (upts only). Documented values: ÖVP, SPÖ, FPÖ, KPÖ, BZÖ, Team Stronach — the filter is full-text, and further party names appear in live data (e.g. \"Wandel\").",
      "type": "string"
    },
    "commission": {
      "description": "Equal-treatment commission (gbk only): federal (Bundes-Gleichbehandlungskommission) or general (Gleichbehandlungskommission).",
      "type": "string",
      "enum": [
        "federal",
        "general"
      ]
    },
    "senate": {
      "description": "Commission senate (gbk only).",
      "type": "string",
      "enum": [
        "I",
        "II",
        "III"
      ]
    },
    "discrimination_ground": {
      "description": "Discrimination ground (gbk only): Alter (age), EthnischeZugehoerigkeit (ethnic origin), Geschlecht (gender/sex), Mehrfachdiskriminierung (multiple grounds), Religion (religion), SexuelleOrientierung (sexual orientation), Weltanschauung (worldview/belief). Upstream German enum values, sent verbatim.",
      "type": "string",
      "enum": [
        "Alter",
        "EthnischeZugehoerigkeit",
        "Geschlecht",
        "Mehrfachdiskriminierung",
        "Religion",
        "SexuelleOrientierung",
        "Weltanschauung"
      ]
    },
    "subject_law": {
      "description": "Media statute the case concerns (Bereich, bks only) — e.g. \"ORF-Gesetz\", \"Privatradiogesetz\".",
      "type": "string"
    },
    "changed_since": {
      "description": "Coarse recency filter — decisions changed in RIS within the interval. For exact windows use ris_track_changes.",
      "type": "string",
      "enum": [
        "one_week",
        "two_weeks",
        "one_month",
        "three_months",
        "six_months",
        "one_year"
      ]
    },
    "sort_by": {
      "description": "Sort column. Default: upstream order.",
      "type": "string",
      "enum": [
        "decision_date",
        "case_number"
      ]
    },
    "sort_direction": {
      "description": "Sort direction; applies with sort_by.",
      "type": "string",
      "enum": [
        "ascending",
        "descending"
      ]
    },
    "page": {
      "description": "1-based result page. Default 1.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "page_size": {
      "description": "Documents per page — RIS accepts 10, 20, 50, or 100. Default 20.",
      "anyOf": [
        {
          "type": "number",
          "const": 10
        },
        {
          "type": "number",
          "const": 20
        },
        {
          "type": "number",
          "const": 50
        },
        {
          "type": "number",
          "const": 100
        }
      ]
    }
  },
  "required": [
    "court"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

ris_search_gazette

Browse Austria’s promulgation record — the authentic, legally binding gazettes — at every level of government. scope picks the jurisdiction: federal (default; the Bundesgesetzblatt across three era tiers auto-routed by year — BgblAuth 2004+ authentic, BgblPdf 1945–2003, BgblAlt 1848–1940 metadata-only ÖNB scans), one Bundesland (its Landesgesetzblatt), district (Bezirke promulgations), or municipal (Gemeinde promulgations). For a state scope, series selects law gazettes (law_gazette, the default → LGBl) vs ordinance gazettes (ordinance_gazette → Verordnungsblätter, currently Tirol only), and include_non_authentic adds the historical non-authentic state gazette (Niederösterreich’s systematic LgblNO, or the older Lgbl elsewhere). Filter by query (full text), title, number ("171/2026" — a pre-2004 number auto-routes to the right era tier), part (federal I/II/III or pre_1997), type (laws/regulations/announcements/other), published_from/to, issuer (federal or ordinance gazettes only), district_authority (district only), or municipality (municipal only). Every result carries a binding label (authentic vs historical_record vs consolidated_informational) and the amtssigniert authentic PDF wherever it exists — the binding artifact, never a paraphrase. For one known gazette number, ris_lookup_citation resolves it directly. Coverage windows, era tiers, and part semantics: ris_list_reference topic applications or gazette_parts.

Parameters17

scope	string	optional	Jurisdiction level: federal (default — the Bundesgesetzblatt, era tier auto-routed), a Bundesland (burgenland … wien, its Landesgesetzblatt), district (Bezirke promulgations), or municipal (Gemeinde promulgations).
series	string	optional	State scopes only. law_gazette (default when omitted) searches the authentic Landesgesetzblatt; ordinance_gazette searches the Verordnungsblätter (Vbl — currently Tirol only, 2022+).
include_non_authentic	boolean	optional	State scopes only. Adds the historical non-authentic state gazette — Niederösterreich’s systematic LgblNO, or the older Lgbl for the other Bundesländer (Wien is not carried).
query	string	optional	Full-text search (Suchworte). Boolean operators UND/ODER/NICHT or AND/OR/NOT, parentheses, quoted phrases; wildcard * is trailing-only. Syntax: ris_list_reference topic search_syntax.
title	string	optional	Title search (Titel) — phrase field: * allowed leading or trailing with ≥2 characters beside it.
number	string	optional	Gazette number, e.g. "171/2026" or "BGBl. II Nr. 171/2026" (federal), "61/2026" (state), a Kundmachungsnummer (district/municipal). A trailing year routes a federal query to the right era tier; a bare number searches the current tier.
part	string	optional	Federal only. part1 (Gesetze) \| part2 (Verordnungen) \| part3 (Staatsverträge) — parts exist from 1997; pre_1997 searches the older partless BGBl (routes to the 1945–2003 tier). Semantics: ris_list_reference topic gazette_parts.
type	string	optional	Document-type filter (Typ) for federal and state law gazettes: laws (Gesetze) \| regulations (Verordnungen) \| announcements (Kundmachungen) \| other (Sonstiges).
published_from	string	optional	Earliest promulgation date (YYYY-MM-DD). A pre-2004 range routes a federal query to an earlier era tier.
published_to	string	optional	Latest promulgation date (YYYY-MM-DD).
issuer	string	optional	Issuing body — federal (EinbringendeStelle, e.g. "BMF") or ordinance gazettes (Vbl Einbringer: Landeshauptmann/frau, Landesregierung, Amt der Landesregierung, Sonstige Landesbehörden) only. Phrase field.
district_authority	string	optional	District only. Bezirksverwaltungsbehörde name, e.g. "Bezirkshauptmannschaft Liezen" — full list: ris_list_reference topic district_authorities.
municipality	string	optional	Municipal only. Exact municipality name (Gemeinde), RIS’s spelling.
sort_by	string	optional	Sort column: published (Kundmachungsdatum) or number. Availability varies by tier; default: upstream order.
sort_direction	string	optional	Sort direction; applies with sort_by.
page	integer	optional	1-based result page. Default 1.
page_size	any	optional	Documents per page — RIS accepts 10, 20, 50, or 100. Default 20.

Raw schema

{
  "type": "object",
  "properties": {
    "scope": {
      "default": "federal",
      "description": "Jurisdiction level: federal (default — the Bundesgesetzblatt, era tier auto-routed), a Bundesland (burgenland … wien, its Landesgesetzblatt), district (Bezirke promulgations), or municipal (Gemeinde promulgations).",
      "type": "string",
      "enum": [
        "federal",
        "burgenland",
        "kaernten",
        "niederoesterreich",
        "oberoesterreich",
        "salzburg",
        "steiermark",
        "tirol",
        "vorarlberg",
        "wien",
        "district",
        "municipal"
      ]
    },
    "series": {
      "description": "State scopes only. law_gazette (default when omitted) searches the authentic Landesgesetzblatt; ordinance_gazette searches the Verordnungsblätter (Vbl — currently Tirol only, 2022+).",
      "type": "string",
      "enum": [
        "law_gazette",
        "ordinance_gazette"
      ]
    },
    "include_non_authentic": {
      "description": "State scopes only. Adds the historical non-authentic state gazette — Niederösterreich’s systematic LgblNO, or the older Lgbl for the other Bundesländer (Wien is not carried).",
      "type": "boolean"
    },
    "query": {
      "description": "Full-text search (Suchworte). Boolean operators UND/ODER/NICHT or AND/OR/NOT, parentheses, quoted phrases; wildcard * is trailing-only. Syntax: ris_list_reference topic search_syntax.",
      "type": "string"
    },
    "title": {
      "description": "Title search (Titel) — phrase field: * allowed leading or trailing with ≥2 characters beside it.",
      "type": "string"
    },
    "number": {
      "description": "Gazette number, e.g. \"171/2026\" or \"BGBl. II Nr. 171/2026\" (federal), \"61/2026\" (state), a Kundmachungsnummer (district/municipal). A trailing year routes a federal query to the right era tier; a bare number searches the current tier.",
      "type": "string"
    },
    "part": {
      "description": "Federal only. part1 (Gesetze) | part2 (Verordnungen) | part3 (Staatsverträge) — parts exist from 1997; pre_1997 searches the older partless BGBl (routes to the 1945–2003 tier). Semantics: ris_list_reference topic gazette_parts.",
      "type": "string",
      "enum": [
        "part1",
        "part2",
        "part3",
        "pre_1997"
      ]
    },
    "type": {
      "description": "Document-type filter (Typ) for federal and state law gazettes: laws (Gesetze) | regulations (Verordnungen) | announcements (Kundmachungen) | other (Sonstiges).",
      "type": "string",
      "enum": [
        "laws",
        "regulations",
        "announcements",
        "other"
      ]
    },
    "published_from": {
      "description": "Earliest promulgation date (YYYY-MM-DD). A pre-2004 range routes a federal query to an earlier era tier.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "published_to": {
      "description": "Latest promulgation date (YYYY-MM-DD).",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "issuer": {
      "description": "Issuing body — federal (EinbringendeStelle, e.g. \"BMF\") or ordinance gazettes (Vbl Einbringer: Landeshauptmann/frau, Landesregierung, Amt der Landesregierung, Sonstige Landesbehörden) only. Phrase field.",
      "type": "string"
    },
    "district_authority": {
      "description": "District only. Bezirksverwaltungsbehörde name, e.g. \"Bezirkshauptmannschaft Liezen\" — full list: ris_list_reference topic district_authorities.",
      "type": "string"
    },
    "municipality": {
      "description": "Municipal only. Exact municipality name (Gemeinde), RIS’s spelling.",
      "type": "string"
    },
    "sort_by": {
      "description": "Sort column: published (Kundmachungsdatum) or number. Availability varies by tier; default: upstream order.",
      "type": "string",
      "enum": [
        "published",
        "number"
      ]
    },
    "sort_direction": {
      "description": "Sort direction; applies with sort_by.",
      "type": "string",
      "enum": [
        "ascending",
        "descending"
      ]
    },
    "page": {
      "description": "1-based result page. Default 1.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "page_size": {
      "description": "Documents per page — RIS accepts 10, 20, 50, or 100. Default 20.",
      "anyOf": [
        {
          "type": "number",
          "const": 10
        },
        {
          "type": "number",
          "const": 20
        },
        {
          "type": "number",
          "const": 50
        },
        {
          "type": "number",
          "const": 100
        }
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

ris_search_drafts

Search Austria’s federal lawmaking pipeline BEFORE promulgation — the monitoring counterpart to ris_search_gazette (what will become law). stage selects the phase: review_drafts (Begutachtungsentwürfe — draft laws a ministry has put into public review, before any government bill exists) or government_bills (Regierungsvorlagen — bills the council of ministers adopted and submitted to parliament, 2004+). Filter by query (full text), title, ministry (accepts an abbreviation like "BMF" — expanded server-side to RIS’s exact designation; the historical name at submission time counts), in_review_on (review_drafts only — drafts whose review window covers the date; today = "what is in Begutachtung right now"), or decided_from/to (government_bills only — council adoption date). changed_since gives coarse recency. Documents are preparatory, not binding law. Ministry codes: ris_list_reference topic ministries.

Parameters12

stage	string	required	Which pipeline stage to search — one per call. review_drafts (Begut, ministerial review) or government_bills (RegV, council-adopted bills). Details: ris_list_reference topic stages.
query	string	optional	Full-text search (Suchworte). Boolean operators UND/ODER/NICHT or AND/OR/NOT, parentheses, quoted phrases; wildcard * is trailing-only.
title	string	optional	Title search (Titel) — phrase field: * allowed leading or trailing with ≥2 characters beside it.
ministry	string	optional	Submitting ministry (EinbringendeStelle). Accepts an abbreviation ("BMF") — expanded server-side to RIS’s exact-match designation; use the ministry’s name at the time of submission. Table: ris_list_reference topic ministries.
in_review_on	string	optional	review_drafts only. Drafts whose public-review window covers this date (YYYY-MM-DD). Today = drafts currently in Begutachtung.
decided_from	string	optional	government_bills only. Earliest council-of-ministers adoption date (YYYY-MM-DD).
decided_to	string	optional	government_bills only. Latest adoption date (YYYY-MM-DD).
changed_since	string	optional	Coarse recency filter — documents changed in RIS within the interval. For exact windows use ris_track_changes.
sort_by	string	optional	Sort column: date (review deadline or adoption date per stage), ministry, or title. Default: upstream order.
sort_direction	string	optional	Sort direction; applies with sort_by.
page	integer	optional	1-based result page. Default 1.
page_size	any	optional	Documents per page — RIS accepts 10, 20, 50, or 100. Default 20.

Raw schema

{
  "type": "object",
  "properties": {
    "stage": {
      "type": "string",
      "enum": [
        "review_drafts",
        "government_bills"
      ],
      "description": "Which pipeline stage to search — one per call. review_drafts (Begut, ministerial review) or government_bills (RegV, council-adopted bills). Details: ris_list_reference topic stages."
    },
    "query": {
      "description": "Full-text search (Suchworte). Boolean operators UND/ODER/NICHT or AND/OR/NOT, parentheses, quoted phrases; wildcard * is trailing-only.",
      "type": "string"
    },
    "title": {
      "description": "Title search (Titel) — phrase field: * allowed leading or trailing with ≥2 characters beside it.",
      "type": "string"
    },
    "ministry": {
      "description": "Submitting ministry (EinbringendeStelle). Accepts an abbreviation (\"BMF\") — expanded server-side to RIS’s exact-match designation; use the ministry’s name at the time of submission. Table: ris_list_reference topic ministries.",
      "type": "string"
    },
    "in_review_on": {
      "description": "review_drafts only. Drafts whose public-review window covers this date (YYYY-MM-DD). Today = drafts currently in Begutachtung.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "decided_from": {
      "description": "government_bills only. Earliest council-of-ministers adoption date (YYYY-MM-DD).",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "decided_to": {
      "description": "government_bills only. Latest adoption date (YYYY-MM-DD).",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "changed_since": {
      "description": "Coarse recency filter — documents changed in RIS within the interval. For exact windows use ris_track_changes.",
      "type": "string",
      "enum": [
        "one_week",
        "two_weeks",
        "one_month",
        "three_months",
        "six_months",
        "one_year"
      ]
    },
    "sort_by": {
      "description": "Sort column: date (review deadline or adoption date per stage), ministry, or title. Default: upstream order.",
      "type": "string",
      "enum": [
        "date",
        "ministry",
        "title"
      ]
    },
    "sort_direction": {
      "description": "Sort direction; applies with sort_by.",
      "type": "string",
      "enum": [
        "ascending",
        "descending"
      ]
    },
    "page": {
      "description": "1-based result page. Default 1.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "page_size": {
      "description": "Documents per page — RIS accepts 10, 20, 50, or 100. Default 20.",
      "anyOf": [
        {
          "type": "number",
          "const": 10
        },
        {
          "type": "number",
          "const": 20
        },
        {
          "type": "number",
          "const": 50
        },
        {
          "type": "number",
          "const": 100
        }
      ]
    }
  },
  "required": [
    "stage"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

ris_search_announcements

Search Austria’s sectoral official gazettes and executive documents — seven collections behind one collection enum: social_insurance (Amtliche Verlautbarungen der Sozialversicherung, authentic), veterinary (Amtliche Veterinärnachrichten, authentic), court_rules (Kundmachungen der Gerichte — rules of procedure and case-allocation plans, authentic; currently LVwG Tirol and Vorarlberg only), trade_exam_rules (Prüfungsordnungen gemäß Gewerbeordnung, authentic), health_structure_plans (Strukturpläne Gesundheit — federal ÖSG and per-state RSG, authentic), ministerial_decrees (Erlässe der Bundesministerien — decrees interpreting law; bind the administration, not citizens), and council_minutes (Ministerratsprotokolle — council-of-ministers session records). Each collection accepts a different filter set: query and title are broadly available; number, published_from/to, in_force_as_of, issuer (ministry abbreviations expanded server-side), norm ("decrees citing the DSG"), case_number, type, department, plan_type/plan_state (health plans), and session_number/legislature (council minutes) apply where the collection supports them — a filter outside its set is rejected locally. Every result carries a binding label and the authentic PDF where it exists. Per-collection parameter matrix and issuers: ris_list_reference topic collections or issuing_bodies.

Parameters23

collection	string	required	Which collection to search — one per call. social_insurance \| veterinary \| court_rules \| trade_exam_rules \| health_structure_plans \| ministerial_decrees \| council_minutes. Per-collection filter matrix: ris_list_reference topic collections.
query	string	optional	Full-text search (Suchworte). Boolean operators UND/ODER/NICHT or AND/OR/NOT, parentheses, quoted phrases; wildcard * is trailing-only. Valid for all collections.
title	string	optional	Title search (Titel) — phrase field. Valid for all collections except council_minutes.
number	string	optional	Serial number (Avsvnummer / Avnnummer / Spgnummer) — social_insurance, veterinary, health_structure_plans.
published_from	string	optional	Earliest publication/session date (YYYY-MM-DD). All collections except ministerial_decrees (decrees date by force — use in_force_as_of / entered_force_from/to).
published_to	string	optional	Latest publication/session date (YYYY-MM-DD).
in_force_as_of	string	optional	Version in force on this date (YYYY-MM-DD) — veterinary, court_rules, trade_exam_rules, health_structure_plans, ministerial_decrees (the consolidated-ish collections).
entered_force_from	string	optional	Provisions that entered force on/after this date (YYYY-MM-DD) — ministerial_decrees only.
entered_force_to	string	optional	Provisions that entered force on/before this date (YYYY-MM-DD) — ministerial_decrees only.
issuer	string	optional	Issuing body — social_insurance (Urheber, e.g. ÖGK/SVS/BVAEB/AUVA/PVA), ministerial_decrees (Bundesministerium — abbreviation expanded server-side), council_minutes (Einbringer ministry). Values: ris_list_reference topic issuing_bodies or ministries.
norm	string	optional	Cited-provision filter (Norm) — "DSG §1", "DSGVO Art32" style. veterinary and ministerial_decrees only ("decrees citing the DSG").
case_number	string	optional	Business reference number (Geschäftszahl) — veterinary and ministerial_decrees only.
type	string	optional	Document type (Typ) — trade_exam_rules (Befaehigungspruefungsordnung \| Meisterpruefungsordnung), court_rules (Geschaeftsordnung \| Geschaeftsverteilung), veterinary (Kundmachungen \| VeroeffentlichungenAufGrundVEVO \| SonstigeVeroeffentlichungen).
department	string	optional	Ministry department (Abteilung) — ministerial_decrees only.
plan_type	string	optional	health_structure_plans only. Plan kind — all (default), expert_opinion (Gutachten), or regulation (Verordnungen). Searches the federal ÖSG unless plan_state is set.
plan_state	string	optional	health_structure_plans only. Restrict to one Bundesland’s regional health-structure plan (RSG) — setting it switches the search from the federal ÖSG to that state’s RSG.
session_number	string	optional	Council session number (Sitzungsnummer) — council_minutes only.
legislature	string	optional	Legislative period (Gesetzgebungsperiode, e.g. "XXVII") — council_minutes only.
changed_since	string	optional	Coarse recency filter — documents changed in RIS within the interval. For exact windows use ris_track_changes.
sort_by	string	optional	Sort column: published or number, where the collection has the column. Default: upstream order.
sort_direction	string	optional	Sort direction; applies with sort_by.
page	integer	optional	1-based result page. Default 1.
page_size	any	optional	Documents per page — RIS accepts 10, 20, 50, or 100. Default 20.

Raw schema

{
  "type": "object",
  "properties": {
    "collection": {
      "type": "string",
      "enum": [
        "social_insurance",
        "veterinary",
        "court_rules",
        "trade_exam_rules",
        "health_structure_plans",
        "ministerial_decrees",
        "council_minutes"
      ],
      "description": "Which collection to search — one per call. social_insurance | veterinary | court_rules | trade_exam_rules | health_structure_plans | ministerial_decrees | council_minutes. Per-collection filter matrix: ris_list_reference topic collections."
    },
    "query": {
      "description": "Full-text search (Suchworte). Boolean operators UND/ODER/NICHT or AND/OR/NOT, parentheses, quoted phrases; wildcard * is trailing-only. Valid for all collections.",
      "type": "string"
    },
    "title": {
      "description": "Title search (Titel) — phrase field. Valid for all collections except council_minutes.",
      "type": "string"
    },
    "number": {
      "description": "Serial number (Avsvnummer / Avnnummer / Spgnummer) — social_insurance, veterinary, health_structure_plans.",
      "type": "string"
    },
    "published_from": {
      "description": "Earliest publication/session date (YYYY-MM-DD). All collections except ministerial_decrees (decrees date by force — use in_force_as_of / entered_force_from/to).",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "published_to": {
      "description": "Latest publication/session date (YYYY-MM-DD).",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "in_force_as_of": {
      "description": "Version in force on this date (YYYY-MM-DD) — veterinary, court_rules, trade_exam_rules, health_structure_plans, ministerial_decrees (the consolidated-ish collections).",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "entered_force_from": {
      "description": "Provisions that entered force on/after this date (YYYY-MM-DD) — ministerial_decrees only.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "entered_force_to": {
      "description": "Provisions that entered force on/before this date (YYYY-MM-DD) — ministerial_decrees only.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "issuer": {
      "description": "Issuing body — social_insurance (Urheber, e.g. ÖGK/SVS/BVAEB/AUVA/PVA), ministerial_decrees (Bundesministerium — abbreviation expanded server-side), council_minutes (Einbringer ministry). Values: ris_list_reference topic issuing_bodies or ministries.",
      "type": "string"
    },
    "norm": {
      "description": "Cited-provision filter (Norm) — \"DSG §1\", \"DSGVO Art32\" style. veterinary and ministerial_decrees only (\"decrees citing the DSG\").",
      "type": "string"
    },
    "case_number": {
      "description": "Business reference number (Geschäftszahl) — veterinary and ministerial_decrees only.",
      "type": "string"
    },
    "type": {
      "description": "Document type (Typ) — trade_exam_rules (Befaehigungspruefungsordnung | Meisterpruefungsordnung), court_rules (Geschaeftsordnung | Geschaeftsverteilung), veterinary (Kundmachungen | VeroeffentlichungenAufGrundVEVO | SonstigeVeroeffentlichungen).",
      "type": "string"
    },
    "department": {
      "description": "Ministry department (Abteilung) — ministerial_decrees only.",
      "type": "string"
    },
    "plan_type": {
      "description": "health_structure_plans only. Plan kind — all (default), expert_opinion (Gutachten), or regulation (Verordnungen). Searches the federal ÖSG unless plan_state is set.",
      "type": "string",
      "enum": [
        "all",
        "expert_opinion",
        "regulation"
      ]
    },
    "plan_state": {
      "description": "health_structure_plans only. Restrict to one Bundesland’s regional health-structure plan (RSG) — setting it switches the search from the federal ÖSG to that state’s RSG.",
      "type": "string",
      "enum": [
        "burgenland",
        "kaernten",
        "niederoesterreich",
        "oberoesterreich",
        "salzburg",
        "steiermark",
        "tirol",
        "vorarlberg",
        "wien"
      ]
    },
    "session_number": {
      "description": "Council session number (Sitzungsnummer) — council_minutes only.",
      "type": "string"
    },
    "legislature": {
      "description": "Legislative period (Gesetzgebungsperiode, e.g. \"XXVII\") — council_minutes only.",
      "type": "string"
    },
    "changed_since": {
      "description": "Coarse recency filter — documents changed in RIS within the interval. For exact windows use ris_track_changes.",
      "type": "string",
      "enum": [
        "one_week",
        "two_weeks",
        "one_month",
        "three_months",
        "six_months",
        "one_year"
      ]
    },
    "sort_by": {
      "description": "Sort column: published or number, where the collection has the column. Default: upstream order.",
      "type": "string",
      "enum": [
        "published",
        "number"
      ]
    },
    "sort_direction": {
      "description": "Sort direction; applies with sort_by.",
      "type": "string",
      "enum": [
        "ascending",
        "descending"
      ]
    },
    "page": {
      "description": "1-based result page. Default 1.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "page_size": {
      "description": "Documents per page — RIS accepts 10, 20, 50, or 100. Default 20.",
      "anyOf": [
        {
          "type": "number",
          "const": 10
        },
        {
          "type": "number",
          "const": 20
        },
        {
          "type": "number",
          "const": 50
        },
        {
          "type": "number",
          "const": 100
        }
      ]
    }
  },
  "required": [
    "collection"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

ris_lookup_citation

Resolve a single Austrian legal citation to its canonical RIS document deterministically — no keyword search. Four routes are auto-detected from the citation shape (or forced with kind): a norm citation — section-first ("§ 6 DSG", "Art 10 B-VG"), abbreviation-first ("DSG §1", "DSGVO Art32", the shape ris_search_case_law returns in norms_cited), or a bare abbreviation like "ABGB" — resolves through consolidated federal law, or a Bundesland with a state hint, as in force today or on in_force_as_of; a gazette citation ("BGBl. I Nr. 165/1999", pre-2004 "BGBl. Nr. 194/1961", imperial "RGBl. Nr. 189/1902", or "LGBl. Nr. 61/2026" with a state hint) routes to the right federal era tier by year or to a state Landesgesetzblatt; a case number ("Ra 2019/22/0184", "G 287/2022", "6Ob56/25k", "2025-0.934.677", "W256 …") is matched to its court — pass court to skip detection, and ambiguous formats probe up to two courts; a collection number ("VfSlg 19.632/2012", "VwSlg 18.000 A/2010") resolves through the VfGH/VwGH collection. Returns the single best-matching document in the same shape as the corresponding search tool, with alternatives_count when more than one matched. A citation that cannot be classified or resolved returns found: false with next-step guidance — it never throws for a miss; only an upstream RIS outage is an error. For keyword rather than citation lookup, use ris_search_legislation or ris_search_case_law.

Parameters5

citation	string	required	The legal citation to resolve, e.g. "§ 6 DSG" or "DSG §1", "Art 10 B-VG", "BGBl. I Nr. 165/1999", "Ra 2019/22/0184", or "VfSlg 19.632/2012".
kind	string	optional	Force a route, or auto (default) to classify by shape. Set explicitly when the citation shape is ambiguous.
court	string	optional	Court hint for a case number — short-circuits court detection to this court. Codes: ris_list_reference topic courts.
state	string	optional	Bundesland hint — routes a norm to that state’s consolidated law (LrKons) and an LGBl. gazette to that state’s Landesgesetzblatt (LgblAuth).
in_force_as_of	string	optional	For a norm, resolve the version in force on this date (YYYY-MM-DD). Defaults to today in Austria.

Raw schema

{
  "type": "object",
  "properties": {
    "citation": {
      "type": "string",
      "description": "The legal citation to resolve, e.g. \"§ 6 DSG\" or \"DSG §1\", \"Art 10 B-VG\", \"BGBl. I Nr. 165/1999\", \"Ra 2019/22/0184\", or \"VfSlg 19.632/2012\"."
    },
    "kind": {
      "default": "auto",
      "description": "Force a route, or auto (default) to classify by shape. Set explicitly when the citation shape is ambiguous.",
      "type": "string",
      "enum": [
        "auto",
        "norm",
        "gazette",
        "case_number",
        "collection_number"
      ]
    },
    "court": {
      "description": "Court hint for a case number — short-circuits court detection to this court. Codes: ris_list_reference topic courts.",
      "type": "string",
      "enum": [
        "vfgh",
        "vwgh",
        "justiz",
        "bvwg",
        "lvwg",
        "dsk",
        "normenliste",
        "dok",
        "pvak",
        "gbk",
        "uvs",
        "asylgh",
        "ubas",
        "umse",
        "bks",
        "verg",
        "upts"
      ]
    },
    "state": {
      "description": "Bundesland hint — routes a norm to that state’s consolidated law (LrKons) and an LGBl. gazette to that state’s Landesgesetzblatt (LgblAuth).",
      "type": "string",
      "enum": [
        "burgenland",
        "kaernten",
        "niederoesterreich",
        "oberoesterreich",
        "salzburg",
        "steiermark",
        "tirol",
        "vorarlberg",
        "wien"
      ]
    },
    "in_force_as_of": {
      "description": "For a norm, resolve the version in force on this date (YYYY-MM-DD). Defaults to today in Austria.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    }
  },
  "required": [
    "citation"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

ris_get_document

Fetch one RIS document’s full text or its rendition URLs, with explicit binding status and the amtssigniert authentic PDF surfaced wherever it exists. Address the document exactly one of two ways: document_number plus application (both copied verbatim from a ris_search_* or ris_lookup_citation result), or a document_url from a result’s content_urls. format: markdown (default — the HTML rendition converted to markdown), html (raw HTML rendition), xml (the RIS Nutzdaten XML), or urls_only (no fetch — every rendition URL, including the Authentisch PDF). Format availability varies by application and the tool degrades explicitly, never silently: consolidated law, gazettes, case law, drafts, and most sectoral collections carry full text; district and municipal promulgations and court rules (Bvb, GrA, KmGer) publish only the signed authentic PDF; party-transparency decisions and council minutes (Upts, Mrp) are PDF-only; the 1848–1940 imperial gazettes (BgblAlt) are metadata-only — for these a text-format request returns a format_unavailable notice with the usable URL, not an error. Every result carries binding_status; only authentic (amtssigniert) publications are legally binding. This tool returns content, not fresh metadata — the metadata rides the search/lookup step that produced the document number. When the markdown text overflows the byte budget the tool returns a §/Artikel/Anlage section outline (kind: outline) instead of truncating; re-call with sections:[…] naming outline entries to retrieve just those. Raw html/xml renditions, which carry no such headings, return in full.

Parameters5

document_number	string	optional	Technical RIS document number (Technisch.ID), e.g. NOR40262691, JJT_…, BGBLA_2026_II_171 — copy verbatim from a ris_search_* or ris_lookup_citation result. Requires application; mutually exclusive with document_url.
application	string	optional	RIS application the document belongs to (e.g. BrKons, Dsk, BgblAuth) — copy verbatim from the same result. Required with document_number. Codes and coverage: ris_list_reference topic applications.
document_url	string	optional	A https://www.ris.bka.gv.at/Dokumente/… main-document rendition URL as returned in a result’s content_urls — the alternative to document_number + application. Must address a main-document rendition ({documentNumber}.{ext}); content-attachment URLs (Materialien_/Anlagen_… memoranda and annexes) are not fetchable this way.
format	string	optional	markdown (default — the HTML rendition converted to markdown), html (raw HTML rendition), xml (RIS Nutzdaten schema), or urls_only (no fetch — all rendition URLs incl. the authentic PDF).
sections	array	optional	Section names to retrieve, each copied verbatim from a prior outline response (kind: outline). Omit for the full document — which returns a §/Artikel/Anlage outline instead when the markdown overflows the byte budget. Applies to text formats; ignored for urls_only.

Raw schema

{
  "type": "object",
  "properties": {
    "document_number": {
      "description": "Technical RIS document number (Technisch.ID), e.g. NOR40262691, JJT_…, BGBLA_2026_II_171 — copy verbatim from a ris_search_* or ris_lookup_citation result. Requires application; mutually exclusive with document_url.",
      "type": "string"
    },
    "application": {
      "description": "RIS application the document belongs to (e.g. BrKons, Dsk, BgblAuth) — copy verbatim from the same result. Required with document_number. Codes and coverage: ris_list_reference topic applications.",
      "type": "string",
      "enum": [
        "BrKons",
        "BgblAuth",
        "BgblPdf",
        "BgblAlt",
        "Begut",
        "RegV",
        "Erv",
        "LrKons",
        "LgblAuth",
        "Lgbl",
        "LgblNO",
        "Vbl",
        "Bvb",
        "Gr",
        "GrA",
        "Vfgh",
        "Vwgh",
        "Normenliste",
        "Justiz",
        "Bvwg",
        "Lvwg",
        "Dsk",
        "Dok",
        "Pvak",
        "Gbk",
        "Uvs",
        "AsylGH",
        "Ubas",
        "Umse",
        "Bks",
        "Verg",
        "PruefGewO",
        "Avsv",
        "Spg",
        "Avn",
        "KmGer",
        "Upts",
        "Mrp",
        "Erlaesse"
      ]
    },
    "document_url": {
      "description": "A https://www.ris.bka.gv.at/Dokumente/… main-document rendition URL as returned in a result’s content_urls — the alternative to document_number + application. Must address a main-document rendition ({documentNumber}.{ext}); content-attachment URLs (Materialien_/Anlagen_… memoranda and annexes) are not fetchable this way.",
      "type": "string"
    },
    "format": {
      "default": "markdown",
      "description": "markdown (default — the HTML rendition converted to markdown), html (raw HTML rendition), xml (RIS Nutzdaten schema), or urls_only (no fetch — all rendition URLs incl. the authentic PDF).",
      "type": "string",
      "enum": [
        "markdown",
        "html",
        "xml",
        "urls_only"
      ]
    },
    "sections": {
      "description": "Section names to retrieve, each copied verbatim from a prior outline response (kind: outline). Omit for the full document — which returns a §/Artikel/Anlage outline instead when the markdown overflows the byte budget. Applies to text formats; ignored for urls_only.",
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

ris_track_changes

Track every document added or changed in one RIS application within an exact date window (changed_from/changed_to) via the History controller, optionally including deletions (include_deleted) — the delta-sync and monitoring primitive for mirrors and watchers, and the only surface that reports removals. Unlike the search tools’ coarse, additive-only changed_since intervals, this is exact-dated and deletion-aware. application takes any RIS application code (e.g. BrKons, Dsk, BgblAuth); the four History name aliases are handled internally. Each changed document comes back in a compact cross-class record — document_number (for ris_get_document), title, dates, binding_status, and rendition URLs — plus its last-changed date; removed documents come back as deleted records with a deletion timestamp. One application per call; page explicitly for large windows. Application codes and coverage: ris_list_reference topic applications.

Parameters6

application	string	required	RIS application whose change feed to read (standard code, e.g. BrKons, LrKons, Dsk, BgblAuth). History’s four aliased names are mapped internally. Codes: ris_list_reference topic applications.
changed_from	string	optional	Include documents changed on/after this date (YYYY-MM-DD, AenderungenVon). Exact date, not a coarse interval.
changed_to	string	optional	Include documents changed on/before this date (YYYY-MM-DD, AenderungenBis).
include_deleted	boolean	optional	true also returns documents removed from RIS in the window, as deleted records — the only way to observe deletions.
page	integer	optional	1-based result page. Default 1.
page_size	any	optional	Documents per page — RIS accepts 10, 20, 50, or 100. Default 20.

Raw schema

{
  "type": "object",
  "properties": {
    "application": {
      "type": "string",
      "enum": [
        "BrKons",
        "BgblAuth",
        "BgblPdf",
        "BgblAlt",
        "Begut",
        "RegV",
        "Erv",
        "LrKons",
        "LgblAuth",
        "Lgbl",
        "LgblNO",
        "Vbl",
        "Bvb",
        "Gr",
        "GrA",
        "Vfgh",
        "Vwgh",
        "Normenliste",
        "Justiz",
        "Bvwg",
        "Lvwg",
        "Dsk",
        "Dok",
        "Pvak",
        "Gbk",
        "Uvs",
        "AsylGH",
        "Ubas",
        "Umse",
        "Bks",
        "Verg",
        "PruefGewO",
        "Avsv",
        "Spg",
        "Avn",
        "KmGer",
        "Upts",
        "Mrp",
        "Erlaesse"
      ],
      "description": "RIS application whose change feed to read (standard code, e.g. BrKons, LrKons, Dsk, BgblAuth). History’s four aliased names are mapped internally. Codes: ris_list_reference topic applications."
    },
    "changed_from": {
      "description": "Include documents changed on/after this date (YYYY-MM-DD, AenderungenVon). Exact date, not a coarse interval.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "changed_to": {
      "description": "Include documents changed on/before this date (YYYY-MM-DD, AenderungenBis).",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "include_deleted": {
      "description": "true also returns documents removed from RIS in the window, as deleted records — the only way to observe deletions.",
      "type": "boolean"
    },
    "page": {
      "description": "1-based result page. Default 1.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "page_size": {
      "description": "Documents per page — RIS accepts 10, 20, 50, or 100. Default 20.",
      "anyOf": [
        {
          "type": "number",
          "const": 10
        },
        {
          "type": "number",
          "const": 20
        },
        {
          "type": "number",
          "const": 50
        },
        {
          "type": "number",
          "const": 100
        }
      ]
    }
  },
  "required": [
    "application"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

ris_list_reference

Ground the opaque German codes across the RIS surface — static and offline, no upstream call. Topics: applications (all 39, with coverage windows, binding status, and content formats), courts (17 codes with Geschäftszahl examples and successor mapping), states (the three Bundesland request spellings), decision_types, decision_kinds (per-court Entscheidungsart values), issuing_bodies (dsk/dok/pvak/verg bodies and social-insurance issuers), ministries (abbreviations and full designations, historical included), collections (the 7 announcement collections and their parameter matrix), stages (lawmaking pipeline), changed_since_intervals, section_types, gazette_parts (BGBl parts and era tiers), law_types, district_authorities (all Bezirksverwaltungsbehörden), justiz_subject_areas (Fachgebiet taxonomy), search_syntax (operators and wildcard rules), and citation_formats (the shapes ris_lookup_citation parses). Recovery hints from the other ris_* tools route here.

Parameters1

topic

string

required

Which reference table to return. Pick the topic named in the error recovery hint or zero-hit notice that sent you here.

Raw schema

{
  "type": "object",
  "properties": {
    "topic": {
      "type": "string",
      "enum": [
        "applications",
        "courts",
        "states",
        "decision_types",
        "decision_kinds",
        "issuing_bodies",
        "ministries",
        "collections",
        "stages",
        "changed_since_intervals",
        "section_types",
        "gazette_parts",
        "law_types",
        "district_authorities",
        "justiz_subject_areas",
        "search_syntax",
        "citation_formats"
      ],
      "description": "Which reference table to return. Pick the topic named in the error recovery hint or zero-hit notice that sent you here."
    }
  },
  "required": [
    "topic"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

README.md20 KBView on GitHub

@cyanheads/ris-austria-mcp-server

Search Austrian law at every level — consolidated federal, state & municipal norms, court decisions, the authentic gazettes, the lawmaking pipeline, and ministerial decrees — from the official RIS via MCP. Keyless. STDIO or Streamable HTTP.

9 Tools • 1 Resource

MCP SDK TypeScript

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

RIS (Rechtsinformationssystem des Bundes) is the Austrian government's official legal database: consolidated federal, state, and municipal law, case law across every Austrian court and tribunal, the authentic gazettes at every level of government (whose promulgated text is binding under Austrian law), the pre-parliamentary lawmaking pipeline, and ministerial decrees. This server wraps the keyless RIS OGD REST API (v2.6, CC BY 4.0) for MCP agents — the entire OGD application surface, back to the Reichsgesetzblatt of 1848. It labels every document's binding status and never presents non-authentic text as the authentic wording.

Tools

Nine tools split by document class, plus a deterministic citation resolver, document retrieval, a change feed, and an offline vocabulary reference:

Tool	Description
`ris_search_legislation`	Search consolidated federal, state, and municipal law — one document per §/Artikel/Anlage — filtered to the version in force on a given date (defaults to today). Also serves English translations of selected laws.
`ris_search_case_law`	Search Austrian case law (Judikatur) in one court or tribunal per call — VfGH, VwGH, ordinary courts, BVwG, LVwG, DSB, the party-transparency senate, and ten more.
`ris_search_gazette`	Browse the promulgation record at every level — federal (three era tiers back to 1848, auto-routed), state law & ordinance gazettes, district, and municipal — the compliance-monitoring surface.
`ris_search_drafts`	Search the federal lawmaking pipeline: ministerial drafts in public review (Begutachtungsentwürfe) and government bills (Regierungsvorlagen).
`ris_search_announcements`	Search sectoral official gazettes and executive documents: social-insurance notices, veterinary notices, court rules, trade-exam regulations, health structure plans, ministerial decrees, council-of-ministers minutes.
`ris_lookup_citation`	Resolve one Austrian legal citation ("§ 6 DSG", "BGBl. I Nr. 165/1999", "RGBl. Nr. 189/1902", a Geschäftszahl, "VfSlg 19.632/2012") deterministically to its canonical document.
`ris_get_document`	Fetch one document's full text as markdown/HTML/XML, or its export URLs, with binding-status labeling and the authentic PDF wherever one exists.
`ris_track_changes`	Exact-dated change feed per application — every document added or changed in a window, deletions included. The delta-sync primitive.
`ris_list_reference`	Ground the domain vocabulary offline — applications and coverage windows, court codes, Bundesländer, decision kinds, ministries, district authorities, gazette eras and parts, citation formats, search syntax.

`ris_search_legislation`

Search consolidated law (BrKons federal, LrKons state, Gr municipal) with in-force-date handling correct by default.

Full-text query with RIS boolean grammar (UND/ODER/NICHT or AND/OR/NOT, parentheses, quoted phrases) and title matching title, short title, or abbreviation ("DSG", "ABGB")
scope routes federal or one of the nine Bundesländer; municipality narrows a state scope to municipal law (selected norms, six Bundesländer); language: english serves the Erv collection of selected English translations
in_force_as_of defaults to today — omitting the date upstream silently searches all historical versions; include_all_versions is the explicit opt-in, and the applied date is echoed in every response
Force-window filters (entered_force_from/to, left_force_from/to) track provisions entering or leaving force in a date range — new-law and repeal monitoring
Section-range filtering (section_from/section_to/section_type — §, Artikel, Anlage), law-level grouping via law_id (Gesetzesnummer), Systematik index, changed_since windows
Output per document: section label, in-force date, ELI, parsed CELEX references (the EU-transposition hook), and export URLs (XML/HTML/PDF/RTF)

`ris_search_case_law`

Search decisions and headnotes across Austria's courts and tribunals — 17 applications.

One application per call (court, required): vfgh, vwgh, justiz, bvwg, lvwg, dsk, upts (party-transparency senate), plus ten historical/specialized tribunals — cross-court research fans out one call per court
Filter by cited provision (norm — "DSG §1", "DSGVO Art32"), exact case number (case_number, Geschäftszahl), decision date range, decision kind (Erkenntnis/Beschluss/…), and full-text query
decision_type targets headnotes (Rechtssätze), full decision texts, or both
Court-conditional filters: issuing_body (dsk/dok/pvak/verg), court_name, legal_area, subject_area (justiz — "Datenschutzrecht", "Insolvenzrecht"), state (lvwg/uvs), collection_number (VfSlg/VwSlg cites), party (upts), commission/senate/discrimination ground (gbk), media statute (bks)
Output per decision: case numbers, decision date, ECLI, cited norms, keywords, the guiding principle (Leitsatz) on headnote documents, and headnote/decision URLs

`ris_search_gazette`

Browse the promulgation record at every level of government — what ris_lookup_citation (point lookup) can't express.

scope: federal, one of the nine Bundesländer, district (Bezirksverwaltungsbehörden), or municipal (authentic municipal promulgations)
Federal history is one logical series, auto-routed across three era tiers: BgblAuth (2004+, authentic), BgblPdf (Staats- und Bundesgesetzblatt 1945–2003), BgblAlt (Reichs-, Staats- und Bundesgesetzblatt 1848–1940, metadata + ÖNB-hosted scans) — with a notice naming which tier served
Filter by publication date range, gazette part (BGBl. I/II/III, or pre_1997 for the partless era), document type, issuing ministry, district authority, or municipality
State scopes serve the authentic Landesgesetzblätter by default; series: ordinance_gazette switches to the Verordnungsblätter, include_non_authentic adds the historical non-authentic gazettes
Point lookup by gazette number ("BGBl. II Nr. 171/2026" or "171/2026")
Every record carries a binding label (authentic, historical_record, or consolidated_informational) and the amtssigniert PDF URL when present; the metadata-only 1848–1940 gazettes link to their ÖNB ALEX scan

`ris_search_drafts`

Watch federal law before it becomes law.

stage: review_drafts — ministerial drafts in public review (Begutachtungsentwürfe), including "what is in review right now" via in_review_on
stage: government_bills — bills adopted by the council of ministers (Regierungsvorlagen, 2004+), filtered by adoption date
ministry accepts the abbreviation ("BMF") — the server expands it to RIS's exact designation
Output includes review deadlines and council adoption dates

`ris_search_announcements`

Sectoral official gazettes and executive documents — seven collections, five of them legally binding authentic publications.

collection: social_insurance (Avsv), veterinary (Avn), court_rules (KmGer), trade_exam_rules (PruefGewO), health_structure_plans (Spg — ÖSG/RSG), ministerial_decrees (Erlässe), council_minutes (Ministerratsprotokolle)
Collection-aware filters: issue numbers, issuers (insurance carriers, ministries), cited norm ("decrees citing the DSG"), in-force date for the consolidated collections, plan type/state for health plans, session number/legislature for council minutes
Binding labels per collection: authentic, administrative_directive (decrees bind the administration, not citizens), or preparatory (council minutes)

`ris_lookup_citation`

Citation-first resolution — how Austrian legal work actually starts.

Parses and routes four citation kinds: norm cites ("§ 6 DSG", "Art 10 B-VG"), gazette numbers across all three federal eras plus LGBl ("BGBl. I Nr. 165/1999", "BGBl. Nr. 194/1961", "RGBl. Nr. 189/1902"), case numbers ("Ra 2019/22/0184", "2025-0.934.677", "6Ob56/25k"), and collection numbers ("VfSlg 19.632/2012")
Deterministic upstream filters (section + title, per-era number params, Geschäftszahl, Sammlungsnummer) — no keyword-search fuzziness
Returns found: false with structured guidance instead of throwing when nothing resolves
court and state hints short-circuit ambiguous formats

`ris_get_document`

Read and export a single document.

Addresses documents by document_number + application (from any search/lookup result) or a passed-through ris.bka.gv.at document URL (host and path allowlisted)
format: markdown (default, boilerplate stripped), raw html, RIS xml, or urls_only
Binding status on every response: authentic (with amtssigniert PDF URL), consolidated_informational, historical_record, decision, preparatory, administrative_directive, or translation — non-authentic text is never presented as the binding text
Format availability is explicit: applications that publish only the signed PDF (district/municipal promulgations, court rules) or only scans (1848–1940 gazettes, ÖNB-hosted) return a format_unavailable notice with the usable URLs instead of failing
Oversized markdown returns a retrievable §/Artikel/Anlage section outline (kind: outline) instead of truncating — re-call with sections:[…] to pull just the sections you need
Returns content, not fresh metadata — the upstream API has no document-by-number search, so document numbers come from a prior search or lookup result

`ris_track_changes`

Exact-dated per-application change feed (the RIS History controller).

application + changed_from/changed_to: every document added or changed in the window — 1,400+ changes in a typical two-week federal-law window
include_deleted surfaces removals — the only RIS surface that can
Coarser alternative: the search tools' changed_since interval filters

Resource

Type	Name	Description
Resource	`ris://document/{application}/{documentNumber}`	Markdown text of one RIS document — injectable twin of `ris_get_document`

All resource data is also reachable via tools — clients without resource support use ris_get_document.

Features

Built on @cyanheads/mcp-ts-core:

Declarative tool and resource definitions — single file per primitive, framework handles registration and validation
Unified error handling — handlers throw, framework catches, classifies, and formats
Pluggable auth (none, jwt, oauth)
Structured logging with optional OpenTelemetry tracing
STDIO and Streamable HTTP transports

RIS-specific:

The full RIS OGD surface — all 39 applications across every controller: consolidated law (federal/state/municipal), authentic gazettes at four levels of government, three federal gazette era tiers back to 1848, 17 court/tribunal applications, the lawmaking pipeline, sectoral gazettes, ministerial decrees, English translations, and the per-application change feed
Strict parameter allowlist — RIS silently ignores unknown query params (a typo returns plausible but unfiltered results), so only live-confirmed spellings are ever sent upstream
Normalizer for RIS's JSON-serialized-XML envelope: object-or-array coercion, in-band error detection, six per-controller metadata classes, <br/> cleanup, CELEX reference parsing, ministry-abbreviation expansion
English tool surface over RIS's German API — Austrian legal terms (Geschäftszahl, Rechtssatz, Bundesgesetzblatt) kept as domain vocabulary and glossed in descriptions

Agent-friendly output:

No dead ends — error recovery hints, zero-hit notices, format-unavailable notices, and found: false guidance each name the concrete next call (ris_list_reference topic, the right search tool, ris_lookup_citation), never a bare "check your input"
Zero hits are success plus a composed notice, never an error; conditional-parameter misuse (a court-specific filter with the wrong court, part outside federal scope, a collection filter on the wrong collection, bad addressing) is caught locally before any upstream call
Applied-filter echo — the in_force_as_of default is never invisible to the calling agent
Structured no-resolve results (found: false + guidance) instead of throws on citation lookup
Upstream schema-validation messages passed through — RIS enumerates valid values, which lets agents self-correct
Oversized documents return a retrievable section outline, never a silent cut — re-call with the chosen sections for selective retrieval

Localization

Tool and parameter descriptions are English-only today. German (de-AT) descriptions are planned, pending opt-in localization support in the framework (cyanheads/mcp-ts-core#259); the English surface stays the default and fallback.

Getting started

The one-click badges above (Claude Desktop, Cursor, VS Code) are the fastest path. To configure a client manually, the server runs straight from npm — no clone or build required.

Public Hosted Instance

A public instance is available at https://ris-austria.caseyjhand.com/mcp — no installation required. Point any MCP client at it via Streamable HTTP:

json

{
  "mcpServers": {
    "ris-austria-mcp-server": {
      "type": "streamable-http",
      "url": "https://ris-austria.caseyjhand.com/mcp"
    }
  }
}

Prerequisites

Bun v1.3 or higher, or Node.js v24+ (needed for npx/bunx)
No API key — the RIS OGD API is keyless

Install from npm (recommended)

Add the server to your MCP client configuration:

json

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

bunx @cyanheads/ris-austria-mcp-server works the same way if you prefer Bun. Add any configuration variables under an "env" key.

Install from source

For local development or to run a pinned build:

Clone the repository:

git clone https://github.com/cyanheads/ris-austria-mcp-server.git

Navigate into the directory:

cd ris-austria-mcp-server

Install dependencies and build:

bun install
bun run rebuild

Add to your MCP client configuration file:

json

{
  "mcpServers": {
    "ris-austria-mcp-server": {
      "type": "stdio",
      "command": "node",
      "args": ["/absolute/path/to/ris-austria-mcp-server/dist/index.js"],
      "env": {
        "MCP_TRANSPORT_TYPE": "stdio",
        "MCP_LOG_LEVEL": "info"
      }
    }
  }
}

For Streamable HTTP, set the transport and start the server:

MCP_TRANSPORT_TYPE=http MCP_HTTP_PORT=3010 bun run start:http
# Server listens at http://localhost:3010/mcp

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 (also the allowlist host for `document_url` input).	`https://www.ris.bka.gv.at`
`RIS_CONTACT`	Contact string appended to the User-Agent (RIS netiquette asks integrators to be identifiable).	none
`MCP_TRANSPORT_TYPE`	Transport: `stdio` or `http`.	`stdio`
`MCP_HTTP_PORT`	HTTP server port.	`3010`
`MCP_AUTH_MODE`	Authentication: `none`, `jwt`, or `oauth`.	`none`
`MCP_LOG_LEVEL`	Log level (`debug`, `info`, `warning`, `error`, …).	`info`
`STORAGE_PROVIDER_TYPE`	Storage backend.	`in-memory`
`OTEL_ENABLED`	Enable OpenTelemetry instrumentation.	`false`

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

Running the server

Local development

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

Project structure

Directory	Purpose
`src/index.ts`	`createApp()` entry point — registers tools and resources.
`src/mcp-server/tools`	Tool definitions (`*.tool.ts`).
`src/mcp-server/resources`	Resource definitions (`*.resource.ts`).
`docs/design.md`	Settled v1 design — tool surface, service spec, live-confirmed RIS API reference.
`tests/`	Unit and integration tests mirroring `src/`.
`skills/`	Framework 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

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.

Install

Tools (9)

ris_search_legislationris_search_case_lawris_search_gazetteris_search_draftsris_search_announcementsris_lookup_citationris_get_documentris_track_changes

Configuration

Environment variables

MCP_LOG_LEVELdefault info

Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').

RIS_CONTACT

Optional contact string appended to the User-Agent (RIS netiquette asks integrators to be identifiable).

MCP_HTTP_HOSTdefault 127.0.0.1

The hostname for the HTTP server.

MCP_HTTP_PORTdefault 3010

The port to run the HTTP server on.

MCP_HTTP_ENDPOINT_PATHdefault /mcp

The endpoint path for the MCP server.

MCP_AUTH_MODEdefault none

Authentication mode to use: 'none', 'jwt', or 'oauth'.

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "ris-austria-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/ris-austria-mcp-server@0.1.6",
        "run",
        "start:stdio"
      ],
      "env": {
        "MCP_LOG_LEVEL": "info",
        "RIS_CONTACT": "<YOUR_RIS_CONTACT>"
      }
    }
  }
}