Skip to main content
Glama

sanctions-screening-mcp-server

sanctions-screening-mcp-server: trace ownership

sanctions_trace_ownership
Read-onlyIdempotent

Trace a paged GLEIF Level 2 ownership segment from a 20-character LEI (use sanctions_resolve_entity to obtain one). Direction both walks parents and children separately from the root, never sideways into siblings or co-parents; parents-side placement wins cycles. Ultimate-parent edges are shortcuts, never walked hops; ultimate-only nodes are flagged reachedVia: ultimate. Drain nextCursor with the same query, then re-root each boundary with its LEI, same-side direction and depth, including at depth five; deduplicate branch roots and edges across segments. Pages emit nodes, then edges, then boundaries: limit records each (50 default, 100 maximum), the last page the remainder. Edges reference nodes across assembled pages. Cursors bind query and topology; changed topology requires restarting without a cursor. Entity and screening values read current mirrors, not an immutable snapshot. Set screenNodes to cross-reference only this page of nodes as sanctions_get_entity does: legal, other and transliterated names strict (exact then all tokens present, a legal form matching any spelling of the same form, never fuzzy), LEI and country-matched registration number as exact non-document identifiers, with merged designation hits and matchedOn inputs. A node missing Level 1 is screened by LEI alone. Every hit is a candidate to verify; no hit is a clearance. Each eligible node retains direct and ultimate parentStatus: relationship, reporting exception and its reasons, none, or unknown when exceptions are not loaded. Read hasMore and truncationReasons separately from segment-wide missingEntityCount and page-local missingEntityLeis, screening counts and per-node ten-hit cap disclosures. A screening aid, not a compliance determination; a finished segment never proves full beneficial ownership.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "lei": "<lei>"
    },
    "name": "sanctions_trace_ownership"
  }
}

Input Schema

NameRequiredDescriptionDefault
leiYesThe 20-character GLEIF LEI at the root of the ownership graph.
depthNoMaximum traversal depth from the root entity (1–5), on each side of a both walk. Ultimate-parent edges do not count as hops.
limitNoRecords per page across nodes, edges and boundaries; every page but the last holds exactly this many (default 50, requests above 100 clamp with notice). Lower it for smaller pages: a screened node at its ten-hit cap is the largest record.
cursorNonextCursor from the preceding page, with the same query parameters. Omit to start a new segment.
directionNoWalk parents (who owns it), children (what it owns), or both (default): a parents walk plus a children walk from the root, each to depth, never into siblings or co-parents.both
screenNodesNoWhen true, cross-reference every returned node on this page against all watchlists: legal, other and transliterated names strict, LEI and country-matched registration number as identifiers. A node missing Level 1 has only its LEI lookup. Edge/boundary-only pages screen zero nodes.

Output Schema

