Payments Law — EU payments legislation

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, a Council compromise text or the act published in the Official Journal. Metadata, dates, lifecycle and application events, and curated relationships, each naming the operative amending or repealing article where curated. No article index: use list_provisions. Pass on_date for the applicability record on that date.

Input Schema

Name	Required	Description	Default
`on_date`	No	ISO date; returns the full applicability record.
`instrument_id`	Yes

Output Schema

Name	Required	Description	Default
`data`	Yes
`error`	Yes
`coverage`	Yes
`warnings`	Yes
`pagination`	Yes
`provenance`	Yes
`derivations`	Yes
`corpus_release`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedOct 24, 2026

changedOutput schema / properties / data / anyOf

Previous value: -[
-  {
-    "additionalProperties": {},
-    "properties": {
-      "instrument_id": {
-        "type": "string"
-      },
-      "legal_status_at_release": {
-        "type": "string"
-      },
-      "lifecycle_events": {
-        "anyOf": [
-          {
-            "items": {
-              "additionalProperties": {},
-              "properties": {
-                "date": {
-                  "type": "string"
-                },
-                "scheduled": {
-                  "type": [
-                    "boolean",
-                    "null"
-                  ]
-                },
-                "stage": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "stage",
-                "date",
-                "scheduled"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "oj_status_check": {
-        "anyOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "checked_on": {
-                "type": "string"
-              },
-              "oj_reference": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "stage": {
-                "type": "string"
-              }
-            },
-            "required": [
-              "checked_on",
-              "stage",
-              "oj_reference"
-            ],
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "relationships": {
-        "anyOf": [
-          {
-            "items": {
-              "additionalProperties": {},
-              "properties": {
-                "direction": {
-                  "type": "string"
-                },
-                "effective_from": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "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"
-                  ]
-                },
-                "repealed_provisions": {
-                  "type": "string"
-                },
-                "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": {
-        "description": "`consolidated`: a EUR-Lex consolidation. `as_adopted`: a single document's text, amendments not incorporated. Not a legal status: a Council compromise text is `as_adopted` and not yet law; see `legal_status_at_release`.",
-        "type": "string"
-      },
-      "title": {
-        "type": "string"
-      },
-      "url": {
-        "type": "string"
-      },
-      "version_id": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "instrument_id",
-      "title",
-      "legal_status_at_release",
-      "oj_status_check",
-      "version_id",
-      "text_state",
-      "url",
-      "relationships",
-      "lifecycle_events"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": {},
+    "properties": {
+      "instrument_id": {
+        "type": "string"
+      },
+      "legal_status_at_release": {
+        "type": "string"
+      },
+      "lifecycle_events": {
+        "anyOf": [
+          {
+            "items": {
+              "additionalProperties": {},
+              "properties": {
+                "date": {
+                  "type": "string"
+                },
+                "scheduled": {
+                  "type": [
+                    "boolean",
+                    "null"
+                  ]
+                },
+                "stage": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "stage",
+                "date",
+                "scheduled"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "oj_status_check": {
+        "anyOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "checked_on": {
+                "type": "string"
+              },
+              "oj_reference": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "stage": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "checked_on",
+              "stage",
+              "oj_reference"
+            ],
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "relationships": {
+        "anyOf": [
+          {
+            "items": {
+              "additionalProperties": {},
+              "properties": {
+                "direction": {
+                  "type": "string"
+                },
+                "effective_from": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "kind": {
+                  "type": "string"
+                },
+                "operative_cite": {
+                  "description": "The operative amending or repealing article, where curated; openable with get_provision.",
+                  "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"
+                    }
+                  ],
+                  "description": "The served text's locator for operative_cite. Null when the served text has dropped the article; see operative_locator_unavailable."
+                },
+                "operative_locator_unavailable": {
+                  "description": "Why operative_cite has no locator: the article is real but the served text has dropped it.",
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "repealed_provisions": {
+                  "type": "string"
+                },
+                "source_external": {
+                  "anyOf": [
+                    {
+                      "additionalProperties": {},
+                      "properties": {
+                        "celex": {
+                          "type": "string"
+                        },
+                        "title": {
+                          "type": "string"
+                        },
+                        "via_article": {
+                          "description": "The article of an amender outside the corpus that carries the amendment.",
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        }
+                      },
+                      "required": [
+                        "celex",
+                        "title",
+                        "via_article"
+                      ],
+                      "type": "object"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "An instrument outside the corpus, named by CELEX and title rather than guessed at."
+                },
+                "target_external": {
+                  "anyOf": [
+                    {
+                      "additionalProperties": {},
+                      "properties": {
+                        "celex": {
+                          "type": "string"
+                        },
+                        "title": {
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "celex",
+                        "title"
+                      ],
+                      "type": "object"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "An instrument outside the corpus, named by CELEX and title rather than guessed at."
+                },
+                "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": {
+        "description": "`consolidated`: a EUR-Lex consolidation. `as_adopted`: a single document's text, amendments not incorporated. Not a legal status: a Council compromise text is `as_adopted` and not yet law; see `legal_status_at_release`.",
+        "type": "string"
+      },
+      "title": {
+        "type": "string"
+      },
+      "url": {
+        "type": "string"
+      },
+      "version_id": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "instrument_id",
+      "title",
+      "legal_status_at_release",
+      "oj_status_check",
+      "version_id",
+      "text_state",
+      "url",
+      "relationships",
+      "lifecycle_events"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

Changed1 schema field changedOct 19, 2026

changedOutput schema / properties / data / anyOf

Previous value: -[
-  {
-    "additionalProperties": {},
-    "properties": {
-      "instrument_id": {
-        "type": "string"
-      },
-      "legal_status_at_release": {
-        "type": "string"
-      },
-      "lifecycle_events": {
-        "anyOf": [
-          {
-            "items": {
-              "additionalProperties": {},
-              "properties": {
-                "date": {
-                  "type": "string"
-                },
-                "scheduled": {
-                  "type": [
-                    "boolean",
-                    "null"
-                  ]
-                },
-                "stage": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "stage",
-                "date",
-                "scheduled"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "relationships": {
-        "anyOf": [
-          {
-            "items": {
-              "additionalProperties": {},
-              "properties": {
-                "direction": {
-                  "type": "string"
-                },
-                "effective_from": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "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"
-                  ]
-                },
-                "repealed_provisions": {
-                  "type": "string"
-                },
-                "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",
-      "lifecycle_events"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": {},
+    "properties": {
+      "instrument_id": {
+        "type": "string"
+      },
+      "legal_status_at_release": {
+        "type": "string"
+      },
+      "lifecycle_events": {
+        "anyOf": [
+          {
+            "items": {
+              "additionalProperties": {},
+              "properties": {
+                "date": {
+                  "type": "string"
+                },
+                "scheduled": {
+                  "type": [
+                    "boolean",
+                    "null"
+                  ]
+                },
+                "stage": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "stage",
+                "date",
+                "scheduled"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "oj_status_check": {
+        "anyOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "checked_on": {
+                "type": "string"
+              },
+              "oj_reference": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "stage": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "checked_on",
+              "stage",
+              "oj_reference"
+            ],
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "relationships": {
+        "anyOf": [
+          {
+            "items": {
+              "additionalProperties": {},
+              "properties": {
+                "direction": {
+                  "type": "string"
+                },
+                "effective_from": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "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"
+                  ]
+                },
+                "repealed_provisions": {
+                  "type": "string"
+                },
+                "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": {
+        "description": "`consolidated`: a EUR-Lex consolidation. `as_adopted`: a single document's text, amendments not incorporated. Not a legal status: a Council compromise text is `as_adopted` and not yet law; see `legal_status_at_release`.",
+        "type": "string"
+      },
+      "title": {
+        "type": "string"
+      },
+      "url": {
+        "type": "string"
+      },
+      "version_id": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "instrument_id",
+      "title",
+      "legal_status_at_release",
+      "oj_status_check",
+      "version_id",
+      "text_state",
+      "url",
+      "relationships",
+      "lifecycle_events"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

Changed1 schema field changedOct 14, 2026

changedInput schema / properties / instrument_id / pattern

Previous value: -"^[a-z0-9]+(?:-[a-z0-9]+)*$"New value: +"^[A-Za-z0-9]+(?:[ ._-][A-Za-z0-9]+)*$"

Changed1 schema field changedOct 5, 2026

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": {
-                  "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"
-  }
-]New value: +[
+  {
+    "additionalProperties": {},
+    "properties": {
+      "instrument_id": {
+        "type": "string"
+      },
+      "legal_status_at_release": {
+        "type": "string"
+      },
+      "lifecycle_events": {
+        "anyOf": [
+          {
+            "items": {
+              "additionalProperties": {},
+              "properties": {
+                "date": {
+                  "type": "string"
+                },
+                "scheduled": {
+                  "type": [
+                    "boolean",
+                    "null"
+                  ]
+                },
+                "stage": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "stage",
+                "date",
+                "scheduled"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "relationships": {
+        "anyOf": [
+          {
+            "items": {
+              "additionalProperties": {},
+              "properties": {
+                "direction": {
+                  "type": "string"
+                },
+                "effective_from": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "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"
+                  ]
+                },
+                "repealed_provisions": {
+                  "type": "string"
+                },
+                "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",
+      "lifecycle_events"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

Changed4 schema fields changedOct 4, 2026
- addedInput schema / properties / instrument_id / maxLength
```
Added value: +64
```
- addedInput schema / properties / instrument_id / pattern
```
Added value: +"^[a-z0-9]+(?:-[a-z0-9]+)*$"
```
- addedInput schema / properties / on_date / anyOf
```
Added value: +[
+  {
+    "maxLength": 32,
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]
```
- removedInput schema / properties / on_date / type
```
Removed value: -[
-  "string",
-  "null"
-]
```

Changed4 schema fields changedSep 20, 2026

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"
+  }
+]

First observedSep 6, 2026

TDQS

A4.2/5.0

Behavior4/5

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

Annotations already declare readOnly, idempotent, closed-world and non-destructive, so the safety profile is covered; the description adds real substance about what comes back (legal status, version, dates, lifecycle and application events, curated relationships naming the operative amending/repealing article). It stops short of noting pagination, size limits or edge cases such as unresolved instrument ids.

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?

Leads with the use case, then the content returned, then the exclusion and the on_date note — each sentence earns its place. The 'Metadata, dates, lifecycle...' fragment is dense but conveys substantive information rather than filler.

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

Completeness4/5

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

An output schema exists, so return shape need not be spelled out, and the description still characterizes the record's contents and the date-scoped variant. What's missing is any hint about how to obtain an instrument_id or what happens on an unknown id, which matters for the sole required parameter.

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% and the description only reinforces on_date ('the applicability record on that date'), which the schema already describes as returning the full applicability record. The required instrument_id — the one parameter that must be supplied — gets no explanation of accepted form or where ids come from, so the coverage gap is not compensated.

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 and resource ('check an EU instrument's recorded legal status, source version, dates and amendments') with concrete scope, including the proposal/Council compromise/OJ distinction. It also explicitly separates itself from the article-level sibling: 'No article index: use 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 Guidelines4/5

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

Opens with 'Use this to check...' and names one exclusion plus the alternative (list_provisions for an article index), and directs on_date usage. It does not distinguish against other plausible siblings such as list_instruments, compare_versions or get_provision, so the routing guidance is clear but not exhaustive.

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

All Payments Law — EU payments legislation tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?