GLEIF MCP Server

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.

29 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:

# macOS/Linux - download and make executable
chmod +x gleif-mcp-server-darwin-arm64

Build from Source

Requires Go 1.25+:

git clone https://github.com/olgasafonova/gleif-mcp-server.git
cd gleif-mcp-server
go build -o gleif-mcp-server .

Install via Go

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

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:

chmod +x ~/Downloads/gleif-mcp-server-darwin-arm64
xattr -d com.apple.quarantine ~/Downloads/gleif-mcp-server-darwin-arm64

Step 3: Open the config file

Mac: Open Finder, press Cmd + Shift + G, paste this path:

~/Library/Application Support/Claude/

Windows: Press Win + R, paste this path:

%APPDATA%\Claude

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): ```json