`get_lei`

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 for the schema, then POST the same URL with its arguments for the data.

One legal entity’s registration record by its LEI code, from the Global LEI Foundation.

Tool description as the model sees it

Fetch the full Level 1 LEI record for a legal entity. Returns legal name, registered address, headquarters address, entity category, legal form, registration authority, LEI registration status (ISSUED / LAPSED / RETIRED / …), jurisdiction, parent LEI (if any), and timestamps.

Parameters

Name	Type	Required	Description
`lei`	string	yes	20-character LEI code (e.g. “HWUPKR0MPOU8FGXBT394”) OR the company NAME (e.g. “Wirecard AG”) — a name is resolved here automatically and the match is echoed back as resolved_from_name. Pass the name whenever that is what you were given; do not construct an LEI. A guessed 20-character code that happens to exist belongs to SOME OTHER COMPANY, and the record comes back looking perfectly valid — asking about Wirecard AG with a made-up code returned Baader Bank’s registration, with nothing in the response to show it was the wrong entity.

Example call

Arguments

{
  "lei": "Wirecard AG"
}

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","arguments":{"lei":"Wirecard AG"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('get_lei', {
  "lei": "Wirecard AG"
});

More examples

{
  "lei": "5493001KJTIIGC8Y1R12"
}

Response shape

Always returns: lei, legal_name, other_names, jurisdiction, category, legal_form, entity_status, registration_status, initial_registration, last_update, next_renewal, managing_lou, legal_address, headquarters_address, bic, isins, gleif_url

Field	Type	Description
`lei`	string	20-character LEI code
`legal_name`	string \| null	Official legal entity name
`other_names`	array	Alternative names for the entity
`jurisdiction`	string \| null	ISO jurisdiction code
`category`	string \| null	Entity category
`legal_form`	string \| null	Legal form ID or description
`registered_as`	string \| null	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`	string \| null	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`	string \| null	Entity status (ACTIVE, LAPSED, etc.)
`registration_status`	string \| null	Registration status
`initial_registration`	string \| null	ISO date of initial registration
`last_update`	string \| null	ISO date of last update
`next_renewal`	string \| null	ISO date of next renewal
`managing_lou`	string \| null	Managing Local Operating Unit
`legal_address`	object \| null	Legal address of entity
`headquarters_address`	object \| null	Headquarters address of entity
`bic`	array	Bank Identifier Codes
`isins`	array	ISIN codes
`gleif_url`	string	Direct link to GLEIF record

Full JSON Schema

{
  "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",
      "description": "Alternative names for the entity",
      "items": {
        "type": "string"
      }
    },
    "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 (ACTIVE, LAPSED, etc.)"
    },
    "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 of entity",
      "properties": {
        "lines": {
          "type": "array",
          "description": "Address lines",
          "items": {
            "type": "string"
          }
        },
        "city": {
          "type": [
            "string",
            "null"
          ],
          "description": "City name"
        },
        "region": {
          "type": [
            "string",
            "null"
          ],
          "description": "Region or state"
        },
        "country": {
          "type": [
            "string",
            "null"
          ],
          "description": "ISO country code"
        },
        "postal_code": {
          "type": [
            "string",
            "null"
          ],
          "description": "Postal code"
        }
      }
    },
    "headquarters_address": {
      "type": [
        "object",
        "null"
      ],
      "description": "Headquarters address of entity",
      "properties": {
        "lines": {
          "type": "array",
          "description": "Address lines",
          "items": {
            "type": "string"
          }
        },
        "city": {
          "type": [
            "string",
            "null"
          ],
          "description": "City name"
        },
        "region": {
          "type": [
            "string",
            "null"
          ],
          "description": "Region or state"
        },
        "country": {
          "type": [
            "string",
            "null"
          ],
          "description": "ISO country code"
        },
        "postal_code": {
          "type": [
            "string",
            "null"
          ],
          "description": "Postal code"
        }
      }
    },
    "bic": {
      "type": "array",
      "description": "Bank Identifier Codes",
      "items": {
        "type": "string"
      }
    },
    "isins": {
      "type": "array",
      "description": "ISIN codes",
      "items": {
        "type": "string"
      }
    },
    "gleif_url": {
      "type": "string",
      "description": "Direct link to GLEIF record"
    }
  },
  "required": [
    "lei",
    "legal_name",
    "other_names",
    "jurisdiction",
    "category",
    "legal_form",
    "entity_status",
    "registration_status",
    "initial_registration",
    "last_update",
    "next_renewal",
    "managing_lou",
    "legal_address",
    "headquarters_address",
    "bic",
    "isins",
    "gleif_url"
  ]
}

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.

get_lei