adr-agreement-mcp-server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| ADR_API_URL | No | Base URL of the ADR API service. | https://api.kocie.mba |
| ADR_API_TOKEN | No | API token for authenticating with the ADR API. A shared demo token is used by default. | DEMO-ADR-2026-PUBLIC |
| ADR_DATA_LANG | No | Language code for ADR data (e.g. 'pl' or 'en'). | pl |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| lookup_unA | Zwraca surowy rekord Tabeli A Umowy ADR dla podanego numeru UN z api.kocie.mba. Jeden numer UN może zwrócić więcej niż jedną pozycję (np. różne grupy pakowania) — jeśli tak się stanie, doprecyzuj przez packingGroup. |
| search_adrA | Wyszukuje towary niebezpieczne po nazwie (PL/EN) lub fragmencie numeru UN w api.kocie.mba. Zwraca skróconą listę dopasowań (numer UN, nazwa, klasa) — po znalezieniu właściwej pozycji użyj lookup_un po pełne dane. |
| build_proper_shipping_nameA | Buduje bazową prawidłową nazwę przewozową dla numeru UN z api.kocie.mba i zwraca listę modyfikatorów (ODPAD, GORĄCY, STABILIZOWANY itd.) z warunkiem zastosowania każdego — o tym, czy dany modyfikator pasuje, decyduje kontekst przewozu podany przez użytkownika, nie to narzędzie. |
| resolve_lq_eqA | Zwraca limity ilości ograniczonych (LQ) i wyłączonych (EQ) dla numeru UN, na podstawie pól limitedQuantity/exceptedQuantity z api.kocie.mba. |
| calculate_1136A | Liczy, czy zestaw towarów na jednej jednostce transportowej mieści się w wyłączeniu 1.1.3.6 (drobne ilości). Każda pozycja wymaga transportCategory (pobranej wcześniej np. przez lookup_un) i ilości (kg lub litry, zgodnie z regułami 1.1.3.6.3). |
| check_mixed_packingA | Sprawdza, czy dwa towary (po kodach mixedPacking, np. "MP15") mogą być pakowane razem w jednej sztuce przesyłki. Dla jednoznacznych kodów zwraca twardy werdykt, dla pozostałych oba opisy do interpretacji. |
| decode_tank_codeA | Rozkłada kod cysterny (np. "L4BH") na 4 znaczące części: typ, ciśnienie obliczeniowe, otwory, zawory/urządzenia bezpieczeństwa. |
| compare_tank_codesA | Sprawdza regułę hierarchii ADR 4.3.3: czy cysterna offeredCode może być użyta zamiast wymaganej requiredCode. Nie uwzględnia przepisów szczególnych 4.3.5 ani pozycji z obowiązkowym indywidualnym przypisaniem kodu. |
| decode_hazard_idA | Wyjaśnia numer rozpoznawczy zagrożenia (numer Kemlera, np. "336" albo "X462") — znaczenie cyfr i prefiksu "X" (reakcja z wodą). |
| decode_classification_codeA | Wyjaśnia kod klasyfikacyjny towaru (pole classificationCode, np. "FT1" albo dla klasy 1: "1.1D") w kontekście jego klasy zagrożenia. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 10 tools
Each tool targets a clearly distinct ADR sub-task: search/lookup, shipping-name construction, LQ/EQ limits, 1.1.3.6 calculation, mixed packing, tank-code handling, and code decoding. The explicit cross-references between search_adr and lookup_un further reduce misselection risk.
All tool names use lowercase snake_case with an imperative verb-noun pattern (search_, lookup_, build_, resolve_, calculate_, check_, decode_, compare_). Acronyms and rule numbers like UN, LQ_EQ, and 1136 are used predictably and do not break the naming convention.
Ten tools is a well-scoped size for an ADR dangerous-goods assistant. Each tool addresses a distinct regulatory calculation or lookup without overlap or bloat, supporting both low-level data retrieval and higher-level compliance decisions.
The core ADR workflows are well covered: search/lookup, proper shipping names, LQ/EQ limits, 1.1.3.6 exemption, mixed packing, tank codes, hazard IDs, and classification codes. Some adjacent areas such as tunnel restrictions or special provisions are not directly decoded, though raw lookup data can partially compensate.