search_lei
Pack: gleif · Endpoint: https://gateway.pipeworx.io/gleif/mcp
Search the GLEIF LEI registry by legal entity name. Returns matched entities with their 20-character LEI, jurisdiction, status, and BIC/ISIN cross-references. Use the LEI to resolve canonical identity across SEC, OpenSanctions, and counterparty databases.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
query | string | yes | Legal entity name (full or partial), e.g. “Apple Inc.” or “Siemens Aktiengesellschaft” |
country | string | no | Restrict to the legal address country. ISO 3166-1 alpha-2, e.g. “US”, “DE”, “JP”. Alpha-3 codes and country names are accepted for the common jurisdictions and converted; anything unrecognized is rejected with an error rather than silently returning zero rows. |
status | string | no | Entity status (ACTIVE | INACTIVE | NULL) or LEI registration status (ISSUED | LAPSED | ANNULLED | PENDING_TRANSFER | PENDING_ARCHIVAL | DUPLICATE | RETIRED | MERGED). GLEIF keeps these in two different fields; the tool routes the value to the right one. “LAPSED” means the LEI registration lapsed, not that the company is gone. |
page_size | number | no | 1-200 (default 25) |
Example call
Arguments
{
"query": "Apple Inc"
}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":"search_lei","arguments":{"query":"Apple Inc"}}}'TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('search_lei', {
"query": "Apple Inc"
});More examples
{
"query": "Deutsche Bank",
"country": "DE",
"status": "ACTIVE",
"page_size": 50
}Response shape
Always returns: total, results
| Field | Type | Description |
|---|---|---|
total | number | Total number of matching LEI records |
results | array | Matched LEI records with normalized fields |
Full JSON Schema
{
"type": "object",
"properties": {
"total": {
"type": "number",
"description": "Total number of matching LEI records"
},
"results": {
"type": "array",
"description": "Matched LEI records with normalized fields",
"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",
"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"
},
"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": [
"total",
"results"
]
}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.