gleif_find_by_registration_number
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/gleif_find_by_registration_number for the schema, then POST the same URL with its arguments for the data.
Legal entities holding a given company registration number, with LEI and issuing register, from the Global LEI Foundation.
Tool description as the model sees it
Reverse lookup: which company holds this state or national register number? Give a company registration number (a Delaware file number, a British company number, a French SIREN, a Norwegian organisation number and so on) and get back the LEI records in GLEIF that carry it, each with its LEI, legal name, status, jurisdiction, registered address, the register that issued the number (id and name) and the number itself.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
registration_number | string | yes | The company’s own register number, e.g. “10084845” (Delaware file number) or “00041424” (United Kingdom). |
registration_authority | string | no | Optional GLEIF registration authority id of the register that issued the number, “RA” + 6 digits, e.g. “RA000602” (Delaware), “RA000585” (United Kingdom). Bare digits are accepted. |
jurisdiction | string | no | Optional jurisdiction of the entity: ISO 3166-1 alpha-2 country (“GB”) or ISO 3166-2 region (“US-DE”). |
page_size | number | no | 1-100 matching records to return (default 25). |
Example call
Arguments
{
"registration_number": "10084845",
"jurisdiction": "US-DE"
}
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":"gleif_find_by_registration_number","arguments":{"registration_number":"10084845","jurisdiction":"US-DE"}}}'
TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('gleif_find_by_registration_number', {
"registration_number": "10084845",
"jurisdiction": "US-DE"
});
More examples
{
"registration_number": "00041424",
"registration_authority": "RA000585"
}
Response shape
Always returns: registration_number_asked, total_matches, records, note, source
| Field | Type | Description |
|---|---|---|
registration_number_asked | string | The number as received, after removing invisible marks and surrounding spaces |
registration_number_canonical | string | The number with all whitespace removed, used to compare against records |
registration_authority_filter | string | null | Register id filter applied, or null |
jurisdiction_filter | string | null | Jurisdiction filter applied, or null |
total_matches | number | Records whose register number equals the asked number |
returned | number | Records in this response |
truncated_upstream | boolean | True when GLEIF held more candidate rows than were read |
records | array | Matching LEI records; one row per LEI, labelled with its register |
note | string | Coverage caveat: a miss means no LEI under this number, not that no such company exists |
source | string | Publisher and dataset |
Full JSON Schema
{
"type": "object",
"properties": {
"registration_number_asked": {
"type": "string",
"description": "The number as received, after removing invisible marks and surrounding spaces"
},
"registration_number_canonical": {
"type": "string",
"description": "The number with all whitespace removed, used to compare against records"
},
"registration_authority_filter": {
"type": [
"string",
"null"
],
"description": "Register id filter applied, or null"
},
"jurisdiction_filter": {
"type": [
"string",
"null"
],
"description": "Jurisdiction filter applied, or null"
},
"total_matches": {
"type": "number",
"description": "Records whose register number equals the asked number"
},
"returned": {
"type": "number",
"description": "Records in this response"
},
"truncated_upstream": {
"type": "boolean",
"description": "True when GLEIF held more candidate rows than were read"
},
"records": {
"type": "array",
"description": "Matching LEI records; one row per LEI, labelled with its register",
"items": {
"type": "object",
"properties": {
"lei": {
"type": "string",
"description": "20-character LEI"
},
"legal_name": {
"type": [
"string",
"null"
],
"description": "Registered legal name"
},
"entity_status": {
"type": [
"string",
"null"
],
"description": "ACTIVE | INACTIVE | NULL"
},
"registration_status": {
"type": [
"string",
"null"
],
"description": "LEI registration status, e.g. ISSUED, LAPSED"
},
"jurisdiction": {
"type": [
"string",
"null"
],
"description": "Entity jurisdiction, e.g. US-DE"
},
"registered_as": {
"type": [
"string",
"null"
],
"description": "The number in the issuing register, whitespace removed"
},
"registration_authority": {
"type": [
"string",
"null"
],
"description": "GLEIF register id, e.g. RA000602"
},
"registration_authority_name": {
"type": [
"string",
"null"
],
"description": "Register name from the GLEIF registration authorities list"
},
"registration_authority_website": {
"type": [
"string",
"null"
],
"description": "Register website from the GLEIF list"
},
"legal_address": {
"type": [
"object",
"null"
],
"description": "Registered address: lines, city, region, country, postal_code"
},
"gleif_url": {
"type": "string",
"description": "GLEIF search page for the record"
}
},
"required": [
"lei",
"legal_name",
"registered_as",
"registration_authority"
]
}
},
"note": {
"type": "string",
"description": "Coverage caveat: a miss means no LEI under this number, not that no such company exists"
},
"source": {
"type": "string",
"description": "Publisher and dataset"
}
},
"required": [
"registration_number_asked",
"total_matches",
"records",
"note",
"source"
]
}
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.