GLEIF MCP Server

Servidor MCP de GLEIF

Verifique la identidad legal de cualquier empresa con una sola pregunta. Consulte códigos LEI, valide contrapartes y trace estructuras de propiedad corporativa utilizando la base de datos oficial de GLEIF. Cubre más de 2,8 millones de entidades en más de 200 jurisdicciones.

12 herramientas para consulta de LEI, búsqueda de entidades, referencias cruzadas BIC/SWIFT, propiedad corporativa y validación por lotes. Funciona con Claude Desktop, Claude Code, Cursor, VS Code, Windsurf y otras herramientas compatibles con MCP.

Casos de Uso

• KYC e Incorporación: Verifique identidades de contrapartes antes de firmar contratos
• Verificaciones de Cumplimiento: Valide LEI para informes MiFID II, EMIR o DORA
• Debida Diligencia: Investigue cadenas de propiedad corporativa y matrices finales
• Análisis Financiero: Cruce referencias de valores (ISIN) y bancos (BIC/SWIFT) con sus entidades legales
• Enriquecimiento de Datos: Procese por lotes listas de empresas para agregar datos LEI

¿Qué es el LEI?

El Identificador de Entidad Legal (LEI) es un código alfanumérico de 20 caracteres que identifica de manera única a las entidades legales que participan en transacciones financieras en todo el mundo. Es obligatorio según más de 200 regulaciones, incluidas MiFID II, EMIR, Dodd-Frank y DORA.

Formato LEI (ISO 17442):

• Caracteres 1-4: Prefijo LOU (Unidad Operativa Local)
• Caracteres 5-18: Identificador específico de la entidad
• Caracteres 19-20: Dígitos de verificación (validación mod 97)

Ejemplo: HWUPKR0MPOU8FGXBT394 (Apple Inc.)

Características

Capacidades Principales

• Consulta de LEI: Obtenga detalles completos de la entidad por código LEI
• Consulta por Lotes: Consulte múltiples LEI en una sola solicitud (hasta 100)
• Búsqueda de Entidades: Encuentre empresas por nombre con coincidencia difusa y paginación
• Validación de LEI: Verifique formato, dígitos de verificación (ISO 17442) y estado de registro

Identificadores Financieros

• Consulta BIC/SWIFT: Encuentre LEI de bancos a partir de códigos BIC
• Consulta ISIN: Encuentre LEI de emisores de valores a partir de códigos ISIN
• Exploración por País: Liste entidades por jurisdicción

Relaciones y Cumplimiento

• Propiedad Corporativa: Empresas matrices, subsidiarias, matrices finales
• Relaciones de Fondos: Gestores de fondos, fondos paraguas, subfondos
• Excepciones de Informes: Excepciones de datos de Nivel 2 con razones
• Emisores de LEI: Lista y detalles de todas las Unidades Operativas Locales (LOU)

Rendimiento y Fiabilidad

• Respuestas Rápidas: Los resultados se almacenan en caché localmente, por lo que las consultas repetidas devuelven al instante
• Sin Necesidad de Clave API: Funciona directamente con la API pública de GLEIF
• Manejo Elegante de Errores: Reintentos automáticos en tiempos de espera o fallos temporales
• Dentro de los Límites: La limitación de velocidad integrada evita alcanzar las cuotas de GLEIF

Instalación

Descargar Binario

Binarios precompilados para todas las plataformas en la página de versiones:

Plataforma	Binario
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

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

Compilar desde el Código Fuente

Requiere Go 1.25+:

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

Instalar vía Go

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

Configuración para Agentes de IA

Inicio más rápido: ¿Usa Claude Desktop? Simplemente agregue la configuración a continuación y reinicie. ¿Usa un IDE como Cursor? Misma idea, archivo de configuración diferente. Elija su herramienta a continuación.

Claude Desktop

Paso 1: Descargue el binario

Vaya a la página de versiones y descargue el binario para su sistema:

• 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

Paso 2: Solo Mac - permita que el archivo se ejecute

macOS bloquea los archivos descargados. Abra Terminal y ejecute:

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

