get_lei_relationships
Pack: gleif · Endpoint: https://gateway.pipeworx.io/gleif/mcp
Fetch Level 2 corporate hierarchy for an LEI: direct parent, ultimate parent, and direct children. Use to map ownership trees across multinational groups.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
lei | string | yes | 20-character LEI code |
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"
},
"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"
},
"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"
},
"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, or use one-click install buttons:
{
"mcpServers": {
"gleif": {
"url": "https://gateway.pipeworx.io/gleif/mcp"
}
}
}See Getting Started for client-specific install steps.