Server definition
- Hash
- sha256:e245d2e8bccddeca51fc85b8ccded8df643094769ec0daf9701290861a4be6fc
- What it is
- What a remote MCP server returned when asked what it offers: 9 tools
The blob, as servednamed by its sha256
{
"instructions": null,
"tools": [
{
"description": "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 — or, for a draft’s companion documents (Erläuterungen, Textgegenüberstellung, WFA, cover letter, annexes), a ris_search_drafts record’s materials[].url, which is the only route to them. 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 40,000-byte budget the tool returns an outline (kind: outline) instead of truncating: the document’s §/Artikel/Anlage sections where it carries at least two such headings, otherwise contiguous byte windows named Part 1 of N … Part N of N covering the whole text and listed in document order. Re-call with sections:[…] naming outline entries to retrieve just those; a name matching no entry returns the outline again with a notice rather than the whole document. Windows are cut at line breaks, not at sentence or § boundaries, so one can open mid-sentence — read them in order and pull the neighbour when a passage straddles a cut. Raw html and xml renditions are never sliced: at or under the 40,000-byte budget they return whole; over it the result is kind: link — no text, truncated: true, the full byte_size, and content_urls, whose html or xml entry fetches the whole artifact in one GET. Every HTML rendition opens with a 40–70 KB stylesheet, so html practically always returns kind: link — read with markdown, parse with xml, and fetch content_urls.html for the authentic markup. Markdown drops the screen-reader expansions RIS ships alongside each abbreviated citation, keeping the visible citation form; raw html/xml renditions are returned exactly as published.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"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.",
"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"
],
"type": "string"
},
"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"
},
"document_url": {
"description": "A /Dokumente/… rendition URL on https://www.ris.bka.gv.at or https://ogd.ris.bka.gv.at, passed exactly as a result’s content_urls returned it — the alternative to document_number + application. Also the only way to read a draft’s companion documents: pass a ris_search_drafts record’s materials[].url (the Erläuterungen, Textgegenüberstellung, WFA, cover letter, or annex), whose filenames are opaque and per-record and so cannot be reached through document_number. Every companion filename RIS publishes is accepted, whichever shape it carries. The URL’s own extension is only checked against the rendition extensions RIS uses and is then discarded — format selects which rendition is returned, for a companion exactly as for a main document. A filename that is neither this document’s own rendition nor one of its companions is rejected; companion filenames cannot be composed by hand, so copy one verbatim.",
"type": "string"
},
"format": {
"default": "markdown",
"description": "markdown (default — the HTML rendition converted to markdown, and the format for reading), html (raw HTML rendition), xml (RIS Nutzdaten schema), or urls_only (no fetch — all rendition URLs incl. the authentic PDF). html and xml over 40,000 bytes return kind: link with no text — nearly every html rendition does, since each carries a 40–70 KB stylesheet — so fetch content_urls.html or content_urls.xml for the whole artifact.",
"enum": [
"markdown",
"html",
"xml",
"urls_only"
],
"type": "string"
},
"sections": {
"description": "Entry names to retrieve, each copied verbatim from a prior outline response (kind: outline) — §/Artikel/Anlage section names, or window names of the form \"Part 2 of 6\". Omit for the full document, which returns an outline instead when the markdown overflows the 40,000-byte budget. A name that matches no entry is never silently ignored: a total miss returns the outline (kind: outline) with a notice, a partial miss returns the matched entries with a notice naming others to pick from. Applies to markdown only. html and xml are never sliced — the selector is ignored with a notice, and they return whole under the 40,000-byte budget and as kind: link over it; urls_only carries no text to select from.",
"items": {
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"name": "ris_get_document",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"format",
"kind",
"binding_status",
"content_urls",
"document_number",
"application"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"application": {
"description": "RIS application the document belongs to (echoed).",
"type": "string"
},
"authentic_pdf_url": {
"description": "The amtssigniert authentic PDF (.pdfsig, Authentisch DataType) — the legally binding artifact — where the application publishes one.",
"type": "string"
},
"binding_status": {
"description": "Legal binding status: authentic (amtssigniert, legally binding), consolidated_informational (consolidated view — not binding), historical_record (superseded/pre-e-Recht promulgation), decision (court/tribunal ruling), preparatory (draft/bill/minutes), administrative_directive (binds the administration, not citizens), or translation (unofficial English).",
"enum": [
"authentic",
"consolidated_informational",
"historical_record",
"decision",
"preparatory",
"administrative_directive",
"translation"
],
"type": "string"
},
"byte_size": {
"description": "Full UTF-8 byte size of the document text. Present when text was fetched — for an overflowed document (kind: outline) or an over-budget html/xml rendition (kind: link) this reports the full text’s size, not the returned payload’s.",
"type": "number"
},
"content_urls": {
"additionalProperties": false,
"description": "Constructed rendition URLs. Empty for authentic-PDF-only (Bvb/GrA/KmGer) and metadata-only (BgblAlt) applications — see authentic_pdf_url and the notice. For a companion document (a draft’s Erläuterungen, Textgegenüberstellung, WFA, cover letter, or annex) these are the companion’s own XML/HTML/PDF, not the parent document’s — constructed rather than read back from RIS, so for the roughly one companion in eight that RIS files as a PDF only, xml and html return 404 and pdf is the one that resolves.",
"properties": {
"html": {
"description": "HTML rendition URL.",
"type": "string"
},
"pdf": {
"description": "PDF rendition URL.",
"type": "string"
},
"rtf": {
"description": "RTF rendition URL.",
"type": "string"
},
"xml": {
"description": "XML rendition URL (RIS Nutzdaten schema).",
"type": "string"
}
},
"type": "object"
},
"document_number": {
"description": "Technical RIS document number (echoed).",
"type": "string"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `invalid_addressing`: Neither or both addressing modes were provided, document_number was given without application, or the document_number/application pairing is not a valid RIS document — thrown locally before any fetch. `unsupported_url`: document_url fails the origin + /Dokumente/ path-prefix allowlist (exactly https://www.ris.bka.gv.at and https://ogd.ris.bka.gv.at), its path segment is not a recognized RIS application, or its trailing filename addresses neither the document’s own rendition nor one of its companion documents — thrown locally, nothing fetched. `document_not_found`: The constructed or passed content URL returned 404. `upstream_error`: The RIS content host was unreachable or returned a server error. `upstream_timeout`: The content host did not return the rendition within the fetch deadline — typically a cold render, which it performs on first request before caching the result. Other values are possible when a failure originates below the handler.",
"examples": [
"invalid_addressing",
"unsupported_url",
"document_not_found",
"upstream_error",
"upstream_timeout"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"format": {
"description": "The format served — echoes the requested format.",
"enum": [
"markdown",
"html",
"xml",
"urls_only"
],
"type": "string"
},
"kind": {
"description": "full — the complete response (document text, selected entries, or rendition URLs). outline — sections lists the retrievable entries instead of the text, either because the markdown overflowed the byte budget or because a sections:[…] selector matched nothing; re-call with sections:[…] naming entries from it. link — an html or xml rendition over the 40,000-byte budget: no text, only byte_size and content_urls, whose entry for the requested format fetches the whole artifact in one GET; re-call with format: markdown to read it.",
"enum": [
"full",
"outline",
"link"
],
"type": "string"
},
"notice": {
"description": "Present when the requested text format is unavailable for this application (names why and the usable URL), when the document overflowed to a section outline (names how to retrieve sections), when an html or xml rendition overflowed to a link (names content_urls.<format> and format: markdown), or when a sections:[…] entry matched no section or was ignored (names the unmatched entries).",
"type": "string"
},
"sections": {
"description": "Present when kind = outline: the document’s addressable entries, each with its UTF-8 byte size — §/Artikel/Anlage sections listed largest first, or, when the markdown carries no such headings, Part n of N byte windows listed in document order and summing to byte_size. Copy names into the sections input verbatim to retrieve them; naming several in one call returns their text concatenated in document order, with nothing inserted between them.",
"items": {
"additionalProperties": false,
"description": "A retrievable entry — a §/Artikel/Anlage section or a Part n of N byte window, with its UTF-8 byte size.",
"properties": {
"bytes": {
"description": "Serialized byte size of the section",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"name": {
"description": "Section identifier — pass in `sections` to retrieve it",
"type": "string"
}
},
"required": [
"name",
"bytes"
],
"type": "object"
},
"type": "array"
},
"text": {
"description": "The document text in the requested format. Absent for urls_only, when the application carries no text rendition (see the notice), for an outline (kind: outline), and for an html or xml rendition over the 40,000-byte budget (kind: link).",
"type": "string"
},
"truncated": {
"description": "Present and true when the full text isn’t inline. kind: outline — the markdown overflowed the byte budget or a sections:[…] selector matched nothing (the notice names which); retrieve entries via the sections input. kind: link — an html or xml rendition overflowed the budget; fetch content_urls.html or content_urls.xml for the whole artifact, or re-call with format: markdown.",
"type": "boolean"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"topic": {
"description": "Which reference table to return. Pick the topic named in the error recovery hint or zero-hit notice that sent you here.",
"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"
],
"type": "string"
}
},
"required": [
"topic"
],
"type": "object"
},
"name": "ris_list_reference",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"topic",
"summary",
"entries",
"notes"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"entries": {
"description": "Reference entries for the topic.",
"items": {
"additionalProperties": false,
"description": "One reference entry: a value, its label, and its attributes.",
"properties": {
"details": {
"description": "Additional attributes as key–value pairs; keys vary by topic (coverage windows, upstream spellings, examples, notes).",
"items": {
"additionalProperties": false,
"description": "One key–value attribute pair.",
"properties": {
"key": {
"description": "Attribute name.",
"type": "string"
},
"value": {
"description": "Attribute value.",
"type": "string"
}
},
"required": [
"key",
"value"
],
"type": "object"
},
"type": "array"
},
"label": {
"description": "Concise human-readable label or gloss for the value.",
"type": "string"
},
"value": {
"description": "The reference value — an enum value, application code, exact filter string, or syntax element, depending on the topic.",
"type": "string"
}
},
"required": [
"value",
"label",
"details"
],
"type": "object"
},
"type": "array"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode.",
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"notes": {
"description": "Topic-level caveats and usage guidance. Empty when none apply.",
"items": {
"type": "string"
},
"type": "array"
},
"summary": {
"description": "What this topic covers and which tool parameters consume its values.",
"type": "string"
},
"topic": {
"description": "The requested topic, echoed back.",
"type": "string"
}
},
"type": "object"
}
},
{
"description": "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 — falling back to that Bundesland’s pre-e-Recht series when the citation predates its switch; a case number (\"Ro 2026/03/0016\", \"G 287/2022\", \"14Os49/26a\", \"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 — a VwSlg cite given without its part letter can name one decision in each of the two VwGH series, and comes back as ambiguous with both cites named rather than resolved to one of them. 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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"citation": {
"description": "The legal citation to resolve, e.g. \"§ 6 DSG\" or \"DSG §1\", \"Art 10 B-VG\", \"BGBl. I Nr. 165/1999\", \"Ro 2026/03/0016\", or \"VfSlg 19.632/2012\".",
"type": "string"
},
"court": {
"description": "Court hint for a case number — short-circuits court detection to this court. Codes: ris_list_reference topic courts, minus normenliste (a norm index, which carries no case numbers).",
"enum": [
"vfgh",
"vwgh",
"justiz",
"bvwg",
"lvwg",
"dsk",
"dok",
"pvak",
"gbk",
"uvs",
"asylgh",
"ubas",
"umse",
"bks",
"verg",
"upts"
],
"type": "string"
},
"in_force_as_of": {
"description": "For a norm, resolve the version in force on this date (YYYY-MM-DD). Defaults to today in Austria.",
"pattern": "^\\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\\d|3[01])$",
"type": "string"
},
"kind": {
"default": "auto",
"description": "Force a route, or auto (default) to classify by shape. Set explicitly when the citation shape is ambiguous.",
"enum": [
"auto",
"norm",
"gazette",
"case_number",
"collection_number"
],
"type": "string"
},
"state": {
"description": "Bundesland hint — routes a norm to that state’s consolidated law (LrKons) and an LGBl. gazette to that state’s Landesgesetzblatt (LgblAuth, then the legacy Lgbl series for a citation predating the state’s e-Recht switch).",
"enum": [
"burgenland",
"kaernten",
"niederoesterreich",
"oberoesterreich",
"salzburg",
"steiermark",
"tirol",
"vorarlberg",
"wien"
],
"type": "string"
}
},
"required": [
"citation"
],
"type": "object"
},
"name": "ris_lookup_citation",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"found",
"kind"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"alternatives_count": {
"description": "Documents that also matched beyond the one returned — present only when more than one matched. List them all with the search tool named in resolution_note.",
"type": "number"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `upstream_error`: A routed RIS search was unreachable, returned a server error, or served an HTML error page. An unparseable or unresolvable citation is NOT this error — it returns found: false. `upstream_timeout`: A routed RIS search did not answer within the request deadline. Other values are possible when a failure originates below the handler.",
"examples": [
"upstream_error",
"upstream_timeout"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"found": {
"description": "True when the citation resolved to a single best-matching document.",
"type": "boolean"
},
"guidance": {
"description": "Next-step guidance naming a concrete tool. Present when found is false.",
"type": "string"
},
"kind": {
"description": "What the citation parsed as — \"unknown\" when it did not classify into any route.",
"enum": [
"unknown",
"norm",
"gazette",
"case_number",
"collection_number"
],
"type": "string"
},
"record": {
"additionalProperties": {},
"description": "The resolved document, in the same normalized shape the corresponding search tool returns — ris_search_legislation for a norm, ris_search_case_law for a case or collection number, ris_search_gazette for a gazette. Present when found is true.",
"properties": {},
"type": "object"
},
"resolution_note": {
"description": "Which application and filter resolved the citation. Present when found is true.",
"type": "string"
}
},
"type": "object"
}
},
{
"description": "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 and social-insurance carrier abbreviations expanded), norm (\"decrees citing the DSG\"), case_number, type, department, plan_type/plan_state (health plans), session_number/legislature (council minutes), and changed_since (all but social_insurance and veterinary) apply where the collection supports them — a filter outside its set is rejected locally. Every result carries a binding label, the authentic PDF where it exists, and the RIS web view (document_url) — the only browsable surface for the PDF-only council minutes and for ministerial decrees. Per-collection parameter matrix and issuers: ris_list_reference topic collections or issuing_bodies.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"case_number": {
"description": "Business reference number (Geschäftszahl) — veterinary and ministerial_decrees only. Omit to leave unfiltered; a blank value is rejected.",
"pattern": "\\S",
"type": "string"
},
"changed_since": {
"description": "Coarse recency filter — documents changed in RIS within the interval. Every collection except social_insurance and veterinary, where RIS ignores it: use published_from there, or ris_track_changes for changes. For exact windows use ris_track_changes.",
"enum": [
"one_week",
"two_weeks",
"one_month",
"three_months",
"six_months",
"one_year"
],
"type": "string"
},
"collection": {
"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.",
"enum": [
"social_insurance",
"veterinary",
"court_rules",
"trade_exam_rules",
"health_structure_plans",
"ministerial_decrees",
"council_minutes"
],
"type": "string"
},
"department": {
"description": "Ministry department (Abteilung) — ministerial_decrees only. Omit to leave unfiltered; a blank value is rejected.",
"pattern": "\\S",
"type": "string"
},
"entered_force_from": {
"description": "Provisions that entered force on/after this date (YYYY-MM-DD) — ministerial_decrees only.",
"pattern": "^\\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\\d|3[01])$",
"type": "string"
},
"entered_force_to": {
"description": "Provisions that entered force on/before this date (YYYY-MM-DD) — ministerial_decrees only.",
"pattern": "^\\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\\d|3[01])$",
"type": "string"
},
"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).",
"pattern": "^\\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\\d|3[01])$",
"type": "string"
},
"issuer": {
"description": "Issuing body — social_insurance (Urheber: a carrier abbreviation such as ÖGK, DVSV, SVS, BVAEB, AUVA, or PVA is expanded to its full designation; a full designation or a \"<ABBR> Gesamtvertrag\" series is sent as written), ministerial_decrees (Bundesministerium) or council_minutes (Einbringer) — a ministry abbreviation such as \"BMF\" is expanded, a full designation is sent as written. Values: ris_list_reference topic issuing_bodies or ministries. Omit to leave unfiltered; a blank value is rejected.",
"pattern": "\\S",
"type": "string"
},
"legislature": {
"description": "Legislative period (Gesetzgebungsperiode, e.g. \"XXVII\") — council_minutes only. Omit to leave unfiltered; a blank value is rejected.",
"pattern": "\\S",
"type": "string"
},
"norm": {
"description": "Cited-provision filter (Norm) — \"DSG §1\", \"DSGVO Art32\" style. veterinary and ministerial_decrees only (\"decrees citing the DSG\"). Omit to leave unfiltered; a blank value is rejected.",
"pattern": "\\S",
"type": "string"
},
"number": {
"description": "Serial number (Avsvnummer / Avnnummer / Spgnummer) — social_insurance, veterinary, health_structure_plans. Omit to leave unfiltered; a blank value is rejected.",
"pattern": "\\S",
"type": "string"
},
"page": {
"description": "1-based result page. Default 1.",
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"page_size": {
"description": "Documents per page: 10 or 20 (default 20). For more results, keep the size and raise page.",
"enum": [
10,
20
],
"type": "number"
},
"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.",
"enum": [
"burgenland",
"kaernten",
"niederoesterreich",
"oberoesterreich",
"salzburg",
"steiermark",
"tirol",
"vorarlberg",
"wien"
],
"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.",
"enum": [
"all",
"expert_opinion",
"regulation"
],
"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).",
"pattern": "^\\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\\d|3[01])$",
"type": "string"
},
"published_to": {
"description": "Latest publication/session date (YYYY-MM-DD).",
"pattern": "^\\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\\d|3[01])$",
"type": "string"
},
"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. Omit to leave unfiltered; a blank value is rejected.",
"pattern": "\\S",
"type": "string"
},
"session_number": {
"description": "Council session number (Sitzungsnummer) — council_minutes only. Omit to leave unfiltered; a blank value is rejected.",
"pattern": "\\S",
"type": "string"
},
"sort_by": {
"description": "Sort column: published or number, where the collection has the column. Default: upstream order.",
"enum": [
"published",
"number"
],
"type": "string"
},
"sort_direction": {
"description": "Sort direction; applies with sort_by.",
"enum": [
"ascending",
"descending"
],
"type": "string"
},
"title": {
"description": "Title search (Titel) — phrase field. Valid for all collections except council_minutes. Omit to leave unfiltered; a blank value is rejected.",
"pattern": "\\S",
"type": "string"
},
"type": {
"description": "Document type (Typ) — trade_exam_rules (Befaehigungspruefungsordnung | Meisterpruefungsordnung), court_rules (Geschaeftsordnung | Geschaeftsverteilung), veterinary (Kundmachungen | VeroeffentlichungenAufGrundVEVO | SonstigeVeroeffentlichungen). Omit to leave unfiltered; a blank value is rejected.",
"pattern": "\\S",
"type": "string"
}
},
"required": [
"collection"
],
"type": "object"
},
"name": "ris_search_announcements",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"results",
"totalCount",
"page",
"pageSize"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `collection_filter_mismatch`: A parameter was combined with a collection that does not accept it — rejected locally before any upstream call; the message names the offending parameter and lists the collection’s valid parameters. Includes changed_since on social_insurance or veterinary, where RIS ignores the recency filter and would return the whole collection; that rejection’s recovery names the replacement calls. `unresolved_ministry`: A ministerial_decrees or council_minutes issuer did not resolve — an abbreviation-shaped value matching no row of the RIS ministries table (the message names the closest matches), a ministry the table lists only for another issuer parameter (the message names the parameters that accept it), or an abbreviation carrying several designations this collection cannot tell apart (the message lists them). Rejected locally before any upstream call; a value the table does not know that contains a space is sent to RIS as written instead. `invalid_query`: A page past the last page of results; or a parameter value rejected locally — a plan_state outside regional health-structure plans, or a sort_by value this collection has no column for, in which case the message names the values it does sort by; or RIS rejecting a value in-band (the Client error message is passed through verbatim, in German, and it does not name the page). `upstream_error`: RIS is unreachable, returned a server error, or served an HTML error page. `upstream_timeout`: RIS did not answer the search within the request deadline. Other values are possible when a failure originates below the handler.",
"examples": [
"collection_filter_mismatch",
"unresolved_ministry",
"invalid_query",
"upstream_error",
"upstream_timeout"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"notice": {
"description": "Zero-hit guidance — names the likely cause and the concrete next call.",
"type": "string"
},
"page": {
"description": "1-based page number RIS served.",
"type": "number"
},
"pageSize": {
"description": "Page size RIS applied.",
"type": "number"
},
"results": {
"description": "Matching documents for the requested page. Totals and paging in enrichment.",
"items": {
"additionalProperties": false,
"description": "One sectoral announcement or executive document.",
"properties": {
"authentic_pdf_url": {
"description": "The amtssigniert authentic PDF (.pdfsig, Authentisch DataType) — the legally binding artifact — where the collection publishes one.",
"type": "string"
},
"binding": {
"description": "Legal binding status: authentic (amtssigniert, legally binding — social insurance, veterinary, court rules, trade-exam rules, health-structure plans), administrative_directive (binds the administration, not citizens — ministerial decrees), or preparatory (council minutes).",
"enum": [
"authentic",
"administrative_directive",
"preparatory"
],
"type": "string"
},
"collection": {
"description": "The collection the record belongs to (the requested collection value).",
"type": "string"
},
"content_urls": {
"additionalProperties": false,
"description": "Rendition URLs of the main document. Court rules publish the authentic PDF only; council minutes are plain PDF only (see authentic_pdf_url).",
"properties": {
"html": {
"description": "HTML rendition URL.",
"type": "string"
},
"pdf": {
"description": "PDF rendition URL (the only rendition for council minutes).",
"type": "string"
},
"rtf": {
"description": "RTF rendition URL.",
"type": "string"
},
"xml": {
"description": "XML rendition URL (RIS Nutzdaten schema).",
"type": "string"
}
},
"type": "object"
},
"document_number": {
"description": "Technical RIS document number (e.g. AVSV_2026_0040, AVN_…, KMGER_…, PRUEF_…, SPG_…, ERL_BMJ_…, MRP_20260701_59) — pass together with the collection’s application to ris_get_document.",
"type": "string"
},
"document_url": {
"description": "RIS web view of the document (DokumentUrl) — for humans. The only browsable surface for council minutes (PDF-only) and ministerial decrees.",
"type": "string"
},
"issuers": {
"description": "Issuing bodies (Urheber / Bundesministerium / Einbringer) — a council minute can carry several. Empty when none.",
"items": {
"description": "One issuing body.",
"type": "string"
},
"type": "array"
},
"norms_cited": {
"description": "Norms the document cites (veterinary notices and decrees) — copy an entry verbatim into a norm filter to find siblings. Empty when none.",
"items": {
"description": "One cited norm in RIS format, e.g. \"DSG §1\".",
"type": "string"
},
"type": "array"
},
"number": {
"description": "Serial number within the collection (Avsvnummer / Avnnummer / Spgnummer), where assigned.",
"type": "string"
},
"published": {
"description": "Promulgation / publication date (Kundmachungsdatum).",
"type": "string"
},
"session_date": {
"description": "Council session date (Sitzungsdatum) — council_minutes only.",
"type": "string"
},
"summary": {
"description": "Short summary (Kurzinformation), where present.",
"type": "string"
},
"title": {
"description": "Full document title, HTML markup stripped.",
"type": "string"
}
},
"required": [
"document_number",
"collection",
"issuers",
"norms_cited",
"binding",
"content_urls"
],
"type": "object"
},
"type": "array"
},
"totalCount": {
"description": "Total matching documents across all pages.",
"type": "number"
},
"truncated": {
"description": "Present and true when more pages exist beyond this one — raise page to continue.",
"type": "boolean"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"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. Omit to leave unfiltered; a blank value is rejected.",
"pattern": "\\S",
"type": "string"
},
"changed_since": {
"description": "Coarse recency filter — decisions changed in RIS within the interval. For exact windows use ris_track_changes.",
"enum": [
"one_week",
"two_weeks",
"one_month",
"three_months",
"six_months",
"one_year"
],
"type": "string"
},
"collection_number": {
"description": "Official collection number (Sammlungsnummer). vfgh, vwgh, and uvs only, and the accepted form differs: vfgh and uvs store the bare number and match it dotted or undotted (\"19632\", \"19.632\"), while vwgh stores the full labelled undotted cite — pass \"VwSlg 18000 A/2010\", or the space-anchored prefix \"VwSlg 18000 *\" when the part letter or year is unknown. A bare or dotted number matches nothing under vwgh. Omit to leave unfiltered; a blank value is rejected.",
"pattern": "\\S",
"type": "string"
},
"commission": {
"description": "Equal-treatment commission (gbk only): federal (Bundes-Gleichbehandlungskommission) or general (Gleichbehandlungskommission).",
"enum": [
"federal",
"general"
],
"type": "string"
},
"court": {
"description": "Which court/tribunal application to search — one per call. Codes, coverage windows, and successor mapping: ris_list_reference topic courts.",
"enum": [
"vfgh",
"vwgh",
"justiz",
"bvwg",
"lvwg",
"dsk",
"normenliste",
"dok",
"pvak",
"gbk",
"uvs",
"asylgh",
"ubas",
"umse",
"bks",
"verg",
"upts"
],
"type": "string"
},
"court_name": {
"description": "Filter within the ordinary courts (justiz only) — \"OGH\", \"OLG Wien\", \"LG Linz\". Omit to leave unfiltered; a blank value is rejected.",
"pattern": "\\S",
"type": "string"
},
"decided_from": {
"description": "Earliest decision date (YYYY-MM-DD). Not available for normenliste.",
"pattern": "^\\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\\d|3[01])$",
"type": "string"
},
"decided_to": {
"description": "Latest decision date (YYYY-MM-DD).",
"pattern": "^\\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\\d|3[01])$",
"type": "string"
},
"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. Omit to leave unfiltered; a blank value is rejected.",
"pattern": "\\S",
"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.",
"enum": [
"headnote",
"full_text",
"all"
],
"type": "string"
},
"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.",
"enum": [
"Alter",
"EthnischeZugehoerigkeit",
"Geschlecht",
"Mehrfachdiskriminierung",
"Religion",
"SexuelleOrientierung",
"Weltanschauung"
],
"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. Omit to leave unfiltered; a blank value is rejected.",
"pattern": "\\S",
"type": "string"
},
"legal_area": {
"description": "Legal area (Rechtsgebiet, justiz only): civil (Zivilrecht) or criminal (Strafrecht).",
"enum": [
"civil",
"criminal"
],
"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. Omit to leave unfiltered; a blank value is rejected.",
"pattern": "\\S",
"type": "string"
},
"page": {
"description": "1-based result page. Default 1.",
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"page_size": {
"description": "Documents per page: 10 or 20 (default 20). For more results, keep the size and raise page.",
"enum": [
10,
20
],
"type": "number"
},
"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\"). Omit to leave unfiltered; a blank value is rejected.",
"pattern": "\\S",
"type": "string"
},
"query": {
"description": "Full-text search over decisions (Suchworte). Boolean UND/ODER/NICHT or AND/OR/NOT, quoted phrases, trailing-only * wildcard. Omit to leave unfiltered; a blank value is rejected.",
"pattern": "\\S",
"type": "string"
},
"senate": {
"description": "Commission senate (gbk only).",
"enum": [
"I",
"II",
"III"
],
"type": "string"
},
"sort_by": {
"description": "Sort column. Default: upstream order. Not available for court: normenliste, which indexes laws rather than decisions.",
"enum": [
"decision_date",
"case_number"
],
"type": "string"
},
"sort_direction": {
"description": "Sort direction; applies with sort_by.",
"enum": [
"ascending",
"descending"
],
"type": "string"
},
"state": {
"description": "Which of the nine state administrative courts/senates to search (lvwg and uvs only).",
"enum": [
"burgenland",
"kaernten",
"niederoesterreich",
"oberoesterreich",
"salzburg",
"steiermark",
"tirol",
"vorarlberg",
"wien"
],
"type": "string"
},
"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. Omit to leave unfiltered; a blank value is rejected.",
"pattern": "\\S",
"type": "string"
},
"subject_law": {
"description": "Media statute the case concerns (Bereich, bks only) — e.g. \"ORF-Gesetz\", \"Privatradiogesetz\". Omit to leave unfiltered; a blank value is rejected.",
"pattern": "\\S",
"type": "string"
}
},
"required": [
"court"
],
"type": "object"
},
"name": "ris_search_case_law",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"results",
"totalCount",
"page",
"pageSize"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `court_filter_mismatch`: A court-conditional filter was sent with the wrong court, or case_number/dates/decision_type were sent with normenliste (a norm index, not decisions) — rejected locally before any upstream call; the message names the offending pair. `invalid_query`: A page past the last page of results, or a parameter value that failed validation — decision_kind/subject_area checked locally against the reference tables, sort_by rejected locally because court normenliste indexes laws rather than decisions, or RIS rejected the value in-band (message passed through verbatim, in German, and it does not name the page). `upstream_error`: RIS is unreachable, returned a server error, or served an HTML error page. `upstream_timeout`: RIS did not answer the search within the request deadline. Other values are possible when a failure originates below the handler.",
"examples": [
"court_filter_mismatch",
"invalid_query",
"upstream_error",
"upstream_timeout"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"notice": {
"description": "Zero-hit guidance — names the likely cause and the concrete next call.",
"type": "string"
},
"page": {
"description": "1-based page number RIS served.",
"type": "number"
},
"pageSize": {
"description": "Page size RIS applied.",
"type": "number"
},
"results": {
"description": "Matching documents for the requested page — decisions, or indexed laws under court normenliste. Totals and paging in enrichment.",
"items": {
"additionalProperties": false,
"description": "One document from the selected court — a decision (headnote or full text), or, under court normenliste, one law of the VwGH norm index (see norm_index).",
"properties": {
"case_numbers": {
"description": "Case numbers (Geschäftszahl) — a decision can carry several.",
"items": {
"description": "One Geschäftszahl.",
"type": "string"
},
"type": "array"
},
"collection_number": {
"description": "Official collection number (VfSlg/VwSlg/UVS Sammlungsnummer), where assigned.",
"type": "string"
},
"content_urls": {
"additionalProperties": false,
"description": "Rendition URLs of the main document.",
"properties": {
"html": {
"description": "HTML rendition URL.",
"type": "string"
},
"pdf": {
"description": "PDF rendition URL (the only rendition for upts).",
"type": "string"
},
"rtf": {
"description": "RTF rendition URL.",
"type": "string"
},
"xml": {
"description": "XML rendition URL.",
"type": "string"
}
},
"type": "object"
},
"court": {
"description": "RIS application code of the deciding body (e.g. Vfgh, Justiz, Upts) — use as the application argument of ris_get_document.",
"type": "string"
},
"decision_date": {
"description": "Decision date (Entscheidungsdatum).",
"type": "string"
},
"decision_kind": {
"description": "Decision kind (Entscheidungsart — Erkenntnis, Beschluss, …), where tagged.",
"type": "string"
},
"decision_type": {
"description": "Document kind: 'Rechtssatz' (headnote) or 'Text' (full decision text). One decision may appear as several headnote documents plus one text document sharing a Geschäftszahl.",
"type": "string"
},
"decision_url": {
"description": "RIS web view of the complete decision (GesamteEntscheidungUrl).",
"type": "string"
},
"document_number": {
"description": "Technical RIS document number (e.g. JFT_…, DSBT_20251114_…, UPTS_…) — pass together with the court value (as application) to ris_get_document.",
"type": "string"
},
"ecli": {
"description": "European Case Law Identifier, where assigned.",
"type": "string"
},
"guiding_principle": {
"description": "Guiding legal principle / headnote (Leitsatz) — the abstracted rule the decision establishes. Present chiefly on Rechtssatz (headnote) documents, mostly VfGH.",
"type": "string"
},
"headnotes_url": {
"description": "RIS web view of the decision’s headnotes (RechtssaetzeUrl).",
"type": "string"
},
"indexes": {
"description": "Systematik classification entries (Indizes) — the same taxonomy ris_search_legislation filters on, so an entry copied here finds the consolidated law around the decision. Carried by vfgh, vwgh, lvwg, uvs, umse, and normenliste; empty for the rest.",
"items": {
"description": "One Systematik index entry, e.g. \"10/10 Datenschutz\".",
"type": "string"
},
"type": "array"
},
"keywords": {
"description": "Keywords (Schlagworte), where present.",
"type": "string"
},
"legal_force_note": {
"description": "Challenge / legal-force note (Anfechtung), where present.",
"type": "string"
},
"norm_index": {
"additionalProperties": false,
"description": "The law this record indexes. Present only for court normenliste (the VwGH norm index); absent for the sixteen deciding courts, whose records describe a decision instead.",
"properties": {
"abbreviation": {
"description": "Citable short form the VwGH uses for the law, e.g. \"DSG 2000\", \"HlG 1989\", \"KFGNov 21te\".",
"type": "string"
},
"reference": {
"description": "Promulgation reference of the law (Fundstelle), e.g. \"BGBl I 165/1999\" — resolve it with ris_search_gazette or ris_lookup_citation.",
"type": "string"
},
"title": {
"description": "Full title of the law as the index records it (Titel) — often several lines, carrying the parliamentary references and originating gazette.",
"type": "string"
},
"type": {
"description": "Norm type code (BG, V, K, …) — glossary: ris_list_reference topic law_types.",
"type": "string"
}
},
"type": "object"
},
"norms_cited": {
"description": "Norms the decision cites — copy an entry verbatim into the norm filter to find sibling case law.",
"items": {
"description": "One cited norm in RIS format, e.g. \"DSG §1\".",
"type": "string"
},
"type": "array"
},
"note": {
"description": "Annotation (Anmerkung) — a renaming or lifecycle note on a normenliste law, an editorial note on a justiz or dsk decision.",
"type": "string"
},
"organ": {
"description": "Issuing body name (Organ), e.g. \"Verfassungsgerichtshof\".",
"type": "string"
},
"party": {
"description": "Political party the decision concerns (upts decisions only).",
"type": "string"
},
"state": {
"description": "Bundesland whose administrative court decided (lvwg and uvs records) — the German name, e.g. \"Tirol\".",
"type": "string"
},
"summary": {
"description": "Short summary (Kurzinformation), where present.",
"type": "string"
}
},
"required": [
"document_number",
"court",
"case_numbers",
"norms_cited",
"indexes",
"content_urls"
],
"type": "object"
},
"type": "array"
},
"totalCount": {
"description": "Total matching documents across all pages.",
"type": "number"
},
"truncated": {
"description": "Present and true when more pages exist beyond this one — raise page to continue.",
"type": "boolean"
}
},
"type": "object"
}
},
{
"description": "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 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. Each record carries materials — the companion documents filed with the draft (Erläuterungen, Textgegenüberstellung, Vorblatt/WFA, covering letter, annexes); the Erläuterungen carry the drafting reasoning the bill text omits, and passing a materials[].url to ris_get_document as document_url is the only way to read one (format there picks the rendition returned). Documents are preparatory, not binding law. Ministry codes: ris_list_reference topic ministries.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"changed_since": {
"description": "Coarse recency filter — documents changed in RIS within the interval. For exact windows use ris_track_changes.",
"enum": [
"one_week",
"two_weeks",
"one_month",
"three_months",
"six_months",
"one_year"
],
"type": "string"
},
"decided_from": {
"description": "government_bills only. Earliest council-of-ministers adoption date (YYYY-MM-DD).",
"pattern": "^\\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\\d|3[01])$",
"type": "string"
},
"decided_to": {
"description": "government_bills only. Latest adoption date (YYYY-MM-DD).",
"pattern": "^\\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\\d|3[01])$",
"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.",
"pattern": "^\\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\\d|3[01])$",
"type": "string"
},
"ministry": {
"description": "Submitting ministry (EinbringendeStelle). Accepts an abbreviation (\"BMF\", \"BMWET\") or a full designation; use the ministry’s name at the time of submission. An abbreviation missing from the table is rejected; a full designation missing from it is sent as written. Table: ris_list_reference topic ministries. Omit to leave unfiltered; a blank value is rejected.",
"pattern": "\\S",
"type": "string"
},
"page": {
"description": "1-based result page. Default 1.",
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"page_size": {
"description": "Documents per page: 10 or 20 (default 20). For more results, keep the size and raise page.",
"enum": [
10,
20
],
"type": "number"
},
"query": {
"description": "Full-text search (Suchworte). Boolean operators UND/ODER/NICHT or AND/OR/NOT, parentheses, quoted phrases; wildcard * is trailing-only. Omit to leave unfiltered; a blank value is rejected.",
"pattern": "\\S",
"type": "string"
},
"sort_by": {
"description": "Sort column: date (review deadline or adoption date per stage), ministry, or title. Default: upstream order.",
"enum": [
"date",
"ministry",
"title"
],
"type": "string"
},
"sort_direction": {
"description": "Sort direction; applies with sort_by.",
"enum": [
"ascending",
"descending"
],
"type": "string"
},
"stage": {
"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.",
"enum": [
"review_drafts",
"government_bills"
],
"type": "string"
},
"title": {
"description": "Title search (Titel) — phrase field: * allowed leading or trailing with ≥2 characters beside it. Omit to leave unfiltered; a blank value is rejected.",
"pattern": "\\S",
"type": "string"
}
},
"required": [
"stage"
],
"type": "object"
},
"name": "ris_search_drafts",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"results",
"totalCount",
"page",
"pageSize"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `stage_filter_mismatch`: in_review_on was combined with stage: government_bills, or decided_from/to with stage: review_drafts — rejected locally before any upstream call; the message names the offending pair. `unresolved_ministry`: ministry is an abbreviation-shaped value matching no row of the RIS ministries table (the message names the closest matches), or a ministry the table lists only for another issuer parameter (the message names the parameters that accept it) — rejected locally before any upstream call. A value the table does not know that contains a space is sent to RIS as written instead. `invalid_query`: A page past the last page of results; or RIS rejecting a value in-band (the Client error message is passed through verbatim, in German, and it does not name the page). `upstream_error`: RIS is unreachable, returned a server error, or served an HTML error page. `upstream_timeout`: RIS did not answer the search within the request deadline. Other values are possible when a failure originates below the handler.",
"examples": [
"stage_filter_mismatch",
"unresolved_ministry",
"invalid_query",
"upstream_error",
"upstream_timeout"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"notice": {
"description": "Zero-hit guidance — names the likely cause and the concrete next call.",
"type": "string"
},
"page": {
"description": "1-based page number RIS served.",
"type": "number"
},
"pageSize": {
"description": "Page size RIS applied.",
"type": "number"
},
"results": {
"description": "Matching pipeline documents for the requested page. Totals and paging in enrichment.",
"items": {
"additionalProperties": false,
"description": "One pipeline document — a review draft or a government bill.",
"properties": {
"content_urls": {
"additionalProperties": false,
"description": "Rendition URLs of the main document (companion documents ride in materials).",
"properties": {
"html": {
"description": "HTML rendition URL.",
"type": "string"
},
"pdf": {
"description": "PDF rendition URL.",
"type": "string"
},
"rtf": {
"description": "RTF rendition URL.",
"type": "string"
},
"xml": {
"description": "XML rendition URL (RIS Nutzdaten schema).",
"type": "string"
}
},
"type": "object"
},
"decided": {
"description": "Council-of-ministers adoption date (Beschlussdatum) — government_bills only.",
"type": "string"
},
"document_number": {
"description": "Technical RIS document number (BEGUT_… or REGV_-prefixed) — pass together with the stage’s application to ris_get_document.",
"type": "string"
},
"document_url": {
"description": "RIS web view of the draft document (DokumentUrl) — for humans.",
"type": "string"
},
"materials": {
"description": "Companion documents filed with the draft — the Erläuterungen (explanatory notes, carrying the reasoning the bill text omits), Textgegenüberstellung (redline against the current law), Vorblatt/WFA (impact assessment), the covering letter, and any annexes. Read one by passing its url to ris_get_document as document_url. Empty when the ministry filed none; coverage is uneven by design.",
"items": {
"additionalProperties": false,
"description": "One companion document filed alongside the draft.",
"properties": {
"name": {
"description": "RIS-supplied label, as filed. Unstable across records — the same content appears as \"Vorblatt und WFA\", \"Vorblatt+WFA\", or \"WFA\"; \"Textgegenüberstellung\" or \"TGÜ\". Read type, not this, to classify.",
"type": "string"
},
"type": {
"description": "Content type — Material (Erläuterungen, Textgegenüberstellung, Vorblatt/WFA), Letter (the Begleitschreiben covering the review draft), or Attachment (annex texts, e.g. treaty translations). The reliable discriminator: name is free text and varies per record.",
"type": "string"
},
"url": {
"description": "One rendition URL for this companion — its HTML rendition, or its PDF where RIS files no HTML one (roughly one companion in eight, nearly all of them review-draft covering letters). Pass it to ris_get_document as document_url: the extension is discarded there and format selects what comes back (markdown, html, or the RIS Nutzdaten xml of this companion, plus the companion’s own rendition URLs under urls_only), so this one URL reaches every text rendition the companion has. A PDF-only companion has none, and the URL is a direct download. The filename is opaque and per-record, so no document number reaches it.",
"type": "string"
}
},
"required": [
"type",
"url"
],
"type": "object"
},
"type": "array"
},
"ministry": {
"description": "Submitting ministry (EinbringendeStelle / Organ), where the record carries one.",
"type": "string"
},
"review_deadline": {
"description": "End of the public review window (Ende der Begutachtungsfrist) — review_drafts only.",
"type": "string"
},
"short_title": {
"description": "Short title (Kurztitel), where assigned.",
"type": "string"
},
"stage": {
"description": "Pipeline stage the record belongs to: review_drafts (Begut) or government_bills (RegV).",
"type": "string"
},
"title": {
"description": "Full document title, HTML markup stripped.",
"type": "string"
}
},
"required": [
"document_number",
"stage",
"materials",
"content_urls"
],
"type": "object"
},
"type": "array"
},
"totalCount": {
"description": "Total matching documents across all pages.",
"type": "number"
},
"truncated": {
"description": "Present and true when more pages exist beyond this one — raise page to continue.",
"type": "boolean"
}
},
"type": "object"
}
},
{
"description": "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 call serves one tier, so a published_from/published_to interval crossing 2004-01-01 or 1945-01-01 is rejected with the boundaries to split at, and RIS carries no federal gazette for 1941–1944), 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 state_era picks which era of that series to search: current (the default → the authentic LGBl) or legacy (the state’s earlier non-authentic series — Niederösterreich’s systematic LgblNO, or the older Lgbl elsewhere; Wien carries neither, and ordinance gazettes have no legacy series). 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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"district_authority": {
"description": "District only. Bezirksverwaltungsbehörde name, e.g. \"Bezirkshauptmannschaft Liezen\" — full list: ris_list_reference topic district_authorities. Omit to leave unfiltered; a blank value is rejected.",
"pattern": "\\S",
"type": "string"
},
"issuer": {
"description": "Issuing body — federal (EinbringendeStelle: a ministry abbreviation such as \"BMF\" or a full designation; an abbreviation missing from ris_list_reference topic ministries is rejected, a full designation missing from it is sent as written) or ordinance gazettes (Vbl Einbringer, exact match with no wildcards: Landeshauptmann/frau, Landesregierung, Amt der Landesregierung, Sonstige Landesbehörden) only. Omit to leave unfiltered; a blank value is rejected.",
"pattern": "\\S",
"type": "string"
},
"municipality": {
"description": "Municipal only. Exact municipality name (Gemeinde), RIS’s spelling. Omit to leave unfiltered; a blank value is rejected.",
"pattern": "\\S",
"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. Omit to leave unfiltered; a blank value is rejected.",
"pattern": "\\S",
"type": "string"
},
"page": {
"description": "1-based result page. Default 1.",
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"page_size": {
"description": "Documents per page: 10 or 20 (default 20). For more results, keep the size and raise page.",
"enum": [
10,
20
],
"type": "number"
},
"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.",
"enum": [
"part1",
"part2",
"part3",
"pre_1997"
],
"type": "string"
},
"published_from": {
"description": "Earliest promulgation date (YYYY-MM-DD). A pre-2004 range routes a federal query to an earlier era tier. Federal: the interval must stay inside one tier — set published_to as well, since a one-sided bound is open into every tier beyond it.",
"pattern": "^\\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\\d|3[01])$",
"type": "string"
},
"published_to": {
"description": "Latest promulgation date (YYYY-MM-DD). Federal: the interval must stay inside one era tier, so pair it with published_from — an interval crossing 2004-01-01 or 1945-01-01 is rejected with the boundaries to split at.",
"pattern": "^\\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\\d|3[01])$",
"type": "string"
},
"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. Omit to leave unfiltered; a blank value is rejected.",
"pattern": "\\S",
"type": "string"
},
"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).",
"enum": [
"federal",
"burgenland",
"kaernten",
"niederoesterreich",
"oberoesterreich",
"salzburg",
"steiermark",
"tirol",
"vorarlberg",
"wien",
"district",
"municipal"
],
"type": "string"
},
"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+).",
"enum": [
"law_gazette",
"ordinance_gazette"
],
"type": "string"
},
"sort_by": {
"description": "Sort column: published (Kundmachungsdatum) or number. Availability varies by tier; default: upstream order.",
"enum": [
"published",
"number"
],
"type": "string"
},
"sort_direction": {
"description": "Sort direction; applies with sort_by.",
"enum": [
"ascending",
"descending"
],
"type": "string"
},
"state_era": {
"description": "State scopes only. current (default when omitted) searches the authentic Landesgesetzblatt; legacy searches the state’s earlier non-authentic series — Niederösterreich’s systematic LgblNO collection, or the historical Lgbl for the other Bundesländer (Wien carries neither).",
"enum": [
"current",
"legacy"
],
"type": "string"
},
"title": {
"description": "Title search (Titel) — phrase field: * allowed leading or trailing with ≥2 characters beside it. Omit to leave unfiltered; a blank value is rejected.",
"pattern": "\\S",
"type": "string"
},
"type": {
"description": "Document-type filter (Typ) for federal and state law gazettes: laws (Gesetze) | regulations (Verordnungen) | announcements (Kundmachungen) | other (Sonstiges).",
"enum": [
"laws",
"regulations",
"announcements",
"other"
],
"type": "string"
}
},
"type": "object"
},
"name": "ris_search_gazette",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"results",
"totalCount",
"page",
"pageSize",
"servedApplication"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `scope_filter_mismatch`: A filter was combined with a scope that does not support it (part off federal; series/state_era off a state scope; district_authority off district; municipality off municipal; issuer outside federal/ordinance gazettes), or series: ordinance_gazette was combined with state_era: legacy (ordinance gazettes have no legacy counterpart) — rejected locally before any upstream call; the message names the offending pair. `cross_tier_range`: A federal published_from/published_to interval overlaps more than one Bundesgesetzblatt era tier (BgblAuth 2004+, BgblPdf 1945–2003, BgblAlt 1848–1940) — including a one-sided bound, which is open into every tier beyond it. Rejected locally before any upstream call: one call serves exactly one application, so a spanning range would return the records of a single tier and silently omit the rest of the interval. A year-bearing number or part: pre_1997 names the tier outright and is never rejected. `unresolved_ministry`: A federal issuer is an abbreviation-shaped value matching no row of the RIS ministries table (the message names the closest matches), or a ministry the table lists only for another issuer parameter (the message names the parameters that accept it) — rejected locally before any upstream call. A value the table does not know that contains a space is sent to RIS as written instead. `invalid_query`: A page past the last page of results; or a parameter the resolved gazette does not carry — sort_by, number, type, part, issuer, or a state absent from the historical Lgbl series — rejected locally before any upstream call, naming the field and the gazette that rejected it (by scope/series/state_era, or for a federal era tier by its window and the input that routed there); or RIS rejecting a value in-band (the Client error message is passed through verbatim, in German, and it does not name the page). `upstream_error`: RIS is unreachable, returned a server error, or served an HTML error page. `upstream_timeout`: RIS did not answer the search within the request deadline. Other values are possible when a failure originates below the handler.",
"examples": [
"scope_filter_mismatch",
"cross_tier_range",
"unresolved_ministry",
"invalid_query",
"upstream_error",
"upstream_timeout"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"notice": {
"description": "Zero-hit guidance — names the likely cause and the concrete next call.",
"type": "string"
},
"page": {
"description": "1-based page number RIS served.",
"type": "number"
},
"pageSize": {
"description": "Page size RIS applied.",
"type": "number"
},
"results": {
"description": "Matching gazette entries for the requested page. Totals, paging, and the served application in enrichment.",
"items": {
"additionalProperties": false,
"description": "One gazette entry from the resolved application.",
"properties": {
"alex_url": {
"description": "ÖNB ALEX scan of the gazette issue (AlexUrl) — the fetchable document for the metadata-only imperial/interwar tier (BgblAlt, 1848–1940), which carries no content_urls.",
"type": "string"
},
"authentic_pdf_url": {
"description": "The amtssigniert authentic PDF (.pdfsig, Authentisch DataType) — the legally binding artifact — where the gazette publishes one.",
"type": "string"
},
"binding": {
"description": "Legal binding status: authentic (amtssigniert, legally binding — BgblAuth/LgblAuth/Vbl/Bvb/GrA), historical_record (superseded/pre-e-Recht promulgation — BgblPdf/BgblAlt/Lgbl), or consolidated_informational (NÖ systematic collection — LgblNO).",
"enum": [
"authentic",
"consolidated_informational",
"historical_record"
],
"type": "string"
},
"content_urls": {
"additionalProperties": false,
"description": "Rendition URLs of the main document. BgblAlt carries none (metadata-only, ÖNB scans); district/municipal gazettes publish the authentic PDF only (see authentic_pdf_url).",
"properties": {
"html": {
"description": "HTML rendition URL.",
"type": "string"
},
"pdf": {
"description": "PDF rendition URL.",
"type": "string"
},
"rtf": {
"description": "RTF rendition URL.",
"type": "string"
},
"xml": {
"description": "XML rendition URL (RIS Nutzdaten schema).",
"type": "string"
}
},
"type": "object"
},
"district_authority": {
"description": "District administrative authority (Bezirksverwaltungsbehörde) — district gazettes only.",
"type": "string"
},
"document_number": {
"description": "Technical RIS document number (e.g. BGBLA_2026_II_171, 1961_194_0, rgb1902_…, LGBLA_SA_…, VBL_TI_…, BVB_ST_…, GEMREA_OB_…) — pass together with the served application to ris_get_document.",
"type": "string"
},
"document_url": {
"description": "RIS web view of the gazette document (DokumentUrl) — for humans.",
"type": "string"
},
"eli": {
"description": "European Legislation Identifier, where assigned (federal coverage is best).",
"type": "string"
},
"gazette_number": {
"description": "Gazette number (Bgblnummer / Lgblnummer / Kundmachungsnummer / BgblAlt Fundstelle), where assigned.",
"type": "string"
},
"issuer": {
"description": "Issuing body (Einbringer / Organ), where the record carries one.",
"type": "string"
},
"municipality": {
"description": "Municipality the promulgation belongs to (Gemeinde) — municipal gazettes only.",
"type": "string"
},
"part": {
"description": "Federal gazette part (Teil — I / II / III), where the tier carries a part split.",
"type": "string"
},
"published": {
"description": "Promulgation / publication date (Kundmachungsdatum / Ausgabedatum).",
"type": "string"
},
"short_title": {
"description": "Short title (Kurztitel), where assigned.",
"type": "string"
},
"title": {
"description": "Full document title, HTML markup stripped.",
"type": "string"
},
"type": {
"description": "Norm/document type (Typ — Gesetz, Verordnung, …) — glossary: ris_list_reference topic law_types.",
"type": "string"
}
},
"required": [
"document_number",
"binding",
"content_urls"
],
"type": "object"
},
"type": "array"
},
"servedApplication": {
"description": "The RIS application that served the query — for federal, the single era tier auto-routed from the number’s year or the publication-date interval (BgblAuth 2004+, BgblPdf 1945–2003, BgblAlt 1848–1940); otherwise the resolved state/district/municipal application.",
"type": "string"
},
"totalCount": {
"description": "Total matching entries across all pages.",
"type": "number"
},
"truncated": {
"description": "Present and true when more pages exist beyond this one — raise page to continue.",
"type": "boolean"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"changed_since": {
"description": "Coarse recency filter — documents changed in RIS within the interval. For exact windows and deletions use ris_track_changes.",
"enum": [
"one_week",
"two_weeks",
"one_month",
"three_months",
"six_months",
"one_year"
],
"type": "string"
},
"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.",
"pattern": "^\\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\\d|3[01])$",
"type": "string"
},
"entered_force_to": {
"description": "Provisions that entered force on/before this date (YYYY-MM-DD).",
"pattern": "^\\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\\d|3[01])$",
"type": "string"
},
"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.",
"pattern": "^\\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\\d|3[01])$",
"type": "string"
},
"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"
},
"index": {
"description": "Systematik classification filter (e.g. \"10/10 Datenschutz\"). Federal/state consolidated law only. Omit to leave unfiltered; a blank value is rejected.",
"pattern": "\\S",
"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).",
"enum": [
"german",
"english"
],
"type": "string"
},
"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. Omit to leave unfiltered; a blank value is rejected.",
"pattern": "\\S",
"type": "string"
},
"left_force_from": {
"description": "Provisions that left force on/after this date (YYYY-MM-DD) — repeal tracking. Same exclusivity as entered_force_from.",
"pattern": "^\\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\\d|3[01])$",
"type": "string"
},
"left_force_to": {
"description": "Provisions that left force on/before this date (YYYY-MM-DD).",
"pattern": "^\\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\\d|3[01])$",
"type": "string"
},
"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). Omit to search consolidated law; a blank value is rejected.",
"pattern": "\\S",
"type": "string"
},
"page": {
"description": "1-based result page. Default 1.",
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"page_size": {
"description": "Documents per page: 10 or 20 (default 20). For more results, keep the size and raise page.",
"enum": [
10,
20
],
"type": "number"
},
"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. Omit to leave unfiltered; a blank value is rejected.",
"pattern": "\\S",
"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).",
"enum": [
"federal",
"burgenland",
"kaernten",
"niederoesterreich",
"oberoesterreich",
"salzburg",
"steiermark",
"tirol",
"vorarlberg",
"wien"
],
"type": "string"
},
"section_from": {
"description": "Start of a § / Artikel / Anlage number range, digits with optional letter (\"6\", \"1a\"). Federal/state consolidated law only. Omit to leave unfiltered; a blank value is rejected.",
"pattern": "\\S",
"type": "string"
},
"section_to": {
"description": "End of the section range. Equal to section_from for a single section. Omit to leave unfiltered; a blank value is rejected.",
"pattern": "\\S",
"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.",
"enum": [
"Alle",
"Artikel",
"Paragraph",
"Anlage"
],
"type": "string"
},
"sort_by": {
"description": "Sort column: section (§/Artikel/Anlage label) or in_force_date. Default: upstream order. Federal/state consolidated law only.",
"enum": [
"section",
"in_force_date"
],
"type": "string"
},
"sort_direction": {
"description": "Sort direction; applies with sort_by.",
"enum": [
"ascending",
"descending"
],
"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. Omit to leave unfiltered; a blank value is rejected.",
"pattern": "\\S",
"type": "string"
}
},
"type": "object"
},
"name": "ris_search_legislation",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"results",
"totalCount",
"page",
"pageSize"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"appliedInForceAsOf": {
"description": "The in-force date the server actually applied (defaulted to today in Austria when omitted). Absent when include_all_versions, a force-window, or language: english searched without a date filter.",
"type": "string"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `scope_filter_mismatch`: A filter was combined with a scope, municipality, or language that does not support it, or mutually exclusive version filters were combined — rejected locally before any upstream call; the message names the offending pair. `invalid_query`: A page past the last page of results, or RIS rejecting a parameter value in-band — the Client error message is passed through verbatim, in German. It names the invalid element and its valid values, except for a page past the end, which names no parameter at all. Unsupported filter combinations are caught earlier as scope_filter_mismatch. `upstream_error`: RIS is unreachable, returned a server error, or served an HTML error page. `upstream_timeout`: RIS did not answer the search within the request deadline. Other values are possible when a failure originates below the handler.",
"examples": [
"scope_filter_mismatch",
"invalid_query",
"upstream_error",
"upstream_timeout"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"notice": {
"description": "Zero-hit guidance — names the likely cause and the concrete next call.",
"type": "string"
},
"page": {
"description": "1-based page number RIS served.",
"type": "number"
},
"pageSize": {
"description": "Page size RIS applied.",
"type": "number"
},
"results": {
"description": "Matching documents for the requested page. Totals and paging in enrichment.",
"items": {
"additionalProperties": false,
"description": "One consolidated-law document — one § / Artikel / Anlage — or one translation.",
"properties": {
"abbreviation": {
"description": "Official abbreviation, where the record carries one.",
"type": "string"
},
"application": {
"description": "RIS application the record belongs to: BrKons (federal), LrKons (state), Gr (municipal), or Erv (English translation).",
"type": "string"
},
"celex_references": {
"description": "CELEX numbers parsed from the record — the EU-transposition hook for eur-lex chaining. Empty when none.",
"items": {
"description": "One CELEX number of a transposed EU act.",
"type": "string"
},
"type": "array"
},
"content_urls": {
"additionalProperties": false,
"description": "Rendition URLs of the main document. Municipal and translation hits may be sparse.",
"properties": {
"html": {
"description": "HTML rendition URL.",
"type": "string"
},
"pdf": {
"description": "PDF rendition URL.",
"type": "string"
},
"rtf": {
"description": "RTF rendition URL.",
"type": "string"
},
"xml": {
"description": "XML rendition URL (RIS Nutzdaten schema).",
"type": "string"
}
},
"type": "object"
},
"document_number": {
"description": "Technical RIS document number (e.g. NOR40262691, GEMRE_WI_…, ERV_1999_1_165) — pass together with application to ris_get_document.",
"type": "string"
},
"eli": {
"description": "European Legislation Identifier, where assigned (federal coverage is best).",
"type": "string"
},
"in_force_from": {
"description": "Date this version entered force (Inkrafttretensdatum).",
"type": "string"
},
"in_force_until": {
"description": "Date this version left force (Ausserkrafttretensdatum). Absent while in force.",
"type": "string"
},
"indexes": {
"description": "Systematik classification entries (Index). Empty when unclassified.",
"items": {
"description": "One Systematik index entry, e.g. \"10/10 Datenschutz\".",
"type": "string"
},
"type": "array"
},
"law_id": {
"description": "Law-level grouping key (Gesetzesnummer) — filter by law_id to fetch every section of the same law.",
"type": "string"
},
"law_url": {
"description": "RIS web view of the whole law (GesamteRechtsvorschriftUrl) — for humans.",
"type": "string"
},
"municipality": {
"description": "Municipality the norm belongs to (municipal law only).",
"type": "string"
},
"promulgation": {
"description": "Promulgation reference (Kundmachungsorgan), e.g. \"BGBl. I Nr. 165/1999\".",
"type": "string"
},
"section_label": {
"description": "§ / Artikel / Anlage label of this document (ArtikelParagraphAnlage).",
"type": "string"
},
"short_title": {
"description": "Short title (Kurztitel), where assigned.",
"type": "string"
},
"title": {
"description": "Full document title, HTML markup stripped.",
"type": "string"
},
"translation": {
"additionalProperties": false,
"description": "Provenance of an unofficial English translation. Present only on Erv records (language: english), which carry no in_force_from, promulgation, or eli of their own — this is the only statement of which German version the text corresponds to, and how old it is.",
"properties": {
"author": {
"description": "Body that produced the translation, e.g. \"Federal Chancellery\".",
"type": "string"
},
"source": {
"description": "Which German version this translation renders, as RIS states it — the originating gazette, the last amendment applied, and the date of the version, one per line.",
"type": "string"
}
},
"type": "object"
},
"type": {
"description": "Norm type code (BG, V, K, …) — glossary: ris_list_reference topic law_types.",
"type": "string"
}
},
"required": [
"document_number",
"application",
"indexes",
"celex_references",
"content_urls"
],
"type": "object"
},
"type": "array"
},
"totalCount": {
"description": "Total matching documents across all pages.",
"type": "number"
},
"truncated": {
"description": "Present and true when more pages exist beyond this one — raise page to continue.",
"type": "boolean"
}
},
"type": "object"
}
},
{
"description": "Track every document added or changed in one RIS application within an exact date window (changed_from/changed_to), 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 accepts every RIS application code listed by ris_list_reference topic applications, including BrKons, LrKons, Dsk, and BgblAuth. 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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"application": {
"description": "RIS application whose change feed to read, e.g. BrKons, LrKons, Dsk, or BgblAuth. All supported codes: ris_list_reference topic applications.",
"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"
],
"type": "string"
},
"changed_from": {
"description": "Include documents changed on/after this date (YYYY-MM-DD, AenderungenVon). Exact date, not a coarse interval.",
"pattern": "^\\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\\d|3[01])$",
"type": "string"
},
"changed_to": {
"description": "Include documents changed on/before this date (YYYY-MM-DD, AenderungenBis).",
"pattern": "^\\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\\d|3[01])$",
"type": "string"
},
"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.",
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"page_size": {
"description": "Documents per page: 10 or 20 (default 20). For more results, keep the size and raise page.",
"enum": [
10,
20
],
"type": "number"
}
},
"required": [
"application"
],
"type": "object"
},
"name": "ris_track_changes",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"results",
"totalCount",
"page",
"pageSize",
"application"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"application": {
"description": "The application whose change feed was read.",
"type": "string"
},
"changedFrom": {
"description": "The changed_from bound the server applied (echo), when set.",
"type": "string"
},
"changedTo": {
"description": "The changed_to bound the server applied (echo), when set.",
"type": "string"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `invalid_query`: RIS rejected a parameter value in-band — its Client error message is passed through verbatim and names the offending element (e.g. a page past the last page of the change window). `upstream_error`: RIS is unreachable, returned a server error, or served an HTML error page. `upstream_timeout`: RIS did not answer the change feed within the request deadline. Other values are possible when a failure originates below the handler.",
"examples": [
"invalid_query",
"upstream_error",
"upstream_timeout"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"notice": {
"description": "Zero-hit guidance — names the likely cause and the concrete next call.",
"type": "string"
},
"page": {
"description": "1-based page number RIS served.",
"type": "number"
},
"pageSize": {
"description": "Page size RIS applied.",
"type": "number"
},
"results": {
"description": "Change-feed entries for the requested page. Totals, paging, and the applied window in enrichment.",
"items": {
"additionalProperties": false,
"description": "One change-feed entry — a changed document, or a deletion record.",
"properties": {
"authentic_pdf_url": {
"description": "The amtssigniert authentic PDF (.pdfsig, Authentisch DataType), where the changed document publishes one.",
"type": "string"
},
"binding_status": {
"description": "Legal binding status of the queried application — authentic (amtssigniert, legally binding), consolidated_informational, historical_record, decision, preparatory, administrative_directive, or translation.",
"enum": [
"authentic",
"consolidated_informational",
"historical_record",
"decision",
"preparatory",
"administrative_directive",
"translation"
],
"type": "string"
},
"changed": {
"description": "Date this document last changed in RIS (Allgemein.Geaendert).",
"type": "string"
},
"content_urls": {
"additionalProperties": false,
"description": "Rendition URLs of the changed document. Empty for a deletion record.",
"properties": {
"html": {
"description": "HTML rendition URL.",
"type": "string"
},
"pdf": {
"description": "PDF rendition URL.",
"type": "string"
},
"rtf": {
"description": "RTF rendition URL.",
"type": "string"
},
"xml": {
"description": "XML rendition URL (RIS Nutzdaten schema).",
"type": "string"
}
},
"type": "object"
},
"deleted": {
"description": "True when this record marks a document removed from RIS (include_deleted only).",
"type": "boolean"
},
"deleted_at": {
"description": "Deletion import timestamp (ImportTimestamp) — deletion records only.",
"type": "string"
},
"document_number": {
"description": "Technical RIS document number (Technisch.ID) — pass with application to ris_get_document.",
"type": "string"
},
"document_url": {
"description": "RIS web view of the document (Allgemein.DokumentUrl) — for humans.",
"type": "string"
},
"organ": {
"description": "Issuing body (Organ) of the document, where the record carries one.",
"type": "string"
},
"published": {
"description": "Date this document was first published in RIS (Allgemein.Veroeffentlicht).",
"type": "string"
},
"short_title": {
"description": "Short title (Kurztitel), where assigned.",
"type": "string"
},
"title": {
"description": "Document title, HTML markup stripped, where present.",
"type": "string"
}
},
"required": [
"document_number",
"binding_status",
"deleted",
"content_urls"
],
"type": "object"
},
"type": "array"
},
"totalCount": {
"description": "Total change-feed entries across all pages.",
"type": "number"
},
"truncated": {
"description": "Present and true when more pages exist beyond this one — raise page to continue.",
"type": "boolean"
}
},
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:e245d2e8bccddeca51fc85b8ccded8df643094769ec0daf9701290861a4be6fc | sha256sum