Servidor MCP GLEIF

Verifique a identidade legal de qualquer empresa com uma única pergunta. Consulte códigos LEI, valide contrapartes e rastreie estruturas de propriedade corporativa usando o banco de dados oficial da GLEIF. Abrange mais de 2,8 milhões de entidades em mais de 200 jurisdições.

12 ferramentas para consulta de LEI, busca de entidades, referência cruzada BIC/SWIFT, propriedade corporativa e validação em lote. Funciona com Claude Desktop, Claude Code, Cursor, VS Code, Windsurf e outras ferramentas compatíveis com MCP.

Casos de Uso

KYC e Onboarding: Verifique identidades de contrapartes antes de assinar contratos
Verificações de Conformidade: Valide LEIs para relatórios MiFID II, EMIR ou DORA
Due Diligence: Pesquise cadeias de propriedade corporativa e controladores finais
Análise Financeira: Faça referência cruzada de títulos (ISIN) e bancos (BIC/SWIFT) com suas entidades legais
Enriquecimento de Dados: Processe listas de empresas em lote para adicionar dados LEI

O que é LEI?

O Identificador de Entidade Legal (LEI) é um código alfanumérico de 20 caracteres que identifica exclusivamente entidades legais que participam de transações financeiras em todo o mundo. É exigido por mais de 200 regulamentações, incluindo MiFID II, EMIR, Dodd-Frank e DORA.

Formato LEI (ISO 17442):

Caracteres 1-4: Prefixo LOU (Unidade Operacional Local)
Caracteres 5-18: Identificador específico da entidade
Caracteres 19-20: Dígitos verificadores (validação mod 97)

Exemplo: HWUPKR0MPOU8FGXBT394 (Apple Inc.)

Recursos

Capacidades Principais

Consulta LEI: Obtenha detalhes completos da entidade pelo código LEI
Consulta em Lote: Consulte vários LEIs em uma única solicitação (até 100)
Busca de Entidades: Encontre empresas por nome com correspondência difusa e paginação
Validação LEI: Verifique formato, dígitos verificadores (ISO 17442) e status de registro

Identificadores Financeiros

Consulta BIC/SWIFT: Encontre LEIs de bancos a partir de códigos BIC
Consulta ISIN: Encontre LEIs de emissores de títulos a partir de códigos ISIN
Navegação por País: Liste entidades por jurisdição

Relacionamentos e Conformidade

Propriedade Corporativa: Empresas controladoras, subsidiárias, controladores finais
Relacionamentos de Fundos: Gestores de fundos, fundos guarda-chuva, subfundos
Exceções de Relatórios: Exceções de dados de Nível 2 com motivos
Emissores de LEI: Lista e detalhes de todas as Unidades Operacionais Locais (LOUs)

Desempenho e Confiabilidade

Respostas Rápidas: Os resultados são armazenados em cache localmente, então consultas repetidas retornam instantaneamente
Sem Necessidade de Chave de API: Funciona imediatamente com a API pública da GLEIF
Tratamento Elegante de Erros: Tentativas automáticas em timeouts ou falhas temporárias
Dentro dos Limites: Limitação de taxa integrada evita atingir as cotas da GLEIF

Instalação

Baixar Binário

Binários pré-compilados para todas as plataformas na página de versões:

Plataforma	Binário
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 a partir do Código Fonte

Requer Go 1.25+:

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

Instalar via Go

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

Configuração para Agentes de IA

Início mais rápido: Usa Claude Desktop? Basta adicionar a configuração abaixo e reiniciar. Usa uma IDE como Cursor? Mesma ideia, arquivo de configuração diferente. Escolha sua ferramenta abaixo.

Claude Desktop

Passo 1: Baixe o binário

Vá para a página de versões e baixe o binário para seu 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

Passo 2: Apenas Mac - permita que o arquivo seja executado

O macOS bloqueia arquivos baixados. Abra o Terminal e execute:

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

Passo 3: Abra o arquivo de configuração

Mac: Abra o Finder, pressione Cmd + Shift + G, cole este caminho:

~/Library/Application Support/Claude/

Windows: Pressione Win + R, cole este caminho:

%APPDATA%\Claude

Abra claude_desktop_config.json. Se não existir, crie-o.

Passo 4: Adicione a configuração

Mac (substitua SEU_NOME_DE_USUARIO pelo seu nome de usuário real):

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