Paso 3: Abra el archivo de configuración

Mac: Abra Finder, presione Cmd + Shift + G, pegue esta ruta:

~/Library/Application Support/Claude/

Windows: Presione Win + R, pegue esta ruta:

%APPDATA%\Claude

Abra claude_desktop_config.json. Si no existe, créelo.

Paso 4: Agregue la configuración

Mac (reemplace SU_NOMBRE_DE_USUARIO con su nombre de usuario real):

{
  "mcpServers": {
    "gleif": {
      "command": "/Users/YOUR_USERNAME/Downloads/gleif-mcp-server-darwin-arm64"
    }
  }
}

Windows (reemplace SU_NOMBRE_DE_USUARIO - note las dobles barras invertidas):

{
  "mcpServers": {
    "gleif": {
      "command": "C:\\Users\\YOUR_USERNAME\\Downloads\\gleif-mcp-server-windows-amd64.exe"
    }
  }
}

Para encontrar su nombre de usuario: Mac - abra Terminal y escriba whoami. Windows - mire en C:\Users\.

Paso 5: Reinicie Claude Desktop

Salga completamente (Cmd + Q en Mac) y vuelva a abrir.

Paso 6: Pruébelo

Escriba en Claude Desktop:

Look up Apple's LEI using GLEIF

Debería ver a Claude llamar a la herramienta GLEIF y devolver datos de la empresa.

Claude Code (CLI)

# Add the server
claude mcp add gleif /path/to/gleif-mcp-server

# Or with scope for all projects
claude mcp add --scope user gleif /path/to/gleif-mcp-server

IDE Cursor

Agregue a .cursor/mcp.json en su proyecto o ~/.cursor/mcp.json para configuración global:

{
  "mcpServers": {
    "gleif": {
      "command": "/path/to/gleif-mcp-server"
    }
  }
}

VS Code con Extensión Continue

Agregue a .continue/config.json:

{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "name": "gleif",
        "transport": {
          "type": "stdio",
          "command": "/path/to/gleif-mcp-server"
        }
      }
    ]
  }
}

Windsurf

Agregue a ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "gleif": {
      "command": "/path/to/gleif-mcp-server"
    }
  }
}

Cline (Extensión de VS Code)

Agregue a través de la configuración MCP de Cline o en .vscode/cline_mcp_settings.json:

{
  "mcpServers": {
    "gleif": {
      "command": "/path/to/gleif-mcp-server",
      "args": []
    }
  }
}

Antigravity

Agregue a ~/.antigravity/mcp.json:

{
  "mcpServers": {
    "gleif": {
      "command": "/path/to/gleif-mcp-server"
    }
  }
}

¿No funciona? Cuéntenos qué fue difícil — incluso una frase ayuda.

Referencia de Herramientas

Herramientas de Consulta Principal

Herramienta	Descripción	Parámetros
lei_lookup	Obtenga detalles completos para un LEI específico	lei (obligatorio): código LEI de 20 caracteres
validate_lei	Verifique formato, dígitos de verificación y estado	lei (obligatorio): LEI a validar
batch_lei_lookup	Consulte múltiples LEI a la vez	leis (obligatorio): LEI separados por comas (máx. 100)

Herramientas de Búsqueda

Herramienta	Descripción	Parámetros
search_entity	Busque por nombre de empresa	query (obligatorio), limit (predeterminado 20), page (predeterminado 1), fuzzy (predeterminado true)
search_by_bic	Encuentre LEI a partir de BIC/SWIFT	bic (obligatorio): código de 8 u 11 caracteres
search_by_isin	Encuentre LEI del emisor a partir de ISIN	isin (obligatorio): ISIN de 12 caracteres
search_by_country	Liste entidades por país	country (obligatorio): código ISO de 2 letras, limit (predeterminado 20)
autocomplete	Sugerencias de nombres de entidades	prefix (obligatorio): mín. 2 caracteres, limit (predeterminado 10)

Herramientas de Relaciones

Herramienta	Descripción	Parámetros
get_relationships	Obtenga relaciones corporativas/de fondos	lei (obligatorio), type: direct-parent, ultimate-parent, children, fund-manager, umbrella-fund, sub-funds

