olgasafonova/gleif-mcp-server

Verify any company's legal identity in one question. Look up LEI codes, validate counterparties, and trace corporate ownership structures using the official GLEIF database. Covers 2.8M+ entities across 200+ jurisdictions.
**12 tools** for LEI lookup, entity search, BIC/SWIFT cross-referencing, corporate ownership, and batch validation. Works with Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, and other MCP-compatible tools.
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 |
Build from Source
Requires Go 1.25+:
Install via Go
AI Agent Setup
> **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.
Claude Desktop
Step 1: Download the binary
Go to the releases page and download the binary for your system:
- **Mac (Apple Silicon M1/M2/M3/M4):** gleif-mcp-server-darwin-arm64
- **Mac (Intel):** gleif-mcp-server-darwin-amd64
- **Windows:** gleif-mcp-server-windows-amd64.exe
Step 2: Mac only - allow the file to run
macOS blocks downloaded files. Open Terminal and run:
Step 3: Open the config file
**Mac:** Open Finder, press Cmd + Shift + G, paste this path:
**Windows:** Press Win + R, paste this path:
Open claude_desktop_config.json. If it doesn't exist, create it.
Step 4: Add the config
**Mac** (replace YOUR_USERNAME with your actual username):