Skip to main content
Glama

Szczegóły aktu prawnego

get_act_details
Read-onlyIdempotent

Retrieve metadata for a Polish legal act, including status, dates, keywords, and table of contents. Optionally load full content to enable subsequent reading and searching.

Instructions

Pobierz szczegółowe informacje o akcie prawnym.

Zwraca metadane: tytuł, status, daty (ogłoszenia, wejścia w życie, uchylenia), słowa kluczowe, spis treści i dostępne formaty (HTML/PDF).

Ustaw load_content=True aby załadować treść — to wymagane przed użyciem read_act_content (czytanie sekcji) i search_in_act (wyszukiwanie w treści).

Kiedy użyć: Aby zobaczyć metadane aktu (status, daty, spis treści). Kiedy NIE używać: Aby czytać treść aktu → użyj read_act_content (po załadowaniu).

Przykłady:

  • get_act_details(eli="DU/2024/1692") - Metadane i spis treści

  • get_act_details(eli="DU/2024/1692", load_content=True) - Załaduj treść do analizy

  • get_act_details(eli="DU/2024/1716") - Sprawdź status, daty i referencje

  • get_act_details(eli="MP/2024/100") - Akt z Monitora Polskiego

  • get_act_details(eli="DU/2021/1500") - Sprawdź status i daty obowiązywania

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
eliYesIdentyfikator ELI aktu. Format: "{wydawca}/{rok}/{pozycja}". Wydawcy: DU (Dziennik Ustaw), MP (Monitor Polski). Przykłady: "DU/2024/1716", "MP/2023/500", "DU/2024/1".
load_contentNoZaładuj treść aktu do Document Store (pamięć). WYMAGANE przed użyciem: read_act_content, search_in_act. Lifecycle: załadowane → TTL 2h → wygasa → wymaga ponownego załadowania. Domyślnie False.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
dataYesThe actual response data
hintsNoSuggested next steps

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changedv4.4.0
    • removedOutput schema / properties / metadata
      Removed value: -{
      -  "additionalProperties": true,
      -  "description": "Additional metadata",
      -  "title": "Metadata",
      -  "type": "object"
      -}
  2. Changed2 schema fields changedv4.3.0
    • addedOutput schema / $defs / ActDetailOutput / properties / content_status
      Added value: +{
      +  "$ref": "#/$defs/ContentStatus",
      +  "default": "not_requested",
      +  "description": "Wynik ładowania treści. 'not_requested' — wywołanie nie prosiło o treść. 'loaded' — treść jest w pamięci (mogła zostać załadowana bieżącym albo wcześniejszym wywołaniem), można użyć read_act_content i search_in_act. 'unavailable' — akt trwale nie ma czytelnego tekstu w API; ponowne ładowanie nic nie zmieni."
      +}
    • addedOutput schema / $defs / ContentStatus
      Added value: +{
      +  "description": "Outcome of the content-loading half of `get_act_details`.\n\nDeliberately has no member for a transient upstream failure: that path\nends as a protocol error, so it never reaches a response body (D2, D6).",
      +  "enum": [
      +    "not_requested",
      +    "loaded",
      +    "unavailable"
      +  ],
      +  "title": "ContentStatus",
      +  "type": "string"
      +}
  3. Changed11 schema fields changedv3.1.0
    • addedInput schema / properties / eli / title
      Added value: +"Eli"
    • addedInput schema / properties / load_content / title
      Added value: +"Load Content"
    • addedInput schema / title
      Added value: +"get_act_detailsArguments"
    • addedOutput schema / $defs
      Added value: +{
      +  "ActDetailOutput": {
      +    "description": "Output for detailed act information.",
      +    "properties": {
      +      "announcement_date": {
      +        "anyOf": [
      +          {
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "default": null,
      +        "title": "Announcement Date"
      +      },
      +      "change_date": {
      +        "anyOf": [
      +          {
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "default": null,
      +        "title": "Change Date"
      +      },
      +      "eli": {
      +        "title": "Eli",
      +        "type": "string"
      +      },
      +      "entry_into_force": {
      +        "anyOf": [
      +          {
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "default": null,
      +        "title": "Entry Into Force"
      +      },
      +      "has_html": {
      +        "default": false,
      +        "title": "Has Html",
      +        "type": "boolean"
      +      },
      +      "has_pdf": {
      +        "default": false,
      +        "title": "Has Pdf",
      +        "type": "boolean"
      +      },
      +      "is_loaded": {
      +        "default": false,
      +        "title": "Is Loaded",
      +        "type": "boolean"
      +      },
      +      "keywords": {
      +        "default": [],
      +        "items": {
      +          "type": "string"
      +        },
      +        "title": "Keywords",
      +        "type": "array"
      +      },
      +      "pos": {
      +        "title": "Pos",
      +        "type": "integer"
      +      },
      +      "promulgation_date": {
      +        "anyOf": [
      +          {
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "default": null,
      +        "title": "Promulgation Date"
      +      },
      +      "publisher": {
      +        "title": "Publisher",
      +        "type": "string"
      +      },
      +      "references": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": true,
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "default": null,
      +        "title": "References"
      +      },
      +      "repeal_date": {
      +        "anyOf": [
      +          {
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "default": null,
      +        "title": "Repeal Date"
      +      },
      +      "status": {
      +        "title": "Status",
      +        "type": "string"
      +      },
      +      "title": {
      +        "title": "Title",
      +        "type": "string"
      +      },
      +      "toc": {
      +        "default": [],
      +        "items": {
      +          "additionalProperties": true,
      +          "type": "object"
      +        },
      +        "title": "Toc",
      +        "type": "array"
      +      },
      +      "type": {
      +        "anyOf": [
      +          {
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "default": null,
      +        "title": "Type"
      +      },
      +      "valid_from": {
      +        "anyOf": [
      +          {
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "default": null,
      +        "title": "Valid From"
      +      },
      +      "volume": {
      +        "anyOf": [
      +          {
      +            "type": "integer"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "default": null,
      +        "title": "Volume"
      +      },
      +      "year": {
      +        "title": "Year",
      +        "type": "integer"
      +      }
      +    },
      +    "required": [
      +      "eli",
      +      "publisher",
      +      "year",
      +      "pos",
      +      "title",
      +      "status"
      +    ],
      +    "title": "ActDetailOutput",
      +    "type": "object"
      +  },
      +  "Hint": {
      +    "description": "Hint for next actions or related tools.",
      +    "properties": {
      +      "message": {
      +        "description": "Hint message",
      +        "title": "Message",
      +        "type": "string"
      +      },
      +      "parameters": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": true,
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "default": null,
      +        "description": "Suggested parameters",
      +        "title": "Parameters"
      +      },
      +      "tool": {
      +        "anyOf": [
      +          {
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "default": null,
      +        "description": "Related tool name",
      +        "title": "Tool"
      +      }
      +    },
      +    "required": [
      +      "message"
      +    ],
      +    "title": "Hint",
      +    "type": "object"
      +  }
      +}
    • addedOutput schema / properties / data
      Added value: +{
      +  "$ref": "#/$defs/ActDetailOutput",
      +  "description": "The actual response data"
      +}
    • addedOutput schema / properties / hints
      Added value: +{
      +  "description": "Suggested next steps",
      +  "items": {
      +    "$ref": "#/$defs/Hint"
      +  },
      +  "title": "Hints",
      +  "type": "array"
      +}
    • addedOutput schema / properties / metadata
      Added value: +{
      +  "additionalProperties": true,
      +  "description": "Additional metadata",
      +  "title": "Metadata",
      +  "type": "object"
      +}
    • removedOutput schema / properties / result
      Removed value: -{
      -  "type": "string"
      -}
    • changedOutput schema / required
      Previous value: -[
      -  "result"
      -]New value: +[
      +  "data"
      +]
    • addedOutput schema / title
      Added value: +"EnrichedResponse[ActDetailOutput]"
    • removedOutput schema / x-fastmcp-wrap-result
      Removed value: -true
  4. Addedv1.0.2

TDQS

A4.9/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already indicate read-only, idempotent, non-destructive behavior. The description adds meaningful behavioral context by disclosing that load_content=True loads content into the Document Store with a 2-hour TTL, and that this is required before dependent tools. No contradiction with annotations is present.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is well organized with clear sections for purpose, return value, prerequisites, usage guidance, and examples. Each part supports selection and invocation without significant redundancy, and the most important information is front-loaded.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given 100% schema coverage, rich annotations, an output schema, and explicit cross-tool prerequisites, the description is complete for an agent to invoke the tool correctly. It covers metadata retrieval, content loading, status checks, and example identifiers.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema already describes both parameters in full, so the baseline is 3. The description adds extra value by explaining the load_content lifecycle, listing concrete ELI examples, and noting the required workflow relationship with read_act_content and search_in_act.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description names a specific verb ('Pobierz') and resource ('szczegółowe informacje o akcie prawnym'), then lists the returned metadata types. It explicitly contrasts with read_act_content, so an agent can clearly distinguish this tool from its siblings.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides a clear 'Kiedy użyć' block, an explicit 'Kiedy NIE używać' block naming read_act_content, and states that load_content=True is a prerequisite for read_act_content and search_in_act. This is direct, actionable guidance about when to use this tool versus alternatives.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.