Herramientas de Emisores de LEI

Herramienta	Descripción	Parámetros
get_lei_issuer	Obtenga detalles sobre una LOU	issuer_id (obligatorio): identificador de LOU
list_lei_issuers	Liste todas las LOU en todo el mundo	Ninguno

Herramientas de Cumplimiento

Herramienta	Descripción	Parámetros
get_reporting_exceptions	Obtenga excepciones de informes de Nivel 2	lei (obligatorio): LEI a verificar

Ejemplos de Uso

Consulta Básica de LEI

Solicitud: "Busque el LEI HWUPKR0MPOU8FGXBT394"

Devuelve: Detalles completos de la entidad para Apple Inc., incluidos nombre legal, dirección de la sede, jurisdicción (US-CA), estado de la entidad, estado de registro, LOU administradora y próxima fecha de renovación.

Búsqueda de Empresas con Paginación

Solicitud: "Busque Deutsche Bank, muestre la página 2"

Llamada a la herramienta:

{
  "name": "search_entity",
  "arguments": {
    "query": "Deutsche Bank",
    "limit": 20,
    "page": 2,
    "fuzzy": true
  }
}

Devuelve: Lista de entidades coincidentes con información de paginación (resultados totales, página actual, hay más).

Consulta de LEI por Lotes

Solicitud: "Busque estos LEI: HWUPKR0MPOU8FGXBT394, 5493006MHB84DD0ZWV18, 549300GKFG0RYRRQ1414"

Devuelve: Resumen de las tres entidades con LEI, nombre legal, país, ciudad y estado.

Encontrar Banco por BIC

Solicitud: "Encuentre el LEI para BIC DEUTDEFF"

Devuelve: Registro LEI de Deutsche Bank AG con detalles completos.

Encontrar Emisor de Valores

Solicitud: "¿Quién emitió el ISIN US0378331005?"

Devuelve: Apple Inc. (el emisor de la acción AAPL).

Estructura Corporativa

Solicitud: "¿Quién es la matriz final de esta subsidiaria?"

Llamada a la herramienta:

{
  "name": "get_relationships",
  "arguments": {
    "lei": "549300GKFG0RYRRQ1414",
    "type": "ultimate-parent"
  }
}

Validación de LEI

Solicitud: "¿Es válido el LEI HWUPKR0MPOU8FGXBT394?"

Devuelve:

{
  "lei": "HWUPKR0MPOU8FGXBT394",
  "valid": true,
  "status": "ISSUED",
  "entityStatus": "ACTIVE",
  "nextRenewal": "2025-08-15"
}

Verificar Excepciones de Informes

Solicitud: "¿Por qué falta la información de la matriz para esta empresa?"

Llamada a la herramienta:

{
  "name": "get_reporting_exceptions",
  "arguments": {
    "lei": "5493006MHB84DD0ZWV18"
  }
}

Devuelve: Categorías y razones de excepción (por ejemplo, NON_CONSOLIDATING, NATURAL_PERSONS).

Listar Todos los Emisores de LEI

Solicitud: "Muéstreme todos los emisores de LEI"

Devuelve: Lista completa de LOU (Unidades Operativas Locales) con nombre, país, estado y número de LEI patrocinados.

Formato de Respuesta

Todas las herramientas devuelven JSON con los campos relevantes. Ejemplo de registro de entidad:

{
  "lei": "HWUPKR0MPOU8FGXBT394",
  "legalName": "Apple Inc.",
  "country": "US",
  "city": "Cupertino",
  "status": "ACTIVE",
  "regStatus": "ISSUED"
}

Los resultados de búsqueda incluyen paginación:

{
  "count": 20,
  "results": [...],
  "pagination": {
    "currentPage": 1,
    "perPage": 20,
    "total": 156,
    "lastPage": 8
  },
  "hasMore": true
}

Manejo de Errores

El servidor devuelve errores estructurados:

