Gleif Mcp Server

by olgasafonova

238 downloads Not rated yet

GitHub Website

About

# GLEIF MCP Server A Model Context Protocol (MCP) server for accessing the Global Legal Entity Identifier (LEI) database via GLEIF's public API. [![CI](https://github.com/olgasafonova/gleif-mcp-server/actions/workflows/ci.yml/badge.svg)](https://github.com/olgasafonova/gleif-mcp-server/actions/workflows/ci.yml) [![Go…

Explore

- LEI Lookup: Get full entity details by LEI code
- Batch Lookup: Look up multiple LEIs in a single request (up to 100)
- Entity Search: Find companies by name with fuzzy matching and pagination
- LEI Validation: Verify format, check digits (ISO 17442), and registration status

go install github.com/olgasafonova/gleif-mcp-server@latest

> Quickest start: Using Claude Desktop? Just add the config below and restart. Using an IDE like Cursor? Same idea, different config file. Pick your tool below.

`lei_lookup`

Get full details for a specific LEI

`validate_lei`

Check format, check digits, and status

`batch_lei_lookup`

Look up multiple LEIs at once

`search_entity`

Search by company name

`search_by_bic`

Find LEI from BIC/SWIFT

`search_by_isin`

Find issuer LEI from ISIN

`search_by_country`

List entities by country

`autocomplete`

Entity name suggestions

`get_relationships`

Get corporate/fund relationships

`get_lei_issuer`

Get details about an LOU

`list_lei_issuers`

List all LOUs worldwide

`get_reporting_exceptions`

Get Level 2 reporting exceptions

| Tool | Description | Parameters |
|------|-------------|------------|
| lei_lookup | Get full details for a specific LEI | lei (required): 20-char LEI code |
| validate_lei | Check format, check digits, and status | lei (required): LEI to validate |
| batch_lei_lookup | Look up multiple LEIs at once | leis (required): Comma-separated LEIs (max 100) |

| Tool | Description | Parameters |
|------|-------------|------------|
| search_entity | Search by company name | query (required), limit (default 20), page (default 1), fuzzy (default true) |
| search_by_bic | Find LEI from BIC/SWIFT | bic (required): 8 or 11 char code |
| search_by_isin | Find issuer LEI from ISIN | isin (required): 12-char ISIN |
| search_by_country | List entities by country | country (required): ISO 2-letter code, limit (default 20) |
| autocomplete | Entity name suggestions | prefix (required): min 2 chars, limit (default 10) |

| Tool | Description | Parameters |
|------|-------------|------------|
| get_relationships | Get corporate/fund relationships | lei (required), type: direct-parent, ultimate-parent, children, fund-manager, umbrella-fund, sub-funds |

| Tool | Description | Parameters |
|------|-------------|------------|
| get_lei_issuer | Get details about an LOU | issuer_id (required): LOU identifier |
| list_lei_issuers | List all LOUs worldwide | None |

| Tool | Description | Parameters |
|------|-------------|------------|
| get_reporting_exceptions | Get Level 2 reporting exceptions | lei (required): LEI to check |

A Model Context Protocol (MCP) server for accessing the Global Legal Entity Identifier (LEI) database via GLEIF's public API.

What this does: Gives your AI assistant the ability to look up company identities, verify legal entities, and explore corporate ownership structures using the official GLEIF database. Works with Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, and other MCP-compatible tools. Ask questions in plain English; get structured answers instantly.

Use Cases

- KYC & Onboarding: Verify counterparty identities before signing contracts
- Compliance Checks: Validate LEIs for MiFID II, EMIR, or DORA reporting
- Due Diligence: Research corporate ownership chains and ultimate parents
- Financial Analysis: Cross-reference securities (ISIN) and banks (BIC/SWIFT) with their legal entities
- Data Enrichment: Batch-process company lists to add LEI data

What is LEI?

The Legal Entity Identifier (LEI) is a 20-character alphanumeric code that uniquely identifies legal entities participating in financial transactions worldwide. It's mandated by 200+ regulations including MiFID II, EMIR, Dodd-Frank, and DORA.

LEI Format (ISO 17442):
- Characters 1-4: LOU (Local Operating Unit) prefix
- Characters 5-18: Entity-specific identifier
- Characters 19-20: Check digits (mod 97 validation)

Example: HWUPKR0MPOU8FGXBT394 (Apple Inc.)

Features

Core Capabilities

- LEI Lookup: Get full entity details by LEI code - Batch Lookup: Look up multiple LEIs in a single request (up to 100) - Entity Search: Find companies by name with fuzzy matching and pagination - LEI Validation: Verify format, check digits (ISO 17442), and registration status

Financial Identifiers

- BIC/SWIFT Lookup: Find bank LEIs from BIC codes - ISIN Lookup: Find security issuer LEIs from ISIN codes - Country Browse: List entities by jurisdiction

Relationships & Compliance

- Corporate Ownership: Parent companies, subsidiaries, ultimate parents - Fund Relationships: Fund managers, umbrella funds, sub-funds - Reporting Exceptions: Level 2 data exceptions with reasons - LEI Issuers: List and details of all Local Operating Units (LOUs)

Performance & Reliability

- Fast Responses: Results are cached locally, so repeat queries return instantly - No API Key Needed: Works out of the box with GLEIF's public API - Handles Errors Gracefully: Automatic retries on timeouts or temporary failures - Stays Within Limits: Built-in rate limiting prevents hitting GLEIF's quotas

Installation

Download Binary

Pre-built binaries for all platforms on the releases page:

| Platform | Binary |
|----------|--------|
| macOS (Apple Silicon) | gleif-mcp-server-darwin-arm64 |
| macOS (Intel) | gleif-mcp-server-darwin-amd64 |
| Linux (x64) | gleif-mcp-server-linux-amd64 |
| Linux (ARM64) | gleif-mcp-server-linux-arm64 |
| Windows (x64) | gleif-mcp-server-windows-amd64.exe |

```bash

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Explore

lei_lookup

validate_lei

batch_lei_lookup

search_entity

search_by_bic

search_by_isin

search_by_country

autocomplete

get_relationships

get_lei_issuer

list_lei_issuers

get_reporting_exceptions