Payments Law EU

Read EU legislative provision

get_provision

Read-onlyIdempotent

Use this to read or quote an EU legislative provision, such as PSD2 Article 97 or RTS-SCA Article 5. Returns the source text of an article, annex or recital as markdown, with its cite anchor, provenance and text-state disclosure. Large provisions paginate by structural block — never truncated silently. version_id is optional: the service serves one text per instrument, and a pinned version id is refused with the URL where it is published. include_correspondences adds the cross-instrument article equivalences — what a PSR article is amended from, or which PSR articles carry a PSD2 article's obligation — each openable by a second call.

Input Schema

TableJSON Schema

Name	Required	Description
`cursor`	No	Continue a paginated provision. Bound to the release.
`locator`	Yes
`on_date`	No	ISO date; returns the provision-level applicability view.
`version_id`	No	Omit, or pass "current", for the served text. A pinned version id returns version_not_served with the URL where that text is published.
`instrument_id`	Yes	Registry id of the instrument, e.g. "psd-2".
`include_correspondences`	No	Off by default. When true, an article carries `correspondences[]`: the cross-instrument article equivalences the corpus publishes — which PSD2 article a PSR article is amended from, and, from the other side, which PSR articles carry a PSD2 article's obligation. Each entry names the counterpart's own `get_provision` locator, version and cite anchor, so it opens with a second call. The relationship vocabulary is the analysis layer's own — `amended_from`, `supersedes` — plus the mechanical inverses of the reverse view, `amended_into` and `superseded_by`. An annex or a recital carries an empty list: correspondences are article-level: a request narrowed to a paragraph or a point still receives the whole article's mappings, and says so in a warning. `null` means the release predates the mapping table, which is not the same as an article having none. Where the corpus records a mapping this service will not serve — a correlation-table entry numbered against a superseded draft, or a counterpart absent from the served text — the list omits it and a `correspondence_withheld` warning names the instrument and the reason, so an empty or short list is never silently under-claimed.

Output Schema

TableJSON 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.

Changed22 schema fields changedSep 20, 2026

removedInput schema / properties / cursor / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedInput schema / properties / cursor / type
```
Added value: +[
+  "string",
+  "null"
+]
```

removedInput schema / properties / include_correspondences / anyOf

Removed value: -[
-  {
-    "type": "boolean"
-  },
-  {
-    "type": "null"
-  }
-]

addedInput schema / properties / include_correspondences / type
```
Added value: +[
+  "boolean",
+  "null"
+]
```

removedInput schema / properties / locator / properties / annex / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedInput schema / properties / locator / properties / annex / type
```
Added value: +[
+  "string",
+  "null"
+]
```

removedInput schema / properties / locator / properties / article / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedInput schema / properties / locator / properties / article / type
```
Added value: +[
+  "string",
+  "null"
+]
```

removedInput schema / properties / locator / properties / paragraph / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedInput schema / properties / locator / properties / paragraph / type
```
Added value: +[
+  "string",
+  "null"
+]
```

removedInput schema / properties / locator / properties / point / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedInput schema / properties / locator / properties / point / type
```
Added value: +[
+  "string",
+  "null"
+]
```

removedInput schema / properties / locator / properties / recital / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedInput schema / properties / locator / properties / recital / type
```
Added value: +[
+  "string",
+  "null"
+]
```

removedInput schema / properties / locator / properties / subpoint / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedInput schema / properties / locator / properties / subpoint / type
```
Added value: +[
+  "string",
+  "null"
+]
```

removedInput schema / properties / on_date / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedInput schema / properties / on_date / type
```
Added value: +[
+  "string",
+  "null"
+]
```

removedInput schema / properties / version_id / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedInput schema / properties / version_id / type
```
Added value: +[
+  "string",
+  "null"
+]
```

changedOutput schema / properties / data / anyOf

