@cyanheads/ris-austria-mcp-server 0.1.5

package/LICENSE

@@ -0,0 +1,201 @@
+Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2025 Casey Hand @cyanheads
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,309 @@
+<div align="center">
+  <h1>@cyanheads/ris-austria-mcp-server</h1>
+  <p><b>Search Austrian law at every level — consolidated federal, state & municipal norms, court decisions, the authentic gazettes, the lawmaking pipeline, and ministerial decrees — from the official RIS via MCP. Keyless. STDIO or Streamable HTTP.</b>
+  <div>9 Tools • 1 Resource</div>
+  </p>
+</div>
+
+<div align="center">
+
+[![Version](https://img.shields.io/badge/Version-0.1.5-blue.svg?style=flat-square)](./CHANGELOG.md) [![License](https://img.shields.io/badge/License-Apache%202.0-orange.svg?style=flat-square)](./LICENSE) [![Docker](https://img.shields.io/badge/Docker-ghcr.io-2496ED?style=flat-square&logo=docker&logoColor=white)](https://github.com/users/cyanheads/packages/container/package/ris-austria-mcp-server) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-^1.29.0-green.svg?style=flat-square)](https://modelcontextprotocol.io/) [![npm](https://img.shields.io/npm/v/@cyanheads/ris-austria-mcp-server?style=flat-square&logo=npm&logoColor=white)](https://www.npmjs.com/package/@cyanheads/ris-austria-mcp-server) [![TypeScript](https://img.shields.io/badge/TypeScript-^6.0.3-3178C6.svg?style=flat-square)](https://www.typescriptlang.org/) [![Bun](https://img.shields.io/badge/Bun-v1.3.2-blueviolet.svg?style=flat-square)](https://bun.sh/)
+
+</div>
+
+<div align="center">
+
+[![Install in Claude Desktop](https://img.shields.io/badge/Install_in-Claude_Desktop-D97757?style=for-the-badge&logo=anthropic&logoColor=white)](https://github.com/cyanheads/ris-austria-mcp-server/releases/latest/download/ris-austria-mcp-server.mcpb) [![Install in Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=ris-austria-mcp-server&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBjeWFuaGVhZHMvcmlzLWF1c3RyaWEtbWNwLXNlcnZlciJdfQ==) [![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_Server-0098FF?style=for-the-badge&logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect?url=vscode:mcp/install?%7B%22name%22%3A%22ris-austria-mcp-server%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40cyanheads%2Fris-austria-mcp-server%22%5D%7D)
+
+[![Framework](https://img.shields.io/badge/Built%20on-@cyanheads/mcp--ts--core-67E8F9?style=flat-square)](https://www.npmjs.com/package/@cyanheads/mcp-ts-core)
+
+</div>
+
+---
+
+[RIS](https://www.ris.bka.gv.at/) (Rechtsinformationssystem des Bundes) is the Austrian government's official legal database: consolidated federal, state, and municipal law, case law across every Austrian court and tribunal, the authentic gazettes at every level of government (whose promulgated text is binding under Austrian law), the pre-parliamentary lawmaking pipeline, and ministerial decrees. This server wraps the keyless RIS OGD REST API (v2.6, CC BY 4.0) for MCP agents — the **entire** OGD application surface, back to the Reichsgesetzblatt of 1848. It labels every document's binding status and never presents non-authentic text as the authentic wording.
+
+## Tools
+
+Nine tools split by document class, plus a deterministic citation resolver, document retrieval, a change feed, and an offline vocabulary reference:
+
+| Tool | Description |
+|:---|:---|
+| `ris_search_legislation` | Search consolidated federal, state, and municipal law — one document per §/Artikel/Anlage — filtered to the version in force on a given date (defaults to today). Also serves English translations of selected laws. |
+| `ris_search_case_law` | Search Austrian case law (Judikatur) in one court or tribunal per call — VfGH, VwGH, ordinary courts, BVwG, LVwG, DSB, the party-transparency senate, and ten more. |
+| `ris_search_gazette` | Browse the promulgation record at every level — federal (three era tiers back to 1848, auto-routed), state law & ordinance gazettes, district, and municipal — the compliance-monitoring surface. |
+| `ris_search_drafts` | Search the federal lawmaking pipeline: ministerial drafts in public review (Begutachtungsentwürfe) and government bills (Regierungsvorlagen). |
+| `ris_search_announcements` | Search sectoral official gazettes and executive documents: social-insurance notices, veterinary notices, court rules, trade-exam regulations, health structure plans, ministerial decrees, council-of-ministers minutes. |
+| `ris_lookup_citation` | Resolve one Austrian legal citation ("§ 6 DSG", "BGBl. I Nr. 165/1999", "RGBl. Nr. 189/1902", a Geschäftszahl, "VfSlg 19.632/2012") deterministically to its canonical document. |
+| `ris_get_document` | Fetch one document's full text as markdown/HTML/XML, or its export URLs, with binding-status labeling and the authentic PDF wherever one exists. |
+| `ris_track_changes` | Exact-dated change feed per application — every document added or changed in a window, deletions included. The delta-sync primitive. |
+| `ris_list_reference` | Ground the domain vocabulary offline — applications and coverage windows, court codes, Bundesländer, decision kinds, ministries, district authorities, gazette eras and parts, citation formats, search syntax. |
+
+### `ris_search_legislation`
+
+Search consolidated law (BrKons federal, LrKons state, Gr municipal) with in-force-date handling correct by default.
+
+- Full-text `query` with RIS boolean grammar (`UND`/`ODER`/`NICHT` or `AND`/`OR`/`NOT`, parentheses, quoted phrases) and `title` matching title, short title, or abbreviation ("DSG", "ABGB")
+- `scope` routes federal or one of the nine Bundesländer; `municipality` narrows a state scope to municipal law (selected norms, six Bundesländer); `language: english` serves the Erv collection of selected English translations
+- **`in_force_as_of` defaults to today** — omitting the date upstream silently searches all historical versions; `include_all_versions` is the explicit opt-in, and the applied date is echoed in every response
+- Force-window filters (`entered_force_from/to`, `left_force_from/to`) track provisions entering or leaving force in a date range — new-law and repeal monitoring
+- Section-range filtering (`section_from`/`section_to`/`section_type` — §, Artikel, Anlage), law-level grouping via `law_id` (Gesetzesnummer), Systematik `index`, `changed_since` windows
+- Output per document: section label, in-force date, ELI, parsed CELEX references (the EU-transposition hook), and export URLs (XML/HTML/PDF/RTF)
+
+---
+
+### `ris_search_case_law`
+
+Search decisions and headnotes across Austria's courts and tribunals — 17 applications.
+
+- One application per call (`court`, required): `vfgh`, `vwgh`, `justiz`, `bvwg`, `lvwg`, `dsk`, `upts` (party-transparency senate), plus ten historical/specialized tribunals — cross-court research fans out one call per court
+- Filter by cited provision (`norm` — "DSG §1", "DSGVO Art32"), exact case number (`case_number`, Geschäftszahl), decision date range, decision kind (Erkenntnis/Beschluss/…), and full-text query
+- `decision_type` targets headnotes (Rechtssätze), full decision texts, or both
+- Court-conditional filters: `issuing_body` (dsk/dok/pvak/verg), `court_name`, `legal_area`, `subject_area` (justiz — "Datenschutzrecht", "Insolvenzrecht"), `state` (lvwg/uvs), `collection_number` (VfSlg/VwSlg cites), `party` (upts), commission/senate/discrimination ground (gbk), media statute (bks)
+- Output per decision: case numbers, decision date, ECLI, cited norms, keywords, the guiding principle (Leitsatz) on headnote documents, and headnote/decision URLs
+
+---
+
+### `ris_search_gazette`
+
+Browse the promulgation record at every level of government — what `ris_lookup_citation` (point lookup) can't express.
+
+- `scope`: federal, one of the nine Bundesländer, `district` (Bezirksverwaltungsbehörden), or `municipal` (authentic municipal promulgations)
+- **Federal history is one logical series, auto-routed across three era tiers**: BgblAuth (2004+, authentic), BgblPdf (Staats- und Bundesgesetzblatt 1945–2003), BgblAlt (Reichs-, Staats- und Bundesgesetzblatt 1848–1940, metadata + ÖNB-hosted scans) — with a notice naming which tier served
+- Filter by publication date range, gazette `part` (BGBl. I/II/III, or `pre_1997` for the partless era), document `type`, issuing ministry, district authority, or municipality
+- State scopes serve the authentic Landesgesetzblätter by default; `series: ordinance_gazette` switches to the Verordnungsblätter, `include_non_authentic` adds the historical non-authentic gazettes
+- Point lookup by gazette number ("BGBl. II Nr. 171/2026" or "171/2026")
+- Every record carries a binding label (`authentic`, `historical_record`, or `consolidated_informational`) and the amtssigniert PDF URL when present; the metadata-only 1848–1940 gazettes link to their ÖNB ALEX scan
+
+---
+
+### `ris_search_drafts`
+
+Watch federal law before it becomes law.
+
+- `stage: review_drafts` — ministerial drafts in public review (Begutachtungsentwürfe), including "what is in review **right now**" via `in_review_on`
+- `stage: government_bills` — bills adopted by the council of ministers (Regierungsvorlagen, 2004+), filtered by adoption date
+- `ministry` accepts the abbreviation ("BMF") — the server expands it to RIS's exact designation
+- Output includes review deadlines and council adoption dates
+
+---
+
+### `ris_search_announcements`
+
+Sectoral official gazettes and executive documents — seven collections, five of them legally binding authentic publications.
+
+- `collection`: `social_insurance` (Avsv), `veterinary` (Avn), `court_rules` (KmGer), `trade_exam_rules` (PruefGewO), `health_structure_plans` (Spg — ÖSG/RSG), `ministerial_decrees` (Erlässe), `council_minutes` (Ministerratsprotokolle)
+- Collection-aware filters: issue numbers, issuers (insurance carriers, ministries), cited norm ("decrees citing the DSG"), in-force date for the consolidated collections, plan type/state for health plans, session number/legislature for council minutes
+- Binding labels per collection: `authentic`, `administrative_directive` (decrees bind the administration, not citizens), or `preparatory` (council minutes)
+
+---
+
+### `ris_lookup_citation`
+
+Citation-first resolution — how Austrian legal work actually starts.
+
+- Parses and routes four citation kinds: norm cites ("§ 6 DSG", "Art 10 B-VG"), gazette numbers across all three federal eras plus LGBl ("BGBl. I Nr. 165/1999", "BGBl. Nr. 194/1961", "RGBl. Nr. 189/1902"), case numbers ("Ra 2019/22/0184", "2025-0.934.677", "6Ob56/25k"), and collection numbers ("VfSlg 19.632/2012")
+- Deterministic upstream filters (section + title, per-era number params, Geschäftszahl, Sammlungsnummer) — no keyword-search fuzziness
+- Returns `found: false` with structured guidance instead of throwing when nothing resolves
+- `court` and `state` hints short-circuit ambiguous formats
+
+---
+
+### `ris_get_document`
+
+Read and export a single document.
+
+- Addresses documents by `document_number` + `application` (from any search/lookup result) or a passed-through `ris.bka.gv.at` document URL (host and path allowlisted)
+- `format`: `markdown` (default, boilerplate stripped), raw `html`, RIS `xml`, or `urls_only`
+- Binding status on every response: `authentic` (with amtssigniert PDF URL), `consolidated_informational`, `historical_record`, `decision`, `preparatory`, `administrative_directive`, or `translation` — non-authentic text is never presented as the binding text
+- Format availability is explicit: applications that publish only the signed PDF (district/municipal promulgations, court rules) or only scans (1848–1940 gazettes, ÖNB-hosted) return a `format_unavailable` notice with the usable URLs instead of failing
+- Oversized markdown returns a retrievable §/Artikel/Anlage section outline (`kind: outline`) instead of truncating — re-call with `sections:[…]` to pull just the sections you need
+- Returns content, not fresh metadata — the upstream API has no document-by-number search, so document numbers come from a prior search or lookup result
+
+---
+
+### `ris_track_changes`
+
+Exact-dated per-application change feed (the RIS History controller).
+
+- `application` + `changed_from`/`changed_to`: every document added or changed in the window — 1,400+ changes in a typical two-week federal-law window
+- `include_deleted` surfaces removals — the only RIS surface that can
+- Coarser alternative: the search tools' `changed_since` interval filters
+
+## Resource
+
+| Type | Name | Description |
+|:---|:---|:---|
+| Resource | `ris://document/{application}/{documentNumber}` | Markdown text of one RIS document — injectable twin of `ris_get_document` |
+
+All resource data is also reachable via tools — clients without resource support use `ris_get_document`.
+
+## Features
+
+Built on [`@cyanheads/mcp-ts-core`](https://www.npmjs.com/package/@cyanheads/mcp-ts-core):
+
+- Declarative tool and resource definitions — single file per primitive, framework handles registration and validation
+- Unified error handling — handlers throw, framework catches, classifies, and formats
+- Pluggable auth (`none`, `jwt`, `oauth`)
+- Structured logging with optional OpenTelemetry tracing
+- STDIO and Streamable HTTP transports
+
+RIS-specific:
+
+- **The full RIS OGD surface** — all 39 applications across every controller: consolidated law (federal/state/municipal), authentic gazettes at four levels of government, three federal gazette era tiers back to 1848, 17 court/tribunal applications, the lawmaking pipeline, sectoral gazettes, ministerial decrees, English translations, and the per-application change feed
+- Strict parameter allowlist — RIS silently ignores unknown query params (a typo returns plausible but unfiltered results), so only live-confirmed spellings are ever sent upstream
+- Normalizer for RIS's JSON-serialized-XML envelope: object-or-array coercion, in-band error detection, six per-controller metadata classes, `<br/>` cleanup, CELEX reference parsing, ministry-abbreviation expansion
+- English tool surface over RIS's German API — Austrian legal terms (Geschäftszahl, Rechtssatz, Bundesgesetzblatt) kept as domain vocabulary and glossed in descriptions
+
+Agent-friendly output:
+
+- No dead ends — error recovery hints, zero-hit notices, format-unavailable notices, and `found: false` guidance each name the concrete next call (`ris_list_reference` topic, the right search tool, `ris_lookup_citation`), never a bare "check your input"
+- Zero hits are success plus a composed notice, never an error; conditional-parameter misuse (a court-specific filter with the wrong court, `part` outside federal scope, a collection filter on the wrong collection, bad addressing) is caught locally before any upstream call
+- Applied-filter echo — the `in_force_as_of` default is never invisible to the calling agent
+- Structured no-resolve results (`found: false` + guidance) instead of throws on citation lookup
+- Upstream schema-validation messages passed through — RIS enumerates valid values, which lets agents self-correct
+- Oversized documents return a retrievable section outline, never a silent cut — re-call with the chosen `sections` for selective retrieval
+
+## Localization
+
+Tool and parameter descriptions are English-only today. German (`de-AT`) descriptions are planned, pending opt-in localization support in the framework ([cyanheads/mcp-ts-core#259](https://github.com/cyanheads/mcp-ts-core/issues/259)); the English surface stays the default and fallback.
+
+## Getting started
+
+The one-click badges above (Claude Desktop, Cursor, VS Code) are the fastest path. To configure a client manually, the server runs straight from npm — no clone or build required.
+
+### Prerequisites
+
+- [Bun v1.3](https://bun.sh/) or higher, or Node.js v24+ (needed for `npx`/`bunx`)
+- No API key — the RIS OGD API is keyless
+
+### Install from npm (recommended)
+
+Add the server to your MCP client configuration:
+
+```json
+{
+  "mcpServers": {
+    "ris-austria-mcp-server": {
+      "command": "npx",
+      "args": ["-y", "@cyanheads/ris-austria-mcp-server"]
+    }
+  }
+}
+```
+
+`bunx @cyanheads/ris-austria-mcp-server` works the same way if you prefer Bun. Add any [configuration](#configuration) variables under an `"env"` key.
+
+### Install from source
+
+For local development or to run a pinned build:
+
+1. **Clone the repository:**
+
+```sh
+git clone https://github.com/cyanheads/ris-austria-mcp-server.git
+```
+
+2. **Navigate into the directory:**
+
+```sh
+cd ris-austria-mcp-server
+```
+
+3. **Install dependencies and build:**
+
+```sh
+bun install
+bun run rebuild
+```
+
+4. **Add to your MCP client configuration file:**
+
+```json
+{
+  "mcpServers": {
+    "ris-austria-mcp-server": {
+      "type": "stdio",
+      "command": "node",
+      "args": ["/absolute/path/to/ris-austria-mcp-server/dist/index.js"],
+      "env": {
+        "MCP_TRANSPORT_TYPE": "stdio",
+        "MCP_LOG_LEVEL": "info"
+      }
+    }
+  }
+}
+```
+
+For Streamable HTTP, set the transport and start the server:
+
+```sh
+MCP_TRANSPORT_TYPE=http MCP_HTTP_PORT=3010 bun run start:http
+# Server listens at http://localhost:3010/mcp
+```
+
+## Configuration
+
+| Variable | Description | Default |
+|:---|:---|:---|
+| `RIS_API_BASE_URL` | RIS OGD REST API base URL. | `https://data.bka.gv.at/ris/api/v2.6` |
+| `RIS_CONTENT_BASE_URL` | Document content host (also the allowlist host for `document_url` input). | `https://www.ris.bka.gv.at` |
+| `RIS_CONTACT` | Contact string appended to the User-Agent (RIS netiquette asks integrators to be identifiable). | none |
+| `MCP_TRANSPORT_TYPE` | Transport: `stdio` or `http`. | `stdio` |
+| `MCP_HTTP_PORT` | HTTP server port. | `3010` |
+| `MCP_AUTH_MODE` | Authentication: `none`, `jwt`, or `oauth`. | `none` |
+| `MCP_LOG_LEVEL` | Log level (`debug`, `info`, `warning`, `error`, …). | `info` |
+| `STORAGE_PROVIDER_TYPE` | Storage backend. | `in-memory` |
+| `OTEL_ENABLED` | Enable OpenTelemetry instrumentation. | `false` |
+
+See [`.env.example`](./.env.example) for the full list of optional overrides.
+
+## Running the server
+
+### Local development
+
+- **Build and run:**
+
+  ```sh
+  # One-time build
+  bun run rebuild
+
+  # Run the built server
+  bun run start:stdio
+  # or
+  bun run start:http
+  ```
+
+- **Run checks and tests:**
+
+  ```sh
+  bun run devcheck   # Lint, format, typecheck, security
+  bun run test       # Vitest test suite
+  bun run lint:mcp   # Validate MCP definitions against spec
+  ```
+
+## Project structure
+
+| Directory | Purpose |
+|:---|:---|
+| `src/index.ts` | `createApp()` entry point — registers tools and resources. |
+| `src/mcp-server/tools` | Tool definitions (`*.tool.ts`). |
+| `src/mcp-server/resources` | Resource definitions (`*.resource.ts`). |
+| `docs/design.md` | Settled v1 design — tool surface, service spec, live-confirmed RIS API reference. |
+| `tests/` | Unit and integration tests mirroring `src/`. |
+| `skills/` | Framework skills synced from `@cyanheads/mcp-ts-core`. |
+
+## Development guide
+
+See [`CLAUDE.md`](./CLAUDE.md) / [`AGENTS.md`](./AGENTS.md) for development guidelines and architectural rules. The short version:
+
+- Handlers throw, framework catches — no `try/catch` in tool logic
+- Use `ctx.log` for request-scoped logging, `ctx.state` for tenant-scoped storage
+- Register new tools and resources via `createApp()` in `src/index.ts`
+- Wrap the RIS API: validate raw → normalize to domain type → return output schema; never fabricate missing fields
+
+## License
+
+Apache-2.0 — see [LICENSE](./LICENSE) for details.
+
+RIS OGD data is [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/deed.de) (attribution: RIS, Bundeskanzleramt Österreich). The underlying legal texts are copyright-free official works. Only the authentic, amtssignierte gazette wording is legally binding — consolidated RIS text is informational.

package/changelog/0.1.x/0.1.0.md

@@ -0,0 +1,25 @@
+---
+summary: "Initial release — a keyless MCP server over Austria's RIS OGD REST API v2.6: 9 tools + 1 resource spanning all 39 RIS applications, with binding-status labeling, era-tier gazette routing, and a deterministic citation resolver."
+---
+
+# 0.1.0 — 2026-07-05
+
+Keyless MCP server over Austria's Rechtsinformationssystem (RIS) OGD REST API v2.6 — consolidated federal, state, and municipal law; case law across every Austrian court and tribunal; the authentic gazettes at every level of government; the pre-parliamentary lawmaking pipeline; and sectoral official notices. CC BY 4.0.
+
+## Added
+
+- **Full OGD surface — 9 tools + 1 resource over all 39 RIS applications**, across the six search controllers (Bundesrecht, Landesrecht, Bezirke, Gemeinden, Judikatur, Sonstige) plus the History change feed, with no deferred tier.
+- **`ris_search_legislation`** — consolidated federal (BrKons), state (LrKons), and municipal (Gr) law plus English translations (Erv), routed by `scope`/`municipality`/`language`; `in_force_as_of` defaults to today, so "current law" queries don't silently search every historical version.
+- **`ris_search_case_law`** — one Judikatur application per call across 17 courts and tribunals (VfGH, VwGH, Justiz, BVwG, LVwG, DSB, …), with per-court conditional filters guarded locally.
+- **`ris_search_gazette`** — the promulgation record at every level of government; the three federal era tiers (BgblAuth 2004+, BgblPdf 1945–2003, BgblAlt 1848–1940) auto-route by date/number, with a notice naming which tier served.
+- **`ris_search_drafts`** — the federal lawmaking pipeline: ministerial review drafts (Begut) and government bills (RegV, 2004+).
+- **`ris_search_announcements`** — seven sectoral collections behind one enum: social-insurance and veterinary notices, court rules, trade-exam regulations, health structure plans, ministerial decrees, and council-of-ministers minutes.
+- **`ris_lookup_citation`** — deterministic resolver from a citation (norm, gazette number across all three eras, Geschäftszahl, or VfSlg/VwSlg collection number) to the canonical document; returns `found: false` with next-step guidance on no-resolve, never throws for a miss.
+- **`ris_get_document`** — full text (markdown/html/xml) or export URLs for one document, surfacing the authentic amtssigniert PDF where it exists and an explicit `format_unavailable` notice where no text rendition does.
+- **`ris_track_changes`** — the History controller's per-application change feed over an exact date window; the only surface that reports deletions.
+- **`ris_list_reference`** — static, offline grounding for the opaque German codes (applications, courts, states, ministries, collections, gazette parts, citation formats, search syntax, …); the target of every tool's recovery routing.
+- **`ris://document/{application}/{documentNumber}`** — resource twin of `ris_get_document`, returning one document's markdown.
+- **Binding-status labeling on every document output** — seven labels (`authentic`, `consolidated_informational`, `historical_record`, `decision`, `preparatory`, `administrative_directive`, `translation`); non-authentic consolidated text is never presented as the legally binding wording.
+- **Typed error contracts, no dead ends** — conditional-param misuse is caught locally before any upstream call, RIS in-band Client errors pass through verbatim, zero hits are a success-plus-notice, and every recovery string routes to a named tool.
+- **`RisService`** — one service over the RIS OGD REST v2.6 API and the document content host, with a six-controller normalizer (in-band error-envelope detection, object-or-array coercion, CELEX/ELI/ECLI extraction, ministry-abbreviation expansion, History application-name aliasing) and a strict param allowlist so a mis-spelled filter never returns plausible-but-unfiltered results.
+- **Transports and config** — STDIO and Streamable HTTP; keyless upstream with optional `RIS_API_BASE_URL`, `RIS_CONTENT_BASE_URL`, and `RIS_CONTACT` (User-Agent contact per RIS netiquette). Built on `@cyanheads/mcp-ts-core` ^0.10.12.

package/changelog/0.1.x/0.1.1.md

@@ -0,0 +1,24 @@
+---
+summary: "Content-parity fixes for ris_track_changes and ris_search_case_law; mcp-ts-core ^0.10.14; Bun supply-chain install guard (minimumReleaseAge + Socket scanner)."
+breaking: false
+security: false
+---
+
+# 0.1.1 — 2026-07-09
+
+## Added
+
+- **`.gitattributes`** — LF normalization, binary-asset handling, and `linguist-generated` markers for `bun.lock`/`CHANGELOG.md`/`docs/tree.md`.
+- **`.github/SECURITY.md`** — vulnerability reporting policy.
+
+## Changed
+
+- **`@cyanheads/mcp-ts-core`** ^0.10.12 → ^0.10.14.
+- **Supply-chain install guard** — `bunfig.toml` blocks package versions published under 3 days ago (`minimumReleaseAge`, `@cyanheads/mcp-ts-core` excluded for same-day adoption) and routes installs through the Socket scanner (`@socketsecurity/bun-security-scanner`, declared in `trustedDependencies`).
+- **Dockerfile** — pins `oven/bun` to `1.3.14` (was floating `1.3`/`1.3-slim`), adds BuildKit cache mounts to `bun install`, and adds `--ignore-scripts` to the build-stage install.
+- Synced 10 framework skills and 3 framework scripts (`devcheck.ts`, `lint-mcp.ts`, `tree.ts`) from `@cyanheads/mcp-ts-core`.
+
+## Fixed
+
+- **`ris_track_changes`** — `format()` renders `**Deleted:** no` for an explicit `deleted: false` record instead of omitting the line, so content-only clients can distinguish a non-deleted record from one that dropped the field. ([#2](https://github.com/cyanheads/ris-austria-mcp-server/issues/2))
+- **`ris_search_case_law`** — adds the `truncated` enrichment field (`structuredContent` and the content trailer) when `totalCount` exceeds the current page, matching `ris_search_legislation`, `ris_search_gazette`, `ris_search_drafts`, `ris_search_announcements`, and `ris_track_changes`. ([#3](https://github.com/cyanheads/ris-austria-mcp-server/issues/3))

package/changelog/0.1.x/0.1.2.md

@@ -0,0 +1,16 @@
+---
+summary: "ris_get_document returns a retrievable §/Artikel/Anlage section outline for oversized documents instead of truncating, with a sections re-call for selective retrieval; the ris://document/... resource degrades the same way."
+breaking: false
+security: false
+---
+
+# 0.1.2 — 2026-07-09
+
+## Added
+
+- **`sections`** input param on `ris_get_document` — an array of section names, copied verbatim from a prior outline response, for selective re-call.
+- **`kind`** output discriminator (`full` | `outline`) plus an outline `sections` array (name + UTF-8 byte size, largest first) when the rendered markdown overflows the byte budget.
+
+## Fixed
+
+- **`ris_get_document`** no longer irreversibly truncates oversized document text at the 500 KB budget — it returns a navigable §/Artikel/Anlage section outline instead, retrievable via a `sections:[…]` re-call. Raw `html`/`xml` renditions carry no structural headings and return in full. The `ris://document/{application}/{documentNumber}` resource degrades the same way, with a notice pointing back at the `ris_get_document` tool for section selection (the resource carries no selector of its own). ([#4](https://github.com/cyanheads/ris-austria-mcp-server/issues/4))

package/changelog/0.1.x/0.1.3.md

@@ -0,0 +1,11 @@
+---
+summary: "ris_lookup_citation now parses abbreviation-first norm citations (e.g. DSG §1, DSGVO Art32), including trailing sub-provisions and multi-token abbreviations, so ris_search_case_law's norms_cited output round-trips into citation lookup."
+breaking: false
+security: false
+---
+
+# 0.1.3 — 2026-07-09
+
+## Added
+
+- **`ris_lookup_citation`** now parses abbreviation-first norm citations ("DSG §1", "DSGVO Art32") alongside the existing section-first shape ("§ 1 DSG") — the form `ris_search_case_law` emits in its `norms_cited` output, so a cited norm now round-trips straight back into lookup. Trailing sub-provisions (`Abs`, `Z`, `lit`) are dropped the same way as the section-first parser, and multi-token abbreviations ("B-VG", "TKG 2021") are handled by anchoring on the §/Artikel marker rather than whitespace. ([#5](https://github.com/cyanheads/ris-austria-mcp-server/issues/5))

package/changelog/0.1.x/0.1.4.md

@@ -0,0 +1,11 @@
+---
+summary: "ris_get_document's document_url mode now rejects content-attachment / non-rendition URLs (Materialien_…, Anlagen_…, or a file whose stem doesn't match the document number) with an unsupported_url error instead of silently fetching the main document."
+breaking: false
+security: false
+---
+
+# 0.1.4 — 2026-07-09
+
+## Fixed
+
+- **`ris_get_document`**'s `document_url` addressing mode now rejects a content-attachment or non-rendition URL — a RegV `Materialien_…`/`Anlagen_…` memorandum or annex, or any path whose trailing filename's stem doesn't equal the document number — with the existing `unsupported_url` error, instead of silently discarding the filename and returning the main document. Main-document rendition URLs (`{documentNumber}.{ext}` for `html`/`pdf`/`rtf`/`xml`/`pdfsig`) and folder URLs (with or without a trailing slash) are unaffected. ([#6](https://github.com/cyanheads/ris-austria-mcp-server/issues/6))

package/changelog/0.1.x/0.1.5.md

@@ -0,0 +1,18 @@
+---
+summary: "First public release — published to npm, the MCP Registry, and GHCR. README adds install badges (Claude Desktop, Cursor, VS Code), npm and Docker header badges, and an npm-first Getting started section."
+breaking: false
+security: false
+---
+
+# 0.1.5 — 2026-07-09
+
+The tool surface is unchanged from 0.1.4 — this is the first public publication of the package, alongside a README refresh for npm-based install.
+
+## Added
+
+- **npm / MCP Registry / GHCR** — first public publication of `@cyanheads/ris-austria-mcp-server`, installable via `npx`/`bunx`, the MCP Registry, and the `ghcr.io/cyanheads/ris-austria-mcp-server` container image.
+- **Install badges** — Claude Desktop (`.mcpb`), Cursor, and VS Code install badges, plus npm and Docker badges in the header row.
+
+## Changed
+
+- **README "Getting started"** — leads with the npm path (`npx -y @cyanheads/ris-austria-mcp-server`); the from-source steps move to a secondary section, and the pre-release status notice is removed.