Windows (substitua SEU_NOME_DE_USUARIO - observe as barras invertidas duplas):

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

Para encontrar seu nome de usuário: Mac - abra o Terminal e digite whoami. Windows - veja em C:\Users\.

Passo 5: Reinicie o Claude Desktop

Saia completamente (Cmd + Q no Mac) e reabra.

Passo 6: Teste

Digite no Claude Desktop:

Look up Apple's LEI using GLEIF

Você deve ver o Claude chamar a ferramenta GLEIF e retornar dados da 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

Adicione a .cursor/mcp.json no seu projeto ou ~/.cursor/mcp.json para configuração global:

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

VS Code com Extensão Continue

Adicione a .continue/config.json:

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

Windsurf

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

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

Cline (Extensão VS Code)

Adicione via configurações MCP do Cline ou em .vscode/cline_mcp_settings.json:

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

Antigravity

Adicione a ~/.antigravity/mcp.json:

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

Não está funcionando? Conte-nos o que dificultou — até uma frase ajuda.

Referência de Ferramentas

Ferramentas Principais de Consulta

Ferramenta	Descrição	Parâmetros
`lei_lookup`	Obtenha detalhes completos para um LEI específico	`lei` (obrigatório): código LEI de 20 caracteres
`validate_lei`	Verifique formato, dígitos verificadores e status	`lei` (obrigatório): LEI para validar
`batch_lei_lookup`	Consulte vários LEIs de uma vez	`leis` (obrigatório): LEIs separados por vírgula (máx. 100)

Ferramentas de Busca

Ferramenta	Descrição	Parâmetros
`search_entity`	Busque por nome da empresa	`query` (obrigatório), `limit` (padrão 20), `page` (padrão 1), `fuzzy` (padrão true)
`search_by_bic`	Encontre LEI a partir de BIC/SWIFT	`bic` (obrigatório): código de 8 ou 11 caracteres
`search_by_isin`	Encontre LEI do emissor a partir de ISIN	`isin` (obrigatório): ISIN de 12 caracteres
`search_by_country`	Liste entidades por país	`country` (obrigatório): código ISO de 2 letras, `limit` (padrão 20)
`autocomplete`	Sugestões de nomes de entidades	`prefix` (obrigatório): mín. 2 caracteres, `limit` (padrão 10)

Ferramentas de Relacionamento

Ferramenta	Descrição	Parâmetros
`get_relationships`	Obtenha relacionamentos corporativos/de fundos	`lei` (obrigatório), `type`: controlador-direto, controlador-final, subsidiárias, gestor-de-fundo, fundo-guarda-chuva, subfundos

Ferramentas de Emissores de LEI

Ferramenta	Descrição	Parâmetros
`get_lei_issuer`	Obtenha detalhes sobre uma LOU	`issuer_id` (obrigatório): identificador da LOU
`list_lei_issuers`	Liste todas as LOUs mundialmente	Nenhum

Ferramentas de Conformidade

Ferramenta	Descrição	Parâmetros
`get_reporting_exceptions`	Obtenha exceções de relatórios de Nível 2	`lei` (obrigatório): LEI para verificar

Exemplos de Uso

Consulta Básica de LEI

Prompt: "Consulte o LEI HWUPKR0MPOU8FGXBT394"

Retorna: Detalhes completos da entidade para Apple Inc., incluindo nome legal, endereço da sede, jurisdição (US-CA), status da entidade, status de registro, LOU gerenciadora e próxima data de renovação.

Busca de Empresa com Paginação

Prompt: "Busque por Deutsche Bank, mostre a página 2"

Chamada de ferramenta:

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

Retorna: Lista de entidades correspondentes com informações de paginação (total de resultados, página atual, há mais).

Consulta em Lote de LEI

Prompt: "Consulte estes LEIs: HWUPKR0MPOU8FGXBT394, 5493006MHB84DD0ZWV18, 549300GKFG0RYRRQ1414"

Retorna: Resumo das três entidades com LEI, nome legal, país, cidade e status.

Encontrar Banco por BIC

Prompt: "Encontre o LEI para o BIC DEUTDEFF"

Retorna: Registro LEI do Deutsche Bank AG com detalhes completos.

Encontrar Emissor de Título

Prompt: "Quem emitiu o ISIN US0378331005?"