Código de Error	Descripción	Reintentable
not_found	LEI/entidad no está en la base de datos de GLEIF	No
invalid_format	Formato de LEI/BIC/ISIN inválido	No
rate_limited	Límite de velocidad de API de GLEIF excedido	Sí
timeout	Tiempo de espera de solicitud agotado	Sí
server_error	Error de API de GLEIF	Depende del estado
network_error	Fallo de conexión	Sí

Ejemplo de respuesta de error:

{
  "code": "not_found",
  "message": "LEI not found in GLEIF database",
  "statusCode": 404,
  "retryable": false
}

Arquitectura

gleif-mcp-server/
├── main.go                 # Entry point, MCP server setup
├── internal/gleif/
│   ├── client.go          # GLEIF API client with caching & rate limiting
│   ├── client_test.go     # Client and validation tests
│   ├── cache.go           # LRU cache with TTL
│   ├── types.go           # Data structures for API responses
│   └── errors.go          # Structured error types
└── tools/
    ├── definitions.go     # Tool metadata and parameter specs
    ├── handlers.go        # MCP tool implementations
    └── handlers_test.go   # Handler tests with mock server

Detalles Técnicos

Para desarrolladores que quieren los detalles:

Configuración	Valor
Duración de caché	15 minutos
Capacidad de caché	1000 entidades, 500 búsquedas
Límite de velocidad	50 solicitudes/min (GLEIF permite 60)
Estrategia de reintentos	3 intentos con retroceso exponencial
Grupo de conexiones	100 máx. inactivas, 10 por host

Referencia de API

Este servidor envuelve la API pública de GLEIF:

• URL base: https://api.gleif.org/api/v1
• Autenticación: No se requiere
• Límite de velocidad: 60 solicitudes/minuto
• Documentación: https://www.gleif.org/en/lei-data/gleif-api

Solución de Problemas

El servidor no se inicia

• Verifique que el binario tenga permisos de ejecución: chmod +x gleif-mcp-server
• Verifique que la ruta en su configuración MCP sea absoluta, no relativa

Errores de "Límite de velocidad excedido"

• El servidor maneja automáticamente la limitación de velocidad con reintentos
• Si persiste, reduzca las solicitudes concurrentes o espere unos minutos

"LEI no encontrado" para un LEI válido

• La base de datos de GLEIF se actualiza diariamente; los LEI emitidos recientemente pueden no aparecer de inmediato
• Verifique el formato del LEI (exactamente 20 caracteres alfanuméricos)

Respuestas lentas

• Las primeras solicitudes pueden ser más lentas (calentamiento de caché)
• La API de GLEIF ocasionalmente tiene picos de latencia; los reintentos manejan esto automáticamente

Claude Desktop no muestra el servidor

• Reinicie Claude Desktop después de editar la configuración
• Verifique la sintaxis JSON en el archivo de configuración
• Verifique que la ruta del binario exista y sea ejecutable

Desarrollo

# Run tests
go test ./...

# Run tests with coverage
go test -coverprofile=coverage.out ./...
go tool cover -html=coverage.out

# Run tests with race detector
go test -race ./...

# Build
go build -o gleif-mcp-server .

Contribuciones

Las contribuciones son bienvenidas. Abra un issue primero para discutir los cambios propuestos.

Licencia

Licencia MIT - consulte LICENSE para más detalles.

Más Servidores MCP

Consulte mis otros servidores MCP:

Servidor	Descripción	Estrellas
mediawiki-mcp-server	Conecte IA a cualquier wiki de MediaWiki. Busque, lea, edite contenido de wiki.
miro-mcp-server	Controle pizarras Miro con IA. Pizarras, diagramas, mapas mentales y más.
nordic-registry-mcp-server	Acceda a registros comerciales nórdicos. Consulte empresas en Noruega, Dinamarca, Finlandia, Suecia.
productplan-mcp-server	Hable con sus hojas de ruta de ProductPlan. Consulte OKR, ideas, lanzamientos.
tilbudstrolden-mcp	Caza de ofertas de comestibles nórdicos. Encuentre ofertas, planifique comidas, controle gastos.

---

Agradecimientos

• GLEIF por la API pública de LEI
• Model Context Protocol por la especificación MCP