get_lei_relationships
Pack: gleif · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)
No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/get_lei_relationships for the schema, then POST the same URL with its arguments for the data.
A legal entity’s parent and subsidiary relationships, by LEI, from the Global LEI Foundation.
Tool description as the model sees it
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.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
lei | string | yes | 20-character LEI code (e.g. “HWUPKR0MPOU8FGXBT394”) OR the company NAME (e.g. “Apple Inc”) \u2014 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. |
Example call
Arguments
{
"lei": "5493001KJTIIGC8Y1R12"
}curl
curl -X POST https://gateway.pipeworx.io/gleif/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_lei_relationships","arguments":{"lei":"5493001KJTIIGC8Y1R12"}}}'TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('get_lei_relationships', {
"lei": "5493001KJTIIGC8Y1R12"
});Response shape
Always returns: lei, direct_parent, ultimate_parent, direct_children
| Field | Type | Description |
|---|---|---|
lei | string | The LEI code for which relationships are retrieved |
direct_parent | object | null | Direct parent company record, if exists |
ultimate_parent | object | null | Ultimate parent company record, if exists |
direct_children | array | Direct child company records |
Full JSON Schema
{
"type": "object",
"properties": {
"lei": {
"type": "string",
"description": "The LEI code for which relationships are retrieved"
},
"direct_parent": {
"type": [
"object",
"null"
],
"description": "Direct parent company record, if exists",
"properties": {
"lei": {
"type": "string",
"description": "20-character LEI code"
},
"legal_name": {
"type": [
"string",
"null"
],
"description": "Official legal entity name"
},
"other_names": {
"type": "array",
"items": {
"type": "string"
},
"description": "Alternative names"
},
"jurisdiction": {
"type": [
"string",
"null"
],
"description": "ISO jurisdiction code"
},
"category": {
"type": [
"string",
"null"
],
"description": "Entity category"
},
"legal_form": {
"type": [
"string",
"null"
],
"description": "Legal form ID or description"
},
"registered_as": {
"type": [
"string",
"null"
],
"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."
},
"registration_authority": {
"type": [
"string",
"null"
],
"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."
},
"entity_status": {
"type": [
"string",
"null"
],
"description": "Entity status"
},
"registration_status": {
"type": [
"string",
"null"
],
"description": "Registration status"
},
"initial_registration": {
"type": [
"string",
"null"
],
"description": "ISO date of initial registration"
},
"last_update": {
"type": [
"string",
"null"
],
"description": "ISO date of last update"
},
"next_renewal": {
"type": [
"string",
"null"
],
"description": "ISO date of next renewal"
},
"managing_lou": {
"type": [
"string",
"null"
],
"description": "Managing Local Operating Unit"
},
"legal_address": {
"type": [
"object",
"null"
],
"description": "Legal address"
},
"headquarters_address": {
"type": [
"object",
"null"
],
"description": "Headquarters address"
},
"bic": {
"type": "array",
"items": {
"type": "string"
},
"description": "Bank Identifier Codes"
},
"isins": {
"type": "array",
"items": {
"type": "string"
},
"description": "ISIN codes"
},
"gleif_url": {
"type": "string",
"description": "Direct link to GLEIF record"
}
}
},
"ultimate_parent": {
"type": [
"object",
"null"
],
"description": "Ultimate parent company record, if exists",
"properties": {
"lei": {
"type": "string",
"description": "20-character LEI code"
},
"legal_name": {
"type": [
"string",
"null"
],
"description": "Official legal entity name"
},
"other_names": {
"type": "array",
"items": {
"type": "string"
},
"description": "Alternative names"
},
"jurisdiction": {
"type": [
"string",
"null"
],
"description": "ISO jurisdiction code"
},
"category": {
"type": [
"string",
"null"
],
"description": "Entity category"
},
"legal_form": {
"type": [
"string",
"null"
],
"description": "Legal form ID or description"
},
"registered_as": {
"type": [
"string",
"null"
],
"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."
},
"registration_authority": {
"type": [
"string",
"null"
],
"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."
},
"entity_status": {
"type": [
"string",
"null"
],
"description": "Entity status"
},
"registration_status": {
"type": [
"string",
"null"
],
"description": "Registration status"
},
"initial_registration": {
"type": [
"string",
"null"
],
"description": "ISO date of initial registration"
},
"last_update": {
"type": [
"string",
"null"
],
"description": "ISO date of last update"
},
"next_renewal": {
"type": [
"string",
"null"
],
"description": "ISO date of next renewal"
},
"managing_lou": {
"type": [
"string",
"null"
],
"description": "Managing Local Operating Unit"
},
"legal_address": {
"type": [
"object",
"null"
],
"description": "Legal address"
},
"headquarters_address": {
"type": [
"object",
"null"
],
"description": "Headquarters address"
},
"bic": {
"type": "array",
"items": {
"type": "string"
},
"description": "Bank Identifier Codes"
},
"isins": {
"type": "array",
"items": {
"type": "string"
},
"description": "ISIN codes"
},
"gleif_url": {
"type": "string",
"description": "Direct link to GLEIF record"
}
}
},
"direct_children": {
"type": "array",
"description": "Direct child company records",
"items": {
"type": "object",
"properties": {
"lei": {
"type": "string",
"description": "20-character LEI code"
},
"legal_name": {
"type": [
"string",
"null"
],
"description": "Official legal entity name"
},
"other_names": {
"type": "array",
"items": {
"type": "string"
},
"description": "Alternative names"
},
"jurisdiction": {
"type": [
"string",
"null"
],
"description": "ISO jurisdiction code"
},
"category": {
"type": [
"string",
"null"
],
"description": "Entity category"
},
"legal_form": {
"type": [
"string",
"null"
],
"description": "Legal form ID or description"
},
"registered_as": {
"type": [
"string",
"null"
],
"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."
},
"registration_authority": {
"type": [
"string",
"null"
],
"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."
},
"entity_status": {
"type": [
"string",
"null"
],
"description": "Entity status"
},
"registration_status": {
"type": [
"string",
"null"
],
"description": "Registration status"
},
"initial_registration": {
"type": [
"string",
"null"
],
"description": "ISO date of initial registration"
},
"last_update": {
"type": [
"string",
"null"
],
"description": "ISO date of last update"
},
"next_renewal": {
"type": [
"string",
"null"
],
"description": "ISO date of next renewal"
},
"managing_lou": {
"type": [
"string",
"null"
],
"description": "Managing Local Operating Unit"
},
"legal_address": {
"type": [
"object",
"null"
],
"description": "Legal address"
},
"headquarters_address": {
"type": [
"object",
"null"
],
"description": "Headquarters address"
},
"bic": {
"type": "array",
"items": {
"type": "string"
},
"description": "Bank Identifier Codes"
},
"isins": {
"type": "array",
"items": {
"type": "string"
},
"description": "ISIN codes"
},
"gleif_url": {
"type": "string",
"description": "Direct link to GLEIF record"
}
}
}
}
},
"required": [
"lei",
"direct_parent",
"ultimate_parent",
"direct_children"
]
}Connect
Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:
{
"mcpServers": {
"pipeworx": {
"url": "https://pipeworx.io/mcp"
}
}
}Connect to just the gleif pack
{
"mcpServers": {
"gleif": {
"url": "https://gateway.pipeworx.io/gleif/mcp"
}
}
}See Getting Started for client-specific install steps.