Retorna: Apple Inc. (a emissora da ação AAPL).

Estrutura Corporativa

Prompt: "Quem é o controlador final desta subsidiária?"

Chamada de ferramenta:

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

Validação de LEI

Prompt: "O LEI HWUPKR0MPOU8FGXBT394 é válido?"

Retorna:

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

Verificar Exceções de Relatórios

Prompt: "Por que as informações do controlador estão ausentes para esta empresa?"

Chamada de ferramenta:

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

Retorna: Categorias e motivos de exceção (por exemplo, NON_CONSOLIDATING, NATURAL_PERSONS).

Listar Todos os Emissores de LEI

Prompt: "Mostre-me todos os emissores de LEI"

Retorna: Lista completa de LOUs (Unidades Operacionais Locais) com nome, país, status e número de LEIs patrocinados.

Formato de Resposta

Todas as ferramentas retornam JSON com campos relevantes. Exemplo de registro de entidade:

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

Os resultados de busca incluem paginação:

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

Tratamento de Erros

O servidor retorna erros estruturados:

Código de Erro	Descrição	Pode Repetir
`not_found`	LEI/entidade não está no banco de dados GLEIF	Não
`invalid_format`	Formato inválido de LEI/BIC/ISIN	Não
`rate_limited`	Limite de taxa da API GLEIF excedido	Sim
`timeout`	Solicitação expirou	Sim
`server_error`	Erro da API GLEIF	Depende do status
`network_error`	Falha de conexão	Sim

Exemplo de resposta de erro:

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

Arquitetura

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

Detalhes Técnicos

Para desenvolvedores que querem os detalhes:

Configuração	Valor
Duração do cache	15 minutos
Capacidade do cache	1000 entidades, 500 buscas
Limite de taxa	50 req/min (GLEIF permite 60)
Estratégia de repetição	3 tentativas com backoff exponencial
Pool de conexões	100 máx. ociosas, 10 por host

Referência da API

Este servidor encapsula a API pública da GLEIF:

URL Base: https://api.gleif.org/api/v1
Autenticação: Nenhuma necessária
Limite de Taxa: 60 solicitações/minuto
Documentação: https://www.gleif.org/en/lei-data/gleif-api

Solução de Problemas

O servidor não inicia

Verifique se o binário tem permissões de execução: chmod +x gleif-mcp-server
Verifique se o caminho na sua configuração MCP é absoluto, não relativo

Erros de "Limite de taxa excedido"

O servidor lida automaticamente com a limitação de taxa com repetições
Se persistir, reduza solicitações concorrentes ou aguarde alguns minutos

"LEI não encontrado" para LEI válido

O banco de dados GLEIF é atualizado diariamente; LEIs emitidos recentemente podem não aparecer imediatamente
Verifique o formato do LEI (exatamente 20 caracteres alfanuméricos)

Respostas lentas

As primeiras solicitações podem ser mais lentas (aquecimento do cache)
A API GLEIF ocasionalmente tem picos de latência; as repetições lidam com isso automaticamente

Claude Desktop não mostra o servidor

Reinicie o Claude Desktop após editar a configuração
Verifique a sintaxe JSON no arquivo de configuração
Verifique se o caminho do binário existe e é executável

Desenvolvimento

# 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 .

Contribuindo

Contribuições são bem-vindas. Por favor, abra uma issue primeiro para discutir as mudanças propostas.

Licença

Licença MIT - veja LICENSE para detalhes.

Mais Servidores MCP

Confira meus outros servidores MCP:

Servidor	Descrição	Estrelas
mediawiki-mcp-server	Conecte IA a qualquer wiki MediaWiki. Busque, leia, edite conteúdo de wiki.
miro-mcp-server	Controle quadros brancos Miro com IA. Quadros, diagramas, mapas mentais e mais.
nordic-registry-mcp-server	Acesse registros empresariais nórdicos. Consulte empresas na Noruega, Dinamarca, Finlândia, Suécia.
productplan-mcp-server	Fale com seus roadmaps ProductPlan. Consulte OKRs, ideias, lançamentos.
tilbudstrolden-mcp	Caça a ofertas de supermercado nórdicas. Encontre ofertas, planeje refeições, acompanhe gastos.

Agradecimentos

GLEIF pela API pública de LEI
Model Context Protocol pela especificação MCP

GLEIF MCP Server

Documentação