Skip to main content
Glama

Get Lei Relationships

get_lei_relationships
Read-onlyIdempotent

Fetch Level 2 corporate hierarchy for an LEI: direct parent, ultimate parent, and direct children. Use to map ownership trees across multinational groups. Accepts a company NAME as well as an LEI.

Example tool call

This call uses example arguments supplied in the tool’s input schema.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "lei": "5493001KJTIIGC8Y1R12"
    },
    "name": "get_lei_relationships"
  }
}

Input Schema

NameRequiredDescriptionDefault
leiYes20-character LEI code (e.g. "HWUPKR0MPOU8FGXBT394") OR the company NAME (e.g. "Apple Inc"), a name is resolved here automatically and the match is echoed back as resolved_from_name. Do not guess an LEI: a wrong-but-well-formed code used to return an empty hierarchy, which reads as "this company has no parent or subsidiaries" rather than as an error.

Output Schema

NameRequiredDescriptionDefault
leiYesThe LEI code for which relationships are retrieved
direct_parentYesDirect parent company record, if exists
direct_childrenYesDirect child company records
ultimate_parentYesUltimate parent company record, if exists

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / lei / description
      Previous value: -"20-character LEI code (e.g. \"HWUPKR0MPOU8FGXBT394\") OR the company NAME (e.g. \"Apple Inc\") — a name is resolved here automatically and the match is echoed back as resolved_from_name. Do not guess an LEI: a wrong-but-well-formed code used to return an empty hierarchy, which reads as \"this company has no parent or subsidiaries\" rather than as an error."New value: +"20-character LEI code (e.g. \"HWUPKR0MPOU8FGXBT394\") OR the company NAME (e.g. \"Apple Inc\"), a name is resolved here automatically and the match is echoed back as resolved_from_name. Do not guess an LEI: a wrong-but-well-formed code used to return an empty hierarchy, which reads as \"this company has no parent or subsidiaries\" rather than as an error."
  2. Changed6 schema fields changed
    • addedOutput schema / properties / direct_children / items / properties / registered_as
      Added value: +{
      +  "description": "The company's own id in its national business register (e.g. Companies House number 00041424, Norwegian orgnr 923609016), whitespace stripped so it joins. Null when GLEIF publishes no id, and withheld for sole proprietors. Pair it with registration_authority: an id is only unique within its register.",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / direct_children / items / properties / registration_authority
      Added value: +{
      +  "description": "GLEIF Registration Authority code for the register that registered_as belongs to: RA000585 = UK Companies House, RA000189 = INSEE Sirene, RA000413 = Japan NTA, RA000472 = Brønnøysund. RA999999 is GLEIF's \"other / not applicable\" sentinel and comes with no registered_as.",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / direct_parent / properties / registered_as
      Added value: +{
      +  "description": "The company's own id in its national business register (e.g. Companies House number 00041424, Norwegian orgnr 923609016), whitespace stripped so it joins. Null when GLEIF publishes no id, and withheld for sole proprietors. Pair it with registration_authority: an id is only unique within its register.",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / direct_parent / properties / registration_authority
      Added value: +{
      +  "description": "GLEIF Registration Authority code for the register that registered_as belongs to: RA000585 = UK Companies House, RA000189 = INSEE Sirene, RA000413 = Japan NTA, RA000472 = Brønnøysund. RA999999 is GLEIF's \"other / not applicable\" sentinel and comes with no registered_as.",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / ultimate_parent / properties / registered_as
      Added value: +{
      +  "description": "The company's own id in its national business register (e.g. Companies House number 00041424, Norwegian orgnr 923609016), whitespace stripped so it joins. Null when GLEIF publishes no id, and withheld for sole proprietors. Pair it with registration_authority: an id is only unique within its register.",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / ultimate_parent / properties / registration_authority
      Added value: +{
      +  "description": "GLEIF Registration Authority code for the register that registered_as belongs to: RA000585 = UK Companies House, RA000189 = INSEE Sirene, RA000413 = Japan NTA, RA000472 = Brønnøysund. RA999999 is GLEIF's \"other / not applicable\" sentinel and comes with no registered_as.",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
  3. Changed1 schema field changed
    • changedInput schema / properties / lei / description
      Previous value: -"20-character LEI code"New value: +"20-character LEI code (e.g. \"HWUPKR0MPOU8FGXBT394\") OR the company NAME (e.g. \"Apple Inc\") — a name is resolved here automatically and the match is echoed back as resolved_from_name. Do not guess an LEI: a wrong-but-well-formed code used to return an empty hierarchy, which reads as \"this company has no parent or subsidiaries\" rather than as an error."
  4. Changed2 schema fields changed
    • addedInput schema / examples
      Added value: +[
      +  {
      +    "lei": "5493001KJTIIGC8Y1R12"
      +  }
      +]
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "properties": {
      +    "direct_children": {
      +      "description": "Direct child company records",
      +      "items": {
      +        "properties": {
      +          "bic": {
      +            "description": "Bank Identifier Codes",
      +            "items": {
      +              "type": "string"
      +            },
      +            "type": "array"
      +          },
      +          "category": {
      +            "description": "Entity category",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "entity_status": {
      +            "description": "Entity status",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "gleif_url": {
      +            "description": "Direct link to GLEIF record",
      +            "type": "string"
      +          },
      +          "headquarters_address": {
      +            "description": "Headquarters address",
      +            "type": [
      +              "object",
      +              "null"
      +            ]
      +          },
      +          "initial_registration": {
      +            "description": "ISO date of initial registration",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "isins": {
      +            "description": "ISIN codes",
      +            "items": {
      +              "type": "string"
      +            },
      +            "type": "array"
      +          },
      +          "jurisdiction": {
      +            "description": "ISO jurisdiction code",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "last_update": {
      +            "description": "ISO date of last update",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "legal_address": {
      +            "description": "Legal address",
      +            "type": [
      +              "object",
      +              "null"
      +            ]
      +          },
      +          "legal_form": {
      +            "description": "Legal form ID or description",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "legal_name": {
      +            "description": "Official legal entity name",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "lei": {
      +            "description": "20-character LEI code",
      +            "type": "string"
      +          },
      +          "managing_lou": {
      +            "description": "Managing Local Operating Unit",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "next_renewal": {
      +            "description": "ISO date of next renewal",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "other_names": {
      +            "description": "Alternative names",
      +            "items": {
      +              "type": "string"
      +            },
      +            "type": "array"
      +          },
      +          "registration_status": {
      +            "description": "Registration status",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "direct_parent": {
      +      "description": "Direct parent company record, if exists",
      +      "properties": {
      +        "bic": {
      +          "description": "Bank Identifier Codes",
      +          "items": {
      +            "type": "string"
      +          },
      +          "type": "array"
      +        },
      +        "category": {
      +          "description": "Entity category",
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "entity_status": {
      +          "description": "Entity status",
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "gleif_url": {
      +          "description": "Direct link to GLEIF record",
      +          "type": "string"
      +        },
      +        "headquarters_address": {
      +          "description": "Headquarters address",
      +          "type": [
      +            "object",
      +            "null"
      +          ]
      +        },
      +        "initial_registration": {
      +          "description": "ISO date of initial registration",
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "isins": {
      +          "description": "ISIN codes",
      +          "items": {
      +            "type": "string"
      +          },
      +          "type": "array"
      +        },
      +        "jurisdiction": {
      +          "description": "ISO jurisdiction code",
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "last_update": {
      +          "description": "ISO date of last update",
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "legal_address": {
      +          "description": "Legal address",
      +          "type": [
      +            "object",
      +            "null"
      +          ]
      +        },
      +        "legal_form": {
      +          "description": "Legal form ID or description",
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "legal_name": {
      +          "description": "Official legal entity name",
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "lei": {
      +          "description": "20-character LEI code",
      +          "type": "string"
      +        },
      +        "managing_lou": {
      +          "description": "Managing Local Operating Unit",
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "next_renewal": {
      +          "description": "ISO date of next renewal",
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "other_names": {
      +          "description": "Alternative names",
      +          "items": {
      +            "type": "string"
      +          },
      +          "type": "array"
      +        },
      +        "registration_status": {
      +          "description": "Registration status",
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        }
      +      },
      +      "type": [
      +        "object",
      +        "null"
      +      ]
      +    },
      +    "lei": {
      +      "description": "The LEI code for which relationships are retrieved",
      +      "type": "string"
      +    },
      +    "ultimate_parent": {
      +      "description": "Ultimate parent company record, if exists",
      +      "properties": {
      +        "bic": {
      +          "description": "Bank Identifier Codes",
      +          "items": {
      +            "type": "string"
      +          },
      +          "type": "array"
      +        },
      +        "category": {
      +          "description": "Entity category",
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "entity_status": {
      +          "description": "Entity status",
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "gleif_url": {
      +          "description": "Direct link to GLEIF record",
      +          "type": "string"
      +        },
      +        "headquarters_address": {
      +          "description": "Headquarters address",
      +          "type": [
      +            "object",
      +            "null"
      +          ]
      +        },
      +        "initial_registration": {
      +          "description": "ISO date of initial registration",
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "isins": {
      +          "description": "ISIN codes",
      +          "items": {
      +            "type": "string"
      +          },
      +          "type": "array"
      +        },
      +        "jurisdiction": {
      +          "description": "ISO jurisdiction code",
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "last_update": {
      +          "description": "ISO date of last update",
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "legal_address": {
      +          "description": "Legal address",
      +          "type": [
      +            "object",
      +            "null"
      +          ]
      +        },
      +        "legal_form": {
      +          "description": "Legal form ID or description",
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "legal_name": {
      +          "description": "Official legal entity name",
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "lei": {
      +          "description": "20-character LEI code",
      +          "type": "string"
      +        },
      +        "managing_lou": {
      +          "description": "Managing Local Operating Unit",
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "next_renewal": {
      +          "description": "ISO date of next renewal",
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "other_names": {
      +          "description": "Alternative names",
      +          "items": {
      +            "type": "string"
      +          },
      +          "type": "array"
      +        },
      +        "registration_status": {
      +          "description": "Registration status",
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        }
      +      },
      +      "type": [
      +        "object",
      +        "null"
      +      ]
      +    }
      +  },
      +  "required": [
      +    "lei",
      +    "direct_parent",
      +    "ultimate_parent",
      +    "direct_children"
      +  ],
      +  "type": "object"
      +}
  5. First observed

TDQS

A3.7/5.0
Behavior4/5

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

Annotations already declare readOnly, idempotent, non-destructive and open-world, so safety is covered. The description adds real behavioral context beyond that by pinning the result depth to Level 2 (direct parent, ultimate parent, direct children), which tells an agent this is not a recursive traversal. It does not discuss the empty-result failure mode or name resolution echoing, but those live in the schema.

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?

Three compact sentences with the content-bearing definition first and secondary facts after. The middle usage sentence is slightly promotional ('across multinational groups') but still carries routing value, and nothing is redundant.

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

Completeness4/5

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

For a single-parameter read tool with full annotations and an output schema, the description covers what is fetched and at what depth, which is what an agent needs before calling. The remaining gaps, mainly absence of sibling disambiguation, are minor given the structured fields already present.

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

Parameters3/5

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

Schema coverage is 100% and the single 'lei' parameter already documents the LEI-vs-company-name duality, the resolved_from_name echo, and the danger of guessing a well-formed but wrong code. The description only restates the name acceptance, so it adds little beyond the schema; baseline 3 applies.

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

Purpose4/5

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

States a specific verb and resource plus the exact scope of the response: direct parent, ultimate parent, and direct children, framed as 'Level 2'. This tells an agent precisely what depth of hierarchy is returned, though it does not name or distinguish itself from plausible siblings such as lei_hierarchy_tree or gleif_group_members.

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

Usage Guidelines3/5

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

Provides one positive use case ('map ownership trees across multinational groups') which implies the context for calling it. There is no guidance on when not to use it, and no routing to an alternative tool when a full recursive tree or group membership list is actually needed.

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.