Previous value: -[
-  {
-    "additionalProperties": {},
-    "properties": {
-      "blocks_in_page": {
-        "type": "number"
-      },
-      "blocks_in_provision": {
-        "type": "number"
-      },
-      "blocks_total": {
-        "type": "number"
-      },
-      "cite": {
-        "type": "string"
-      },
-      "content_hash": {
-        "type": "string"
-      },
-      "correspondences": {
-        "anyOf": [
-          {
-            "items": {
-              "additionalProperties": {},
-              "properties": {
-                "derivation": {
-                  "type": "string"
-                },
-                "note": {
-                  "anyOf": [
-                    {
-                      "type": "string"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ]
-                },
-                "relationship": {
-                  "type": "string"
-                },
-                "target": {
-                  "additionalProperties": {},
-                  "properties": {
-                    "cite": {
-                      "type": "string"
-                    },
-                    "instrument_id": {
-                      "type": "string"
-                    },
-                    "locator": {
-                      "additionalProperties": false,
-                      "properties": {
-                        "annex": {
-                          "anyOf": [
-                            {
-                              "type": "string"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ],
-                          "description": "Annex number, roman or arabic (\"I\", \"1\"); omit for an instrument whose single annex is unnumbered."
-                        },
-                        "article": {
-                          "anyOf": [
-                            {
-                              "type": "string"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ],
-                          "description": "Article number as printed: \"97\", \"45a\", \"69-a\"."
-                        },
-                        "kind": {
-                          "description": "Which kind of provision the locator names.",
-                          "enum": [
-                            "article",
-                            "annex",
-                            "recital"
-                          ],
-                          "type": "string"
-                        },
-                        "paragraph": {
-                          "anyOf": [
-                            {
-                              "type": "string"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ],
-                          "description": "Numbered paragraph within the article, e.g. \"2\"."
-                        },
-                        "point": {
-                          "anyOf": [
-                            {
-                              "type": "string"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ],
-                          "description": "Lettered point within the paragraph, e.g. \"b\"."
-                        },
-                        "recital": {
-                          "anyOf": [
-                            {
-                              "type": "string"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ],
-                          "description": "Recital number, e.g. \"95\"."
-                        },
-                        "subpoint": {
-                          "anyOf": [
-                            {
-                              "type": "string"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ],
-                          "description": "Sub-point within the point."
-                        }
-                      },
-                      "required": [
-                        "kind"
-                      ],
-                      "type": "object"
-                    },
-                    "url": {
-                      "type": "string"
-                    },
-                    "version_id": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "instrument_id",
-                    "version_id",
-                    "cite",
-                    "url",
-                    "locator"
-                  ],
-                  "type": "object"
-                }
-              },
-              "required": [
-                "relationship",
-                "derivation",
-                "note",
-                "target"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "instrument_id": {
-        "type": "string"
-      },
-      "kind": {
-        "type": "string"
-      },
-      "markdown": {
-        "type": "string"
-      },
-      "narrowed": {
-        "type": "boolean"
-      },
-      "source_notes": {
-        "anyOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "complete": {
-                "const": true,
-                "description": "All notes referenced in this response's text, not the whole document or later pages.",
-                "type": "boolean"
-              },
-              "items": {
-                "items": {
-                  "additionalProperties": false,
-                  "properties": {
-                    "key": {
-                      "type": "string"
-                    },
-                    "marker": {
-                      "type": "string"
-                    },
-                    "text": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "key",
-                    "marker",
-                    "text"
-                  ],
-                  "type": "object"
-                },
-                "type": "array"
-              },
-              "scope": {
-                "const": "returned_text",
-                "type": "string"
-              },
-              "source_version_id": {
-                "type": "string"
-              }
-            },
-            "required": [
-              "scope",
-              "source_version_id",
-              "complete",
-              "items"
-            ],
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Null means unverified/unsupported coverage or an older release; consult the typed warning. Not an empty note inventory. Legal content_hash and block counts exclude this attachment."
-      },
-      "url": {
-        "type": "string"
-      },
-      "version_id": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "instrument_id",
-      "version_id",
-      "cite",
-      "kind",
-      "markdown",
-      "source_notes",
-      "narrowed",
-      "blocks_in_page",
-      "blocks_total",
-      "blocks_in_provision",
-      "content_hash",
-      "url"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": {},
+    "properties": {
+      "blocks_in_page": {
+        "type": "number"
+      },
+      "blocks_in_provision": {
+        "type": "number"
+      },
+      "blocks_total": {
+        "type": "number"
+      },
+      "cite": {
+        "type": "string"
+      },
+      "content_hash": {
+        "type": "string"
+      },
+      "correspondences": {
+        "anyOf": [
+          {
+            "items": {
+              "additionalProperties": {},
+              "properties": {
+                "derivation": {
+                  "type": "string"
+                },
+                "note": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "relationship": {
+                  "type": "string"
+                },
+                "target": {
+                  "additionalProperties": {},
+                  "properties": {
+                    "cite": {
+                      "type": "string"
+                    },
+                    "instrument_id": {
+                      "type": "string"
+                    },
+                    "locator": {
+                      "additionalProperties": false,
+                      "properties": {
+                        "annex": {
+                          "description": "Annex number, roman or arabic (\"I\", \"1\"); omit for an instrument whose single annex is unnumbered.",
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "article": {
+                          "description": "Article number as printed: \"97\", \"45a\", \"69-a\".",
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "kind": {
+                          "description": "Which kind of provision the locator names.",
+                          "enum": [
+                            "article",
+                            "annex",
+                            "recital"
+                          ],
+                          "type": "string"
+                        },
+                        "paragraph": {
+                          "description": "Numbered paragraph within the article, e.g. \"2\".",
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "point": {
+                          "description": "Lettered point within the paragraph, e.g. \"b\".",
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "recital": {
+                          "description": "Recital number, e.g. \"95\".",
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "subpoint": {
+                          "description": "Sub-point within the point.",
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        }
+                      },
+                      "required": [
+                        "kind"
+                      ],
+                      "type": "object"
+                    },
+                    "url": {
+                      "type": "string"
+                    },
+                    "version_id": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "instrument_id",
+                    "version_id",
+                    "cite",
+                    "url",
+                    "locator"
+                  ],
+                  "type": "object"
+                }
+              },
+              "required": [
+                "relationship",
+                "derivation",
+                "note",
+                "target"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "instrument_id": {
+        "type": "string"
+      },
+      "kind": {
+        "type": "string"
+      },
+      "markdown": {
+        "type": "string"
+      },
+      "narrowed": {
+        "type": "boolean"
+      },
+      "source_notes": {
+        "anyOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "complete": {
+                "const": true,
+                "description": "All notes referenced in this response's text, not the whole document or later pages.",
+                "type": "boolean"
+              },
+              "items": {
+                "items": {
+                  "additionalProperties": false,
+                  "properties": {
+                    "key": {
+                      "type": "string"
+                    },
+                    "marker": {
+                      "type": "string"
+                    },
+                    "text": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "key",
+                    "marker",
+                    "text"
+                  ],
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "scope": {
+                "const": "returned_text",
+                "type": "string"
+              },
+              "source_version_id": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "scope",
+              "source_version_id",
+              "complete",
+              "items"
+            ],
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Null means unverified/unsupported coverage or an older release; consult the typed warning. Not an empty note inventory. Legal content_hash and block counts exclude this attachment."
+      },
+      "url": {
+        "type": "string"
+      },
+      "version_id": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "instrument_id",
+      "version_id",
+      "cite",
+      "kind",
+      "markdown",
+      "source_notes",
+      "narrowed",
+      "blocks_in_page",
+      "blocks_total",
+      "blocks_in_provision",
+      "content_hash",
+      "url"
+    ],
+    "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.6/5.0

Behavior5/5

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

While annotations already declare readOnlyHint=true and idempotentHint=true, the description adds substantial non-obvious behavior: large provisions "paginate by structural block — never truncated silently," a pinned version_id "is refused with the URL where it is published," and the service serves "one text per instrument." For correspondences it discloses empty-vs-null semantics, article-level granularity with a warning on narrowed requests, and the correspondence_withheld condition so under-claiming is never silent. Nothing contradicts the annotations.

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 prose is dense but every sentence carries a distinct behavioral fact, and the long include_correspondences passage earns its length by documenting withholding, null, and granularity edge cases. It is appropriately sized for a 6-parameter tool with nested objects, though the correspondences section could be tightened without losing meaning.

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?

An output schema exists, so return-value documentation is not the description's job — and it still describes the markdown shape. All call-relevant behavior is covered: pagination guarantees, versioning/refusal policy, and correspondence edge cases. The only absence is explicit sibling routing, which is a minor gap against an otherwise complete definition.

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?

Schema coverage is 83%, so the schema already documents most parameters; the description compensates above that baseline for the two trickiest ones. version_id gains the "one text per instrument" rationale and refusal behavior, and include_correspondences gains its vocabulary, null-vs-empty meaning, and withholding rules. The locator sub-fields receive no extra description, but the schema covers them adequately.

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 and resource: "Use this to read or quote an EU legislative provision," with concrete examples (PSD2 Article 97, RTS-SCA Article 5) and the exact return payload (source text as markdown with cite anchor, provenance, and text-state disclosure). The single-provision scope distinguishes it from siblings such as list_provisions, get_instrument, and compare_versions without needing to open their schemas.

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?

It clearly states when to call it ("Use this to read or quote an EU legislative provision") and coaches the iterative pattern — correspondence entries are "each openable by a second call." However, it never names explicit alternatives or when-not conditions (e.g., when to prefer search_legislation or list_provisions), so it falls short of the explicit routing a 5 requires.

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 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?