NameRequiredDescriptionDefault
edgesNoThis page of directed edges. Endpoints refer to nodes in the assembled segment across pages, not necessarily this page.
errorNoPresent when the call failed. Absent on success.
nodesNoThis page of entities, ordered by depth then LEI. The root appears once, on the initial page.
caveatNoDecision-support caveat — node screening is an aid, not a determination.
noticeNoInput normalization notice when limit was clamped.
hasMoreNoMore records remain in this segment; false does not imply complete ownership.
rootLeiNoThe LEI the traversal started from.
completeNoLast page, no omitted branches, and missingEntityCount is zero. Check parentStatus for unknown parents. A finished segment does not establish full beneficial ownership.
truncatedNoMore pages or omitted branches. Drain nextCursor, then re-root each boundary with its LEI, side and depth, including depth five. An ultimate shortcut counts only if its far node is absent; siblings and co-parents are excluded.
boundariesNoThis page of omitted branch roots; trace each LEI with its direction and depth after draining this segment.
nextCursorNoContinue this segment with the same query and this cursor; absent on its last page.
totalAvailableNoExact number of stream records in this segment: nodes plus edges plus boundaries.
screeningStatusNoscreened = all page nodes screened (zero on edge-only pages); not_requested = screenNodes false; not_ready = mirror never synced and absence of hits is inconclusive.
flaggedNodeCountNoHow many screened nodes on this page had at least one potential watchlist match.
missingEntityLeisNoPage-local missing Level 1 nodes. They show their LEI as a name placeholder and omit jurisdiction/status. The LEI is looked up as an identifier, nothing else, so screenedInputs is empty. missingEntityCount spans the segment.
screenedNodeCountNoHow many nodes on this page were screened (zero on edge/boundary-only pages).
truncationReasonsNoIndependent reasons the current response is partial: remaining pages or omitted branches.
missingEntityCountNoNumber of nodes absent from Level 1 across the entire segment, including earlier and later pages.
totalAvailableBasisNoThe entire segment topology was enumerated to count its records.
reportingExceptionsLoadedNoWhether GLEIF reporting exceptions are loaded in the mirror. When false, a node's parent level with no published relationship reads unknown rather than exception or none.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed3 schema fields changed
    • changedInput schema / properties / limit / description
      Previous value: -"Maximum records across nodes, edges and boundaries per page (default 50, requests above 100 clamp with notice)."New value: +"Records per page across nodes, edges and boundaries; every page but the last holds exactly this many (default 50, requests above 100 clamp with notice). Lower it for smaller pages: a screened node at its ten-hit cap is the largest record."
    • changedOutput schema / anyOf
      Previous value: -[
      -  {
      -    "not": {
      -      "required": [
      -        "error"
      -      ]
      -    },
      -    "required": [
      -      "rootLei",
      -      "nodes",
      -      "edges",
      -      "boundaries",
      -      "totalAvailable",
      -      "totalAvailableBasis",
      -      "hasMore",
      -      "truncationReasons",
      -      "missingEntityCount",
      -      "byteTargetExceeded",
      -      "complete",
      -      "truncated",
      -      "reportingExceptionsLoaded",
      -      "missingEntityLeis",
      -      "screeningStatus",
      -      "screenedNodeCount",
      -      "flaggedNodeCount",
      -      "caveat"
      -    ]
      -  },
      -  {
      -    "required": [
      -      "error"
      -    ]
      -  }
      -]New value: +[
      +  {
      +    "not": {
      +      "required": [
      +        "error"
      +      ]
      +    },
      +    "required": [
      +      "rootLei",
      +      "nodes",
      +      "edges",
      +      "boundaries",
      +      "totalAvailable",
      +      "totalAvailableBasis",
      +      "hasMore",
      +      "truncationReasons",
      +      "missingEntityCount",
      +      "complete",
      +      "truncated",
      +      "reportingExceptionsLoaded",
      +      "missingEntityLeis",
      +      "screeningStatus",
      +      "screenedNodeCount",
      +      "flaggedNodeCount",
      +      "caveat"
      +    ]
      +  },
      +  {
      +    "required": [
      +      "error"
      +    ]
      +  }
      +]
    • removedOutput schema / properties / byteTargetExceeded
      Removed value: -{
      -  "description": "Serialized structuredContent plus content exceeds the soft 64-KiB target; indivisible records are retained intact.",
      -  "type": "boolean"
      -}
  2. Changed19 schema fields changed
    • changedInput schema / properties / lei / pattern
      Previous value: -"^[A-Z0-9]{18}[0-9]{2}$"New value: +"^[A-Za-z0-9]{18}[0-9]{2}$"
    • changedOutput schema / properties / complete / description
      Previous value: -"True only on the last page when no depth or ultimate-leaf boundary remains and every node in the entire segment has a Level 1 record (missingEntityCount is zero). It does not say every parent is known: read each node's parentStatus. A finished segment is never proof of full beneficial ownership."New value: +"Last page, no omitted branches, and missingEntityCount is zero. Check parentStatus for unknown parents. A finished segment does not establish full beneficial ownership."
    • changedOutput schema / properties / missingEntityLeis / description
      Previous value: -"This page of nodes absent from Level 1; missingEntityCount covers the whole segment. Their nodes carry the LEI in place of a legal name and no jurisdiction/status — never read that LEI as a legal name. A per-node screen is the LEI looked up as an identifier, nothing else: screenedInputs is empty and every hit is matchedOn their lei."New value: +"Page-local missing Level 1 nodes. They show their LEI as a name placeholder and omit jurisdiction/status. The LEI is looked up as an identifier, nothing else, so screenedInputs is empty. missingEntityCount spans the segment."
    • changedOutput schema / properties / nodes / items / properties / depth / description
      Previous value: -"Breadth-first depth from the root (root = 0), counted over every relationship type except IS_ULTIMATELY_CONSOLIDATED_BY. On a node flagged reachedVia: ultimate it counts that one ultimate hop instead, so it can be shallower than the direct chain to the node."New value: +"Breadth-first hops from root (0), excluding ultimate edges. An ultimate-only node counts its shortcut as one hop, possibly shorter than the direct chain."
    • changedOutput schema / properties / nodes / items / properties / parentStatus / description
      Previous value: -"What GLEIF publishes about this node's direct and ultimate accounting-consolidation parents. Present only on nodes whose parents the traversal read — every node short of the depth limit when direction is parents or both; absent on a children walk."New value: +"Direct and ultimate accounting-consolidation parent disclosures. Present only where the parents or both walk read parents before the depth limit."
    • changedOutput schema / properties / nodes / items / properties / reachedVia / description
      Previous value: -"Present (ultimate) when only an IS_ULTIMATELY_CONSOLIDATED_BY edge reaches this node within the depth. That edge is a shortcut to the top of the group, not a hop, so the node is a leaf: its own parents (on the parents side) or children (on the children side) are never walked, and truncated is true when any of them is not in this graph. A higher depth places it by direct links only when a direct chain from the root reaches it; where that chain is broken (a parent reported by exception, or not at all), no depth does."New value: +"Present for a node reached only by an ultimate shortcut. Its side stops here; omitted links set truncated. Increasing depth helps only if a direct chain from the root exists."
    • changedOutput schema / properties / nodes / items / properties / sanctionsHits / items / properties / matchType / description
      Previous value: -"Match classification of matchedName: exact or strong, never approximate (the cross-reference screens strict, never fuzzy). Absent when only an identifier produced the hit."New value: +"Exact or strong, never approximate. Absent for identifier-only hits."
    • changedOutput schema / properties / nodes / items / properties / sanctionsHits / items / properties / matchedIdentifiers / description
      Previous value: -"Every identifier the designation publishes that equals this node's LEI or its country-matched registration number, as published. Present only when an identifier produced the hit."New value: +"Published identifiers matching the LEI or country-matched registration number. Absent for name-only hits."
    • changedOutput schema / properties / nodes / items / properties / sanctionsHits / items / properties / matchedName / description
      Previous value: -"The designation's name or alias that matched one of this node's screened names — the strongest match. Absent when only an identifier produced the hit."New value: +"Strongest matching designation name or alias. Absent for identifier-only hits."
    • changedOutput schema / properties / nodes / items / properties / sanctionsHits / items / properties / matchedOn / description
      Previous value: -"Every input of this node that produced the hit — its legal name, an other or transliterated name, its LEI, or its registration number — in screening order. Only its LEI on a node in missingEntityLeis."New value: +"All matching name and identifier inputs, in screening order. Missing Level 1 nodes match only by LEI."
    • changedOutput schema / properties / nodes / items / properties / sanctionsHits / items / properties / score / description
      Previous value: -"Never set by this cross-reference: only an approximate (fuzzy) match carries a raw Jaro-Winkler score, and the cross-reference screens strict."New value: +"Never set here: the cross-reference uses strict matching."
    • changedOutput schema / properties / nodes / items / properties / sanctionsHits / items / properties / source / description
      Previous value: -"Watchlist whose record this hit is attributed to: primaryName comes from it. For an OFAC party both OFAC lists publish, ofac_sdn unless the Consolidated record matched alone or better, and matchedName, matchedIdentifiers, and matchedOn cover what either record matched; sources names every list."New value: +"Source of primaryName. Grouped OFAC hits use SDN unless Consolidated matched alone or better. Evidence and sources cover both records."
    • changedOutput schema / properties / nodes / items / properties / sanctionsScreen / description
      Previous value: -"Disclosure for this node's cross-reference: how many potential matches existed before the per-node cap, whether sanctionsHits is the complete set, and what was screened. Present only when the node was screened."New value: +"Per-node coverage and cap disclosure, present only when screened."
    • changedOutput schema / properties / nodes / items / properties / sanctionsScreen / properties / hasMore / description
      Previous value: -"True when this node's potential matches were capped — re-screen its names with sanctions_screen_name and look up its LEI and registration number with sanctions_screen_identifier to see the rest. A node in missingEntityLeis has no names: look up its LEI."New value: +"True if capped. Recover via sanctions_screen_name for names and sanctions_screen_identifier for LEI and registration number. For a missing Level 1 node, look up only its LEI."
    • changedOutput schema / properties / nodes / items / properties / sanctionsScreen / properties / screenedInputs / description
      Previous value: -"What the cross-reference screened beyond the legal name and the LEI, which it screens on every node with a Level 1 record: every other and transliterated name, then the registration number when the node publishes one (a not-available placeholder such as N/A is none) and a legal jurisdiction to match it by. Empty when there is nothing beyond those two, and always on a node in missingEntityLeis, which has no name and is looked up by its LEI alone."New value: +"Inputs beyond legal name and LEI: other and transliterated names, then a published registration number with jurisdiction, excluding placeholders such as N/A. Empty with no extras or no Level 1 record."
    • changedOutput schema / properties / nodes / items / properties / sanctionsScreen / properties / totalAvailable / description
      Previous value: -"Distinct designations this node's cross-reference found across every screened name and identifier, an OFAC party both OFAC lists publish counted once, before the per-node cap was applied."New value: +"Distinct designations before this node’s cap, grouping duplicate OFAC parties."
    • changedOutput schema / properties / nodes / items / properties / sanctionsScreen / properties / totalAvailableBasis / description
      Previous value: -"How to read totalAvailable. Always exact here: every name is screened strict, never fuzzy, and a strict screen counts every designation it reaches, so totalAvailable is the whole set across this node's screened names and identifiers."New value: +"Always exact: all strict name and exact identifier hits are counted."
    • changedOutput schema / properties / screeningStatus / description
      Previous value: -"Screening status for this page: screened = every returned node was screened (an edge-only page screens zero nodes); not_requested = screenNodes was false; not_ready = screening was requested but the sanctions mirror has never synced, so NO node was screened and an absence of hits says nothing about any node."New value: +"screened = all page nodes screened (zero on edge-only pages); not_requested = screenNodes false; not_ready = mirror never synced and absence of hits is inconclusive."
    • changedOutput schema / properties / truncated / description
      Previous value: -"True while this segment has more pages or has omitted depth-limit or ultimate-leaf branches; read truncationReasons. Drain nextCursor pages, then trace each boundary with its LEI, same-side direction and depth, including at depth five. An ultimate edge counts as a boundary only when its far node is absent. Siblings and co-parents are never walked and never count."New value: +"More pages or omitted branches. Drain nextCursor, then re-root each boundary with its LEI, side and depth, including depth five. An ultimate shortcut counts only if its far node is absent; siblings and co-parents are excluded."
  3. Changed25 schema fields changed
    • addedInput schema / properties / cursor
      Added value: +{
      +  "description": "nextCursor from the preceding page, with the same query parameters. Omit to start a new segment.",
      +  "type": "string"
      +}
    • addedInput schema / properties / limit
      Added value: +{
      +  "default": 50,
      +  "description": "Maximum records across nodes, edges and boundaries per page (default 50, requests above 100 clamp with notice).",
      +  "maximum": 9007199254740991,
      +  "minimum": 1,
      +  "type": "integer"
      +}
    • changedInput schema / properties / screenNodes / description
      Previous value: -"When true, cross-reference every node against all watchlists — the ownership-chain cross-reference: the node's legal, other, and transliterated names screened strict, and its LEI and country-matched registration number looked up as identifiers. A node with no Level 1 record has no names: its LEI lookup alone."New value: +"When true, cross-reference every returned node on this page against all watchlists: legal, other and transliterated names strict, LEI and country-matched registration number as identifiers. A node missing Level 1 has only its LEI lookup. Edge/boundary-only pages screen zero nodes."
    • changedOutput schema / anyOf
      Previous value: -[
      -  {
      -    "not": {
      -      "required": [
      -        "error"
      -      ]
      -    },
      -    "required": [
      -      "rootLei",
      -      "nodes",
      -      "edges",
      -      "complete",
      -      "truncated",
      -      "reportingExceptionsLoaded",
      -      "missingEntityLeis",
      -      "screeningStatus",
      -      "screenedNodeCount",
      -      "flaggedNodeCount",
      -      "caveat"
      -    ]
      -  },
      -  {
      -    "required": [
      -      "error"
      -    ]
      -  }
      -]New value: +[
      +  {
      +    "not": {
      +      "required": [
      +        "error"
      +      ]
      +    },
      +    "required": [
      +      "rootLei",
      +      "nodes",
      +      "edges",
      +      "boundaries",
      +      "totalAvailable",
      +      "totalAvailableBasis",
      +      "hasMore",
      +      "truncationReasons",
      +      "missingEntityCount",
      +      "byteTargetExceeded",
      +      "complete",
      +      "truncated",
      +      "reportingExceptionsLoaded",
      +      "missingEntityLeis",
      +      "screeningStatus",
      +      "screenedNodeCount",
      +      "flaggedNodeCount",
      +      "caveat"
      +    ]
      +  },
      +  {
      +    "required": [
      +      "error"
      +    ]
      +  }
      +]
    • addedOutput schema / properties / boundaries
      Added value: +{
      +  "description": "This page of omitted branch roots; trace each LEI with its direction and depth after draining this segment.",
      +  "items": {
      +    "additionalProperties": false,
      +    "description": "One omitted same-side branch, with executable inputs for a new trace segment.",
      +    "properties": {
      +      "depth": {
      +        "description": "Depth to pass to the new trace; its root restarts at depth zero.",
      +        "maximum": 5,
      +        "minimum": 1,
      +        "type": "integer"
      +      },
      +      "direction": {
      +        "description": "Walk only this side in the new segment.",
      +        "enum": [
      +          "parents",
      +          "children"
      +        ],
      +        "type": "string"
      +      },
      +      "lei": {
      +        "description": "Re-root this LEI to retrieve the omitted branch.",
      +        "type": "string"
      +      },
      +      "reason": {
      +        "description": "Why the original segment stopped this branch.",
      +        "enum": [
      +          "depth_limit",
      +          "ultimate_leaf"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "lei",
      +      "direction",
      +      "reason",
      +      "depth"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / byteTargetExceeded
      Added value: +{
      +  "description": "Serialized structuredContent plus content exceeds the soft 64-KiB target; indivisible records are retained intact.",
      +  "type": "boolean"
      +}
    • changedOutput schema / properties / complete / description
      Previous value: -"True when truncated is false (no loaded relationship on the walked side is left out) AND every node resolved to a GLEIF Level 1 record. It does not say every parent is known — most entities publish no parent relationship; read each node's parentStatus for what GLEIF publishes instead. False means the graph below is a partial view — read truncated and missingEntityLeis for which."New value: +"True only on the last page when no depth or ultimate-leaf boundary remains and every node in the entire segment has a Level 1 record (missingEntityCount is zero). It does not say every parent is known: read each node's parentStatus. A finished segment is never proof of full beneficial ownership."
    • changedOutput schema / properties / edges / description
      Previous value: -"Directed ownership edges between the nodes — every edge joins two nodes of this graph."New value: +"This page of directed edges. Endpoints refer to nodes in the assembled segment across pages, not necessarily this page."
    • changedOutput schema / properties / error / properties / data / properties / reason / description
      Previous value: -"Machine-readable failure mode. Declared by this tool: `lei_not_found`: No GLEIF entity in the mirror carries the root LEI, and its check digits are valid. `invalid_lei_checksum`: No GLEIF entity in the mirror carries the root LEI, and its ISO 17442 check digits fail. `mirror_not_ready`: The GLEIF (LEI) mirror has never completed an initial sync. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `invalid_cursor`: The cursor is corrupt, outside the stream, or belongs to different query parameters. `stale_cursor`: The recomputed segment topology differs from the cursor topology. `lei_not_found`: No GLEIF entity in the mirror carries the root LEI, and its check digits are valid. `invalid_lei_checksum`: No GLEIF entity in the mirror carries the root LEI, and its ISO 17442 check digits fail. `mirror_not_ready`: The GLEIF (LEI) mirror has never completed an initial sync. Other values are possible when a failure originates below the handler."
    • changedOutput schema / properties / error / properties / data / properties / reason / examples
      Previous value: -[
      -  "lei_not_found",
      -  "invalid_lei_checksum",
      -  "mirror_not_ready"
      -]New value: +[
      +  "invalid_cursor",
      +  "stale_cursor",
      +  "lei_not_found",
      +  "invalid_lei_checksum",
      +  "mirror_not_ready"
      +]
    • changedOutput schema / properties / flaggedNodeCount / description
      Previous value: -"How many screened nodes had at least one potential watchlist match."New value: +"How many screened nodes on this page had at least one potential watchlist match."
    • addedOutput schema / properties / hasMore
      Added value: +{
      +  "description": "More records remain in this segment; false does not imply complete ownership.",
      +  "type": "boolean"
      +}
    • addedOutput schema / properties / missingEntityCount
      Added value: +{
      +  "description": "Number of nodes absent from Level 1 across the entire segment, including earlier and later pages.",
      +  "maximum": 9007199254740991,
      +  "minimum": -9007199254740991,
      +  "type": "integer"
      +}
    • changedOutput schema / properties / missingEntityLeis / description
      Previous value: -"LEIs published in the relationship corpus but absent from the GLEIF Level 1 entity mirror. Their nodes carry the LEI in place of a legal name and no jurisdiction/status — never read that LEI as a legal name. A per-node screen for them is the LEI looked up as an identifier, nothing else: with no record there is no legal name, other name, or registration number to screen, so their screenedInputs is empty and each hit is matchedOn their lei."New value: +"This page of nodes absent from Level 1; missingEntityCount covers the whole segment. Their nodes carry the LEI in place of a legal name and no jurisdiction/status — never read that LEI as a legal name. A per-node screen is the LEI looked up as an identifier, nothing else: screenedInputs is empty and every hit is matchedOn their lei."
    • addedOutput schema / properties / nextCursor
      Added value: +{
      +  "description": "Continue this segment with the same query and this cursor; absent on its last page.",
      +  "type": "string"
      +}
    • changedOutput schema / properties / nodes / description
      Previous value: -"All entities reached in the traversal, including the root."New value: +"This page of entities, ordered by depth then LEI. The root appears once, on the initial page."
    • changedOutput schema / properties / nodes / items / properties / sanctionsHits / items / properties / source / enum
      Previous value: -[
      -  "ofac_sdn",
      -  "ofac_consolidated",
      -  "eu",
      -  "uk",
      -  "un"
      -]New value: +[
      +  "ofac_sdn",
      +  "ofac_consolidated",
      +  "eu",
      +  "uk",
      +  "un",
      +  "bis_el",
      +  "bis_dpl",
      +  "bis_uvl",
      +  "bis_meu",
      +  "state_dtc",
      +  "state_acn"
      +]
    • changedOutput schema / properties / nodes / items / properties / sanctionsHits / items / properties / sources / items / enum
      Previous value: -[
      -  "ofac_sdn",
      -  "ofac_consolidated",
      -  "eu",
      -  "uk",
      -  "un"
      -]New value: +[
      +  "ofac_sdn",
      +  "ofac_consolidated",
      +  "eu",
      +  "uk",
      +  "un",
      +  "bis_el",
      +  "bis_dpl",
      +  "bis_uvl",
      +  "bis_meu",
      +  "state_dtc",
      +  "state_acn"
      +]
    • addedOutput schema / properties / notice
      Added value: +{
      +  "description": "Input normalization notice when limit was clamped.",
      +  "type": "string"
      +}
    • changedOutput schema / properties / screenedNodeCount / description
      Previous value: -"How many nodes were screened (0 when screenNodes is false)."New value: +"How many nodes on this page were screened (zero on edge/boundary-only pages)."
    • changedOutput schema / properties / screeningStatus / description
      Previous value: -"Whether the per-node cross-reference ran: screened = every node was screened; not_requested = screenNodes was false; not_ready = screening was requested but the sanctions mirror has never synced, so NO node was screened and the absence of hits says nothing about any node."New value: +"Screening status for this page: screened = every returned node was screened (an edge-only page screens zero nodes); not_requested = screenNodes was false; not_ready = screening was requested but the sanctions mirror has never synced, so NO node was screened and an absence of hits says nothing about any node."
    • addedOutput schema / properties / totalAvailable
      Added value: +{
      +  "description": "Exact number of stream records in this segment: nodes plus edges plus boundaries.",
      +  "maximum": 9007199254740991,
      +  "minimum": -9007199254740991,
      +  "type": "integer"
      +}
    • addedOutput schema / properties / totalAvailableBasis
      Added value: +{
      +  "const": "exact",
      +  "description": "The entire segment topology was enumerated to count its records.",
      +  "type": "string"
      +}
    • changedOutput schema / properties / truncated / description
      Previous value: -"True when the loaded relationships hold ownership links on the walked side that this graph does not show: past the requested depth (re-run with a higher depth to see them), or the parents (or, on the children side, children) of a node flagged reachedVia: ultimate, which is never walked. An ultimate-parent edge counts only when it leads to an entity this graph does not return. False means neither: every chain the walk followed ends within the depth. Siblings and co-parents are never walked and never count."New value: +"True while this segment has more pages or has omitted depth-limit or ultimate-leaf branches; read truncationReasons. Drain nextCursor pages, then trace each boundary with its LEI, same-side direction and depth, including at depth five. An ultimate edge counts as a boundary only when its far node is absent. Siblings and co-parents are never walked and never count."
    • addedOutput schema / properties / truncationReasons
      Added value: +{
      +  "description": "Independent reasons the current response is partial: remaining pages or omitted branches.",
      +  "items": {
      +    "enum": [
      +      "page_limit",
      +      "depth_limit",
      +      "ultimate_leaf"
      +    ],
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
  4. Changed29 schema fields changed
    • changedInput schema / properties / depth / description
      Previous value: -"Maximum traversal depth from the root entity (1–5)."New value: +"Maximum traversal depth from the root entity (1–5), on each side of a both walk. Ultimate-parent edges do not count as hops."
    • changedInput schema / properties / direction / description
      Previous value: -"Walk parents (who owns it), children (what it owns), or both (default)."New value: +"Walk parents (who owns it), children (what it owns), or both (default): a parents walk plus a children walk from the root, each to depth, never into siblings or co-parents."
    • changedInput schema / properties / screenNodes / description
      Previous value: -"When true, screen every node's legal name against all watchlists — the ownership-chain cross-reference."New value: +"When true, cross-reference every node against all watchlists — the ownership-chain cross-reference: the node's legal, other, and transliterated names screened strict, and its LEI and country-matched registration number looked up as identifiers. A node with no Level 1 record has no names: its LEI lookup alone."
    • changedOutput schema / properties / complete / description
      Previous value: -"True when the loaded Level 2 relationships within the requested depth are all shown (nothing was cut off by depth) AND every node resolved to a GLEIF Level 1 record. It does not say every parent is known — most entities publish no parent relationship; read each node's parentStatus for what GLEIF publishes instead. False means the graph below is a partial view — read truncated and missingEntityLeis for which."New value: +"True when truncated is false (no loaded relationship on the walked side is left out) AND every node resolved to a GLEIF Level 1 record. It does not say every parent is known — most entities publish no parent relationship; read each node's parentStatus for what GLEIF publishes instead. False means the graph below is a partial view — read truncated and missingEntityLeis for which."
    • changedOutput schema / properties / edges / description
      Previous value: -"Directed ownership edges between the nodes."New value: +"Directed ownership edges between the nodes — every edge joins two nodes of this graph."
    • changedOutput schema / properties / error / properties / data / properties / reason / description
      Previous value: -"Machine-readable failure mode. Declared by this tool: `lei_not_found`: No GLEIF entity exists for the root LEI in the mirror. `mirror_not_ready`: The GLEIF (LEI) mirror has never completed an initial sync. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `lei_not_found`: No GLEIF entity in the mirror carries the root LEI, and its check digits are valid. `invalid_lei_checksum`: No GLEIF entity in the mirror carries the root LEI, and its ISO 17442 check digits fail. `mirror_not_ready`: The GLEIF (LEI) mirror has never completed an initial sync. Other values are possible when a failure originates below the handler."
    • changedOutput schema / properties / error / properties / data / properties / reason / examples
      Previous value: -[
      -  "lei_not_found",
      -  "mirror_not_ready"
      -]New value: +[
      +  "lei_not_found",
      +  "invalid_lei_checksum",
      +  "mirror_not_ready"
      +]
    • changedOutput schema / properties / missingEntityLeis / description
      Previous value: -"LEIs published in the relationship corpus but absent from the GLEIF Level 1 entity mirror. Their nodes carry the LEI in place of a legal name and no jurisdiction/status — never read that LEI as a legal name, and note any per-node screen for them ran against the LEI string."New value: +"LEIs published in the relationship corpus but absent from the GLEIF Level 1 entity mirror. Their nodes carry the LEI in place of a legal name and no jurisdiction/status — never read that LEI as a legal name. A per-node screen for them is the LEI looked up as an identifier, nothing else: with no record there is no legal name, other name, or registration number to screen, so their screenedInputs is empty and each hit is matchedOn their lei."
    • changedOutput schema / properties / nodes / items / properties / depth / description
      Previous value: -"Breadth-first depth from the root (root = 0)."New value: +"Breadth-first depth from the root (root = 0), counted over every relationship type except IS_ULTIMATELY_CONSOLIDATED_BY. On a node flagged reachedVia: ultimate it counts that one ultimate hop instead, so it can be shallower than the direct chain to the node."
    • changedOutput schema / properties / nodes / items / properties / parentStatus / properties / direct / properties / status / description
      Previous value: -"relationship = a Level 2 relationship at this level is published (see edges); exception = the entity filed a GLEIF reporting exception instead of naming this parent; none = GLEIF publishes neither; unknown = no relationship is published and reporting exceptions are not loaded in the mirror, so whether one was filed is unknown."New value: +"relationship = a Level 2 relationship at this level is published — it is in edges when that parent is also a node of this graph (a flagged leaf's parents and a children-side node's other parents are read for this status, never walked); exception = the entity filed a GLEIF reporting exception instead of naming this parent; none = GLEIF publishes neither; unknown = no relationship is published and reporting exceptions are not loaded in the mirror, so whether one was filed is unknown."
    • changedOutput schema / properties / nodes / items / properties / parentStatus / properties / ultimate / properties / status / description
      Previous value: -"relationship = a Level 2 relationship at this level is published (see edges); exception = the entity filed a GLEIF reporting exception instead of naming this parent; none = GLEIF publishes neither; unknown = no relationship is published and reporting exceptions are not loaded in the mirror, so whether one was filed is unknown."New value: +"relationship = a Level 2 relationship at this level is published — it is in edges when that parent is also a node of this graph (a flagged leaf's parents and a children-side node's other parents are read for this status, never walked); exception = the entity filed a GLEIF reporting exception instead of naming this parent; none = GLEIF publishes neither; unknown = no relationship is published and reporting exceptions are not loaded in the mirror, so whether one was filed is unknown."
    • addedOutput schema / properties / nodes / items / properties / reachedVia
      Added value: +{
      +  "description": "Present (ultimate) when only an IS_ULTIMATELY_CONSOLIDATED_BY edge reaches this node within the depth. That edge is a shortcut to the top of the group, not a hop, so the node is a leaf: its own parents (on the parents side) or children (on the children side) are never walked, and truncated is true when any of them is not in this graph. A higher depth places it by direct links only when a direct chain from the root reaches it; where that chain is broken (a parent reported by exception, or not at all), no depth does.",
      +  "enum": [
      +    "ultimate"
      +  ],
      +  "type": "string"
      +}
    • changedOutput schema / properties / nodes / items / properties / role / description
      Previous value: -"Position relative to the traversal."New value: +"root = the traced entity; parent = an ancestor, reached by walking parents; child = a descendant, reached by walking children. On a both walk, the side that reached the node — siblings and co-parents are never walked."
    • changedOutput schema / properties / nodes / items / properties / sanctionsHits / description
      Previous value: -"Per-node screening results, present only when screenNodes is true."New value: +"Per-node cross-reference results, one hit per designation (an OFAC party both OFAC lists publish once) — exact name and identifier matches first, then strong name matches. Present only when screenNodes is true."
    • changedOutput schema / properties / nodes / items / properties / sanctionsHits / items / properties / matchType / description
      Previous value: -"Match classification."New value: +"Match classification of matchedName: exact or strong, never approximate (the cross-reference screens strict, never fuzzy). Absent when only an identifier produced the hit."
    • addedOutput schema / properties / nodes / items / properties / sanctionsHits / items / properties / matchedIdentifiers
      Added value: +{
      +  "description": "Every identifier the designation publishes that equals this node's LEI or its country-matched registration number, as published. Present only when an identifier produced the hit.",
      +  "items": {
      +    "additionalProperties": false,
      +    "description": "An identifier the designation publishes that equals the entity's LEI, or its registration number published for the country of its legal jurisdiction.",
      +    "properties": {
      +      "country": {
      +        "description": "Issuing country as published, when published.",
      +        "type": "string"
      +      },
      +      "type": {
      +        "description": "Identifier label as the list publishes it (e.g. Legal Entity Number, Registration Number).",
      +        "type": "string"
      +      },
      +      "value": {
      +        "description": "The identifier value, as published.",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "value"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • changedOutput schema / properties / nodes / items / properties / sanctionsHits / items / properties / matchedName / description
      Previous value: -"The name/alias that matched this node."New value: +"The designation's name or alias that matched one of this node's screened names — the strongest match. Absent when only an identifier produced the hit."
    • addedOutput schema / properties / nodes / items / properties / sanctionsHits / items / properties / matchedOn
      Added value: +{
      +  "description": "Every input of this node that produced the hit — its legal name, an other or transliterated name, its LEI, or its registration number — in screening order. Only its LEI on a node in missingEntityLeis.",
      +  "items": {
      +    "additionalProperties": false,
      +    "description": "One value of the entity the cross-reference screened.",
      +    "properties": {
      +      "input": {
      +        "description": "Which value: legal_name, or other_name (an other or transliterated name), each screened as a name, strict; lei, or registration_number (the ID at the registration authority), each looked up as a non-document identifier.",
      +        "enum": [
      +          "legal_name",
      +          "other_name",
      +          "lei",
      +          "registration_number"
      +        ],
      +        "type": "string"
      +      },
      +      "nameType": {
      +        "description": "GLEIF's type for an other_name (e.g. TRADING_OR_OPERATING_NAME, AUTO_ASCII_TRANSLITERATED_LEGAL_NAME), or UNKNOWN for a name the mirror stored without one. Present on other_name only.",
      +        "type": "string"
      +      },
      +      "value": {
      +        "description": "The value as GLEIF publishes it.",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "input",
      +      "value"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • changedOutput schema / properties / nodes / items / properties / sanctionsHits / items / properties / score / description
      Previous value: -"Raw Jaro-Winkler similarity (0–1) for approximate hits only."New value: +"Never set by this cross-reference: only an approximate (fuzzy) match carries a raw Jaro-Winkler score, and the cross-reference screens strict."
    • changedOutput schema / properties / nodes / items / properties / sanctionsHits / items / properties / source / description
      Previous value: -"Watchlist the candidate is on."New value: +"Watchlist whose record this hit is attributed to: primaryName comes from it. For an OFAC party both OFAC lists publish, ofac_sdn unless the Consolidated record matched alone or better, and matchedName, matchedIdentifiers, and matchedOn cover what either record matched; sources names every list."
    • addedOutput schema / properties / nodes / items / properties / sanctionsHits / items / properties / sources
      Added value: +{
      +  "description": "Every screened list this candidate is on, in list order: one list, or ofac_sdn and ofac_consolidated together for an OFAC party both OFAC lists publish under one entry ID — one hit, not two. Read this, not source, for every list; the entry ID resolves in sanctions_get_designation under each.",
      +  "items": {
      +    "enum": [
      +      "ofac_sdn",
      +      "ofac_consolidated",
      +      "eu",
      +      "uk",
      +      "un"
      +    ],
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • changedOutput schema / properties / nodes / items / properties / sanctionsHits / items / required
      Previous value: -[
      -  "source",
      -  "sourceLabel",
      -  "sourceEntryId",
      -  "primaryName",
      -  "matchedName",
      -  "matchType"
      -]New value: +[
      +  "source",
      +  "sourceLabel",
      +  "sourceEntryId",
      +  "sources",
      +  "primaryName",
      +  "matchedOn"
      +]
    • changedOutput schema / properties / nodes / items / properties / sanctionsScreen / description
      Previous value: -"Disclosure for this node's cross-reference screen: how many potential matches existed before the per-node cap, and whether sanctionsHits is the complete set. Present only when the node was screened."New value: +"Disclosure for this node's cross-reference: how many potential matches existed before the per-node cap, whether sanctionsHits is the complete set, and what was screened. Present only when the node was screened."
    • changedOutput schema / properties / nodes / items / properties / sanctionsScreen / properties / hasMore / description
      Previous value: -"True when this node's potential matches were capped — screen its legal name with sanctions_screen_name to page through the rest."New value: +"True when this node's potential matches were capped — re-screen its names with sanctions_screen_name and look up its LEI and registration number with sanctions_screen_identifier to see the rest. A node in missingEntityLeis has no names: look up its LEI."
    • addedOutput schema / properties / nodes / items / properties / sanctionsScreen / properties / screenedInputs
      Added value: +{
      +  "description": "What the cross-reference screened beyond the legal name and the LEI, which it screens on every node with a Level 1 record: every other and transliterated name, then the registration number when the node publishes one (a not-available placeholder such as N/A is none) and a legal jurisdiction to match it by. Empty when there is nothing beyond those two, and always on a node in missingEntityLeis, which has no name and is looked up by its LEI alone.",
      +  "items": {
      +    "additionalProperties": false,
      +    "description": "One value of the entity the cross-reference screened.",
      +    "properties": {
      +      "input": {
      +        "description": "Which value: legal_name, or other_name (an other or transliterated name), each screened as a name, strict; lei, or registration_number (the ID at the registration authority), each looked up as a non-document identifier.",
      +        "enum": [
      +          "legal_name",
      +          "other_name",
      +          "lei",
      +          "registration_number"
      +        ],
      +        "type": "string"
      +      },
      +      "nameType": {
      +        "description": "GLEIF's type for an other_name (e.g. TRADING_OR_OPERATING_NAME, AUTO_ASCII_TRANSLITERATED_LEGAL_NAME), or UNKNOWN for a name the mirror stored without one. Present on other_name only.",
      +        "type": "string"
      +      },
      +      "value": {
      +        "description": "The value as GLEIF publishes it.",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "input",
      +      "value"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • changedOutput schema / properties / nodes / items / properties / sanctionsScreen / properties / totalAvailable / description
      Previous value: -"Potential matches this node's screen found before the per-node cap was applied."New value: +"Distinct designations this node's cross-reference found across every screened name and identifier, an OFAC party both OFAC lists publish counted once, before the per-node cap was applied."
    • changedOutput schema / properties / nodes / items / properties / sanctionsScreen / properties / totalAvailableBasis / description
      Previous value: -"How to read totalAvailable: exact = the complete strict match set for this node; lower_bound = a bounded scan produced it, so more may exist."New value: +"How to read totalAvailable. Always exact here: every name is screened strict, never fuzzy, and a strict screen counts every designation it reaches, so totalAvailable is the whole set across this node's screened names and identifiers."
    • changedOutput schema / properties / nodes / items / properties / sanctionsScreen / required
      Previous value: -[
      -  "totalAvailable",
      -  "totalAvailableBasis",
      -  "hasMore"
      -]New value: +[
      +  "totalAvailable",
      +  "totalAvailableBasis",
      +  "hasMore",
      +  "screenedInputs"
      +]
    • changedOutput schema / properties / truncated / description
      Previous value: -"True when further ownership relationships exist beyond the requested depth — re-run with a higher depth to see them. False means the traversal reached the edge of the loaded relationship corpus."New value: +"True when the loaded relationships hold ownership links on the walked side that this graph does not show: past the requested depth (re-run with a higher depth to see them), or the parents (or, on the children side, children) of a node flagged reachedVia: ultimate, which is never walked. An ultimate-parent edge counts only when it leads to an entity this graph does not return. False means neither: every chain the walk followed ends within the depth. Siblings and co-parents are never walked and never count."
  5. Changed5 schema fields changed
    • changedInput schema / properties / screenNodes / description
      Previous value: -"When true, screen every node's legal name against all watchlists for beneficial-ownership screening."New value: +"When true, screen every node's legal name against all watchlists — the ownership-chain cross-reference."
    • changedOutput schema / anyOf
      Previous value: -[
      -  {
      -    "not": {
      -      "required": [
      -        "error"
      -      ]
      -    },
      -    "required": [
      -      "rootLei",
      -      "nodes",
      -      "edges",
      -      "complete",
      -      "truncated",
      -      "missingEntityLeis",
      -      "screeningStatus",
      -      "screenedNodeCount",
      -      "flaggedNodeCount",
      -      "caveat"
      -    ]
      -  },
      -  {
      -    "required": [
      -      "error"
      -    ]
      -  }
      -]New value: +[
      +  {
      +    "not": {
      +      "required": [
      +        "error"
      +      ]
      +    },
      +    "required": [
      +      "rootLei",
      +      "nodes",
      +      "edges",
      +      "complete",
      +      "truncated",
      +      "reportingExceptionsLoaded",
      +      "missingEntityLeis",
      +      "screeningStatus",
      +      "screenedNodeCount",
      +      "flaggedNodeCount",
      +      "caveat"
      +    ]
      +  },
      +  {
      +    "required": [
      +      "error"
      +    ]
      +  }
      +]
    • changedOutput schema / properties / complete / description
      Previous value: -"True only when this is the full known ownership picture: nothing was cut off by the requested depth AND every node resolved to a GLEIF Level 1 record. False means the graph below is a partial view — read truncated and missingEntityLeis for which."New value: +"True when the loaded Level 2 relationships within the requested depth are all shown (nothing was cut off by depth) AND every node resolved to a GLEIF Level 1 record. It does not say every parent is known — most entities publish no parent relationship; read each node's parentStatus for what GLEIF publishes instead. False means the graph below is a partial view — read truncated and missingEntityLeis for which."
    • addedOutput schema / properties / nodes / items / properties / parentStatus
      Added value: +{
      +  "additionalProperties": false,
      +  "description": "What GLEIF publishes about this node's direct and ultimate accounting-consolidation parents. Present only on nodes whose parents the traversal read — every node short of the depth limit when direction is parents or both; absent on a children walk.",
      +  "properties": {
      +    "direct": {
      +      "additionalProperties": false,
      +      "description": "What GLEIF publishes about the direct parent.",
      +      "properties": {
      +        "exceptionReasons": {
      +          "description": "Every reason given in the reporting exception (e.g. NATURAL_PERSONS, NON_CONSOLIDATING, NO_KNOWN_PERSON). Present only when status is exception.",
      +          "items": {
      +            "type": "string"
      +          },
      +          "type": "array"
      +        },
      +        "status": {
      +          "description": "relationship = a Level 2 relationship at this level is published (see edges); exception = the entity filed a GLEIF reporting exception instead of naming this parent; none = GLEIF publishes neither; unknown = no relationship is published and reporting exceptions are not loaded in the mirror, so whether one was filed is unknown.",
      +          "enum": [
      +            "relationship",
      +            "exception",
      +            "none",
      +            "unknown"
      +          ],
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "status"
      +      ],
      +      "type": "object"
      +    },
      +    "ultimate": {
      +      "additionalProperties": false,
      +      "description": "What GLEIF publishes about the ultimate parent.",
      +      "properties": {
      +        "exceptionReasons": {
      +          "description": "Every reason given in the reporting exception (e.g. NATURAL_PERSONS, NON_CONSOLIDATING, NO_KNOWN_PERSON). Present only when status is exception.",
      +          "items": {
      +            "type": "string"
      +          },
      +          "type": "array"
      +        },
      +        "status": {
      +          "description": "relationship = a Level 2 relationship at this level is published (see edges); exception = the entity filed a GLEIF reporting exception instead of naming this parent; none = GLEIF publishes neither; unknown = no relationship is published and reporting exceptions are not loaded in the mirror, so whether one was filed is unknown.",
      +          "enum": [
      +            "relationship",
      +            "exception",
      +            "none",
      +            "unknown"
      +          ],
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "status"
      +      ],
      +      "type": "object"
      +    }
      +  },
      +  "required": [
      +    "direct",
      +    "ultimate"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / reportingExceptionsLoaded
      Added value: +{
      +  "description": "Whether GLEIF reporting exceptions are loaded in the mirror. When false, a node's parent level with no published relationship reads unknown rather than exception or none.",
      +  "type": "boolean"
      +}
  6. Changed6 schema fields changed
    • changedInput schema / $schema
      Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • addedInput schema / additionalProperties
      Added value: +false
    • changedOutput schema / $schema
      Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • addedOutput schema / anyOf
      Added value: +[
      +  {
      +    "not": {
      +      "required": [
      +        "error"
      +      ]
      +    },
      +    "required": [
      +      "rootLei",
      +      "nodes",
      +      "edges",
      +      "complete",
      +      "truncated",
      +      "missingEntityLeis",
      +      "screeningStatus",
      +      "screenedNodeCount",
      +      "flaggedNodeCount",
      +      "caveat"
      +    ]
      +  },
      +  {
      +    "required": [
      +      "error"
      +    ]
      +  }
      +]
    • addedOutput schema / properties / error
      Added value: +{
      +  "additionalProperties": {},
      +  "description": "Present when the call failed. Absent on success.",
      +  "properties": {
      +    "code": {
      +      "description": "JSON-RPC error code for this failure.",
      +      "maximum": 9007199254740991,
      +      "minimum": -9007199254740991,
      +      "type": "integer"
      +    },
      +    "data": {
      +      "additionalProperties": {},
      +      "properties": {
      +        "reason": {
      +          "description": "Machine-readable failure mode. Declared by this tool: `lei_not_found`: No GLEIF entity exists for the root LEI in the mirror. `mirror_not_ready`: The GLEIF (LEI) mirror has never completed an initial sync. Other values are possible when a failure originates below the handler.",
      +          "examples": [
      +            "lei_not_found",
      +            "mirror_not_ready"
      +          ],
      +          "type": "string"
      +        },
      +        "recovery": {
      +          "additionalProperties": {},
      +          "description": "Actionable next step for the caller.",
      +          "properties": {
      +            "hint": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "hint"
      +          ],
      +          "type": "object"
      +        },
      +        "retryable": {
      +          "description": "Whether retrying may succeed.",
      +          "type": "boolean"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "message": {
      +      "description": "Human-readable description of what went wrong.",
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "code",
      +    "message"
      +  ],
      +  "type": "object"
      +}
    • removedOutput schema / required
      Removed value: -[
      -  "rootLei",
      -  "nodes",
      -  "edges",
      -  "complete",
      -  "truncated",
      -  "missingEntityLeis",
      -  "screeningStatus",
      -  "screenedNodeCount",
      -  "flaggedNodeCount",
      -  "caveat"
      -]
  7. Changed6 schema fields changed
    • addedOutput schema / properties / complete
      Added value: +{
      +  "description": "True only when this is the full known ownership picture: nothing was cut off by the requested depth AND every node resolved to a GLEIF Level 1 record. False means the graph below is a partial view — read truncated and missingEntityLeis for which.",
      +  "type": "boolean"
      +}
    • addedOutput schema / properties / missingEntityLeis
      Added value: +{
      +  "description": "LEIs published in the relationship corpus but absent from the GLEIF Level 1 entity mirror. Their nodes carry the LEI in place of a legal name and no jurisdiction/status — never read that LEI as a legal name, and note any per-node screen for them ran against the LEI string.",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / nodes / items / properties / sanctionsScreen
      Added value: +{
      +  "additionalProperties": false,
      +  "description": "Disclosure for this node's cross-reference screen: how many potential matches existed before the per-node cap, and whether sanctionsHits is the complete set. Present only when the node was screened.",
      +  "properties": {
      +    "hasMore": {
      +      "description": "True when this node's potential matches were capped — screen its legal name with sanctions_screen_name to page through the rest.",
      +      "type": "boolean"
      +    },
      +    "totalAvailable": {
      +      "description": "Potential matches this node's screen found before the per-node cap was applied.",
      +      "maximum": 9007199254740991,
      +      "minimum": -9007199254740991,
      +      "type": "integer"
      +    },
      +    "totalAvailableBasis": {
      +      "description": "How to read totalAvailable: exact = the complete strict match set for this node; lower_bound = a bounded scan produced it, so more may exist.",
      +      "enum": [
      +        "exact",
      +        "lower_bound"
      +      ],
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "totalAvailable",
      +    "totalAvailableBasis",
      +    "hasMore"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / screeningStatus
      Added value: +{
      +  "description": "Whether the per-node cross-reference ran: screened = every node was screened; not_requested = screenNodes was false; not_ready = screening was requested but the sanctions mirror has never synced, so NO node was screened and the absence of hits says nothing about any node.",
      +  "enum": [
      +    "screened",
      +    "not_requested",
      +    "not_ready"
      +  ],
      +  "type": "string"
      +}
    • addedOutput schema / properties / truncated
      Added value: +{
      +  "description": "True when further ownership relationships exist beyond the requested depth — re-run with a higher depth to see them. False means the traversal reached the edge of the loaded relationship corpus.",
      +  "type": "boolean"
      +}
    • changedOutput schema / required
      Previous value: -[
      -  "rootLei",
      -  "nodes",
      -  "edges",
      -  "screenedNodeCount",
      -  "flaggedNodeCount",
      -  "caveat"
      -]New value: +[
      +  "rootLei",
      +  "nodes",
      +  "edges",
      +  "complete",
      +  "truncated",
      +  "missingEntityLeis",
      +  "screeningStatus",
      +  "screenedNodeCount",
      +  "flaggedNodeCount",
      +  "caveat"
      +]
  8. Changed2 schema fields changed
    • changedOutput schema / properties / nodes / items / properties / sanctionsHits / description
      Previous value: -"Per-node screening results, present only when screen_nodes is true."New value: +"Per-node screening results, present only when screenNodes is true."
    • changedOutput schema / properties / screenedNodeCount / description
      Previous value: -"How many nodes were screened (0 when screen_nodes is false)."New value: +"How many nodes were screened (0 when screenNodes is false)."
  9. First observed

TDQS

A4.6/5.0
Behavior5/5

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

Beyond readOnlyHint, idempotentHint, and openWorldHint=false, the description adds substantial behavioral context: direction does not walk into siblings or co-parents, parents-side placement wins cycles, ultimate-parent edges are shortcuts, cursors bind to query and topology, and values come from current mirrors rather than an immutable snapshot. It also discloses screening strictness, missing Level 1 handling, parentStatus values, and the limited evidentiary value of a finished segment.

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

Conciseness3/5

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

The description is front-loaded and almost every sentence carries substantive information, but it is delivered as one dense paragraph with no structural breaks. The high information density and long sentence chains make it harder for an agent to parse than a more segmented presentation would be.

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

Completeness5/5

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

Given the complexity and the existence of an output schema, the description is complete: it covers pagination behavior, cursor lifecycle, screening behavior, missing data indicators, parent status meanings, and a clear compliance caveat. An agent has enough information to invoke and interpret the tool correctly without additional documentation.

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

Parameters5/5

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

Schema coverage is already 100%, but the description adds operational meaning beyond the schema: direction semantics include cycle and sibling restrictions, depth excludes ultimate-parent hops, limit defines page composition across nodes/edges/boundaries, cursor binds to query and topology, and screenNodes specifies exact matching rules and per-node hit caps. These additions materially improve correct invocation.

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 opening sentence gives a specific verb and resource: tracing a paged GLEIF Level 2 ownership segment from a 20-character LEI. It also distinguishes this from the screening siblings by pointing to sanctions_resolve_entity for the LEI and describing ownership traversal rather than entity lookup or screening.

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?

The description gives strong procedural guidance: drain nextCursor with the same query, re-root boundaries with their LEI, and restart without a cursor when topology changes. It references sanctions_resolve_entity for obtaining an LEI and sanctions_get_entity for screening semantics, but it does not explicitly frame when to choose this tool over those siblings for the ownership task itself.

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.