Skip to main content
Glama

Check EU instrument status and version

get_instrument
Read-onlyIdempotent

Use this to check an EU instrument's recorded legal status, source version, dates and amendments, including whether a held PSR or PSD3 text is a proposal or compromise. Metadata, dates, lifecycle and application events, and curated relationships. Each relationship names the operative amending or repealing article where curated (openable with get_provision) and the counterpart's legal status at the release. An operative_cite can arrive without an operative_locator: the article is real but the served text has dropped it, and operative_locator_unavailable says so. An amender outside the corpus is named under source_external, whose via_article carries its article. No article index — use list_provisions. Pass on_date for the multi-axis applicability record on that date.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
on_dateNoISO date; returns the full applicability record.
instrument_idYes

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
dataYes
errorYes
coverageYes
warningsYes
paginationYes
provenanceYes
derivationsYes
corpus_releaseYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed4 schema fields changed
    • removedInput schema / properties / on_date / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedInput schema / properties / on_date / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • changedOutput schema / properties / data / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": {},
      -    "properties": {
      -      "instrument_id": {
      -        "type": "string"
      -      },
      -      "legal_status_at_release": {
      -        "type": "string"
      -      },
      -      "relationships": {
      -        "anyOf": [
      -          {
      -            "items": {
      -              "additionalProperties": {},
      -              "properties": {
      -                "direction": {
      -                  "type": "string"
      -                },
      -                "kind": {
      -                  "type": "string"
      -                },
      -                "operative_cite": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                },
      -                "operative_locator": {
      -                  "anyOf": [
      -                    {
      -                      "additionalProperties": {},
      -                      "properties": {
      -                        "article": {
      -                          "type": "string"
      -                        },
      -                        "instrument_id": {
      -                          "type": "string"
      -                        },
      -                        "kind": {
      -                          "type": "string"
      -                        }
      -                      },
      -                      "required": [
      -                        "instrument_id",
      -                        "kind",
      -                        "article"
      -                      ],
      -                      "type": "object"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                },
      -                "operative_locator_unavailable": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                },
      -                "source_external": {
      -                  "anyOf": [
      -                    {
      -                      "additionalProperties": {},
      -                      "properties": {
      -                        "celex": {
      -                          "type": "string"
      -                        },
      -                        "title": {
      -                          "type": "string"
      -                        },
      -                        "via_article": {
      -                          "anyOf": [
      -                            {
      -                              "type": "string"
      -                            },
      -                            {
      -                              "type": "null"
      -                            }
      -                          ]
      -                        }
      -                      },
      -                      "required": [
      -                        "celex",
      -                        "title",
      -                        "via_article"
      -                      ],
      -                      "type": "object"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                },
      -                "target_external": {
      -                  "anyOf": [
      -                    {
      -                      "additionalProperties": {},
      -                      "properties": {
      -                        "celex": {
      -                          "type": "string"
      -                        },
      -                        "title": {
      -                          "type": "string"
      -                        }
      -                      },
      -                      "required": [
      -                        "celex",
      -                        "title"
      -                      ],
      -                      "type": "object"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                },
      -                "target_instrument_id": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                },
      -                "target_status": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                }
      -              },
      -              "required": [
      -                "kind",
      -                "direction",
      -                "target_status",
      -                "operative_locator",
      -                "operative_cite",
      -                "operative_locator_unavailable"
      -              ],
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "text_state": {
      -        "type": "string"
      -      },
      -      "title": {
      -        "type": "string"
      -      },
      -      "url": {
      -        "type": "string"
      -      },
      -      "version_id": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "instrument_id",
      -      "title",
      -      "legal_status_at_release",
      -      "version_id",
      -      "text_state",
      -      "url",
      -      "relationships"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": {},
      +    "properties": {
      +      "instrument_id": {
      +        "type": "string"
      +      },
      +      "legal_status_at_release": {
      +        "type": "string"
      +      },
      +      "relationships": {
      +        "anyOf": [
      +          {
      +            "items": {
      +              "additionalProperties": {},
      +              "properties": {
      +                "direction": {
      +                  "type": "string"
      +                },
      +                "kind": {
      +                  "type": "string"
      +                },
      +                "operative_cite": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "operative_locator": {
      +                  "anyOf": [
      +                    {
      +                      "additionalProperties": {},
      +                      "properties": {
      +                        "article": {
      +                          "type": "string"
      +                        },
      +                        "instrument_id": {
      +                          "type": "string"
      +                        },
      +                        "kind": {
      +                          "type": "string"
      +                        }
      +                      },
      +                      "required": [
      +                        "instrument_id",
      +                        "kind",
      +                        "article"
      +                      ],
      +                      "type": "object"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "operative_locator_unavailable": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "source_external": {
      +                  "anyOf": [
      +                    {
      +                      "additionalProperties": {},
      +                      "properties": {
      +                        "celex": {
      +                          "type": "string"
      +                        },
      +                        "title": {
      +                          "type": "string"
      +                        },
      +                        "via_article": {
      +                          "type": [
      +                            "string",
      +                            "null"
      +                          ]
      +                        }
      +                      },
      +                      "required": [
      +                        "celex",
      +                        "title",
      +                        "via_article"
      +                      ],
      +                      "type": "object"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "target_external": {
      +                  "anyOf": [
      +                    {
      +                      "additionalProperties": {},
      +                      "properties": {
      +                        "celex": {
      +                          "type": "string"
      +                        },
      +                        "title": {
      +                          "type": "string"
      +                        }
      +                      },
      +                      "required": [
      +                        "celex",
      +                        "title"
      +                      ],
      +                      "type": "object"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "target_instrument_id": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "target_status": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                }
      +              },
      +              "required": [
      +                "kind",
      +                "direction",
      +                "target_status",
      +                "operative_locator",
      +                "operative_cite",
      +                "operative_locator_unavailable"
      +              ],
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "text_state": {
      +        "type": "string"
      +      },
      +      "title": {
      +        "type": "string"
      +      },
      +      "url": {
      +        "type": "string"
      +      },
      +      "version_id": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "instrument_id",
      +      "title",
      +      "legal_status_at_release",
      +      "version_id",
      +      "text_state",
      +      "url",
      +      "relationships"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedOutput schema / properties / pagination / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "complete": {
      -        "type": "boolean"
      -      },
      -      "next_cursor": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "total": {
      -        "type": "number"
      -      }
      -    },
      -    "required": [
      -      "complete",
      -      "next_cursor"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "complete": {
      +        "type": "boolean"
      +      },
      +      "next_cursor": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "total": {
      +        "type": "number"
      +      }
      +    },
      +    "required": [
      +      "complete",
      +      "next_cursor"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
  2. First observed

TDQS

A4.6/5.0
Behavior5/5

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

Annotations already declare readOnlyHint and idempotentHint, and the description adds substantial behavioral detail beyond that: relationships name operative amending/repealing articles, operative_cite can arrive without operative_locator, and source_external handles amenders outside the corpus. This is exactly the edge-case foresight an agent needs.

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

Conciseness4/5

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

The first sentence is front-loaded and high-value, and the remaining text is dense with useful edge cases rather than filler. Some fragments, like 'Metadata, dates, lifecycle and application events, and curated relationships,' are telegraphic and could be smoother, but every sentence earns its place.

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?

For a read-only, idempotent lookup that has an output schema, the description provides the key response-shape caveats (missing locators, external amenders), optional date behavior, and the correct sibling for article-level navigation. An agent has enough context to invoke and interpret this tool correctly.

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

Parameters3/5

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

Schema coverage is 50%: only on_date is described in the schema, while instrument_id has no description. The description reinforces on_date as a 'multi-axis applicability record' and identifies the resource as an EU instrument, but it does not clarify the expected form or semantics of instrument_id itself, so it only partially compensates for the gap.

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?

States a specific verb ('check') and resource ('EU instrument's recorded legal status, source version, dates and amendments'), and goes further by naming the exact context (PSR/PSD3 proposal vs compromise). It also distinguishes itself from siblings by explicitly directing article-index needs to list_provisions.

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?

Frames the tool's primary use directly ('Use this to check an EU instrument's...'), gives an alternative routing ('No article index — use list_provisions'), and notes that relationships are 'openable with get_provision'. It also tells when to pass the optional parameter: 'Pass on_date for the multi-axis applicability record on that date.'

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources