Gleif

@pipeworx/gleif

全球法人识别编码基金会 MCP — LEI 查询、ISIN/BIC 到实体的映射，以及企业层级关系，无需身份验证。

这是 Pipeworx 的一部分——一个将 AI Agent 连接到 1879+ 个实时数据源的 MCP 网关。这是一个独立的非官方集成，与上游提供方无关联、未获其认可，也不是由其发布。

工具

• search_lei(query, country?, status?, page_size?) — 按实体名称模糊搜索。如果 country 将结果缩小到无匹配项，则会移除该筛选条件，并通过 country_filter_dropped 说明这一点。GLEIF 根据注册法定地址筛选，而该地址往往不是实体实际运营的地点（没有名称中含 Sberbank 且注册地址位于俄罗斯的记录；这些记录位于 CY/SK/LU/GB）。
• get_lei(lei) — 完整的一级记录：法定名称、地址、管辖区、法律形式和 LEI 注册状态。除了 20 个字符的 LEI，也接受公司名称；解析出的名称会通过 resolved_from_name 返回。legal_form 和 registration_authority 会尽力在行内解码为 legal_form_decoded / registration_authority_decoded（参见下文的 decode_elf_code / decode_registration_authority）——解码失败不会影响基础记录，原始代码始终会保留。 **registered_as + registration_authority（适用于 get_lei 和每个 search_lei 结果）。**公司的本国商业登记簿中的 ID，以及该登记簿的代码——RA000585 英国 Companies House、RA000189 INSEE Sirene、RA000413 日本 NTA、RA000472 Brønnøysund。这能通过键值而非名称相似度，将 LEI 与国家登记簿记录关联起来（名称匹配路线曾将“Porsche”解析为马提尼克实体）。ID 仅在所属登记簿内唯一，因此务必同时查看这两个值。需要了解两点：GLEIF 发布的部分登记簿 ID 中含有空格（Equinor 的挪威组织编号以 923 609 016 的形式提供），此工具包会去除所有空白字符，以便匹配 ID——不会更改其他内容，因为 -、.、_ 和 / 都是这些登记簿格式化自身 ID 的组成部分；RA999999 是 GLEIF 表示“其他／不适用”的哨兵值，不会附带 ID（在抽样的每日增量数据中，201 条记录里有 0 条）。若 GLEIF 未发布 ID，则为 null——约占记录的 7.5%。
• get_lei_relationships(lei) — Level 2 直接母公司、最终母公司、直接子公司（一级）。
• isin_to_lei(isin) — 将证券的 ISIN 解析为其发行法律实体（LEI + 法定名称）。有效但未映射的 ISIN 会报告为 mapped: false, reason: "isin_unmapped"——映射数据可能滞后于新发行，因此未映射 ≠ 不存在。
• lei_to_isins(lei) — 返回某实体发行的所有 ISIN（接受 LEI 或公司名称）。返回完整集合——一个实体会发行许多证券。
• bic_to_lei(bic) — 将 SWIFT/BIC（8 或 11 个字符）解析为银行的法律实体。8 字符代码会补齐为 XXX 总行形式（GLEIF 的筛选器仅匹配 11 字符 BIC）；若分行 BIC 没有自己的映射，则回退到总行并说明原因。
• lei_hierarchy_tree(lei, depth?) — 多级所有权关系：向上追溯至最终母公司的祖先链，以及广度优先的子公司树（深度为 1–4，默认值为 2，每次调用的节点预算为 150）。
• gleif_group_members(lei, limit?) — 一次调用即可获取涵盖所有司法管辖区的整个合并集团。传入任一成员（LEI 或名称）；此工具会向上追溯至最终会计合并母公司，并返回所有申报该母公司的实体、所有直接母公司关系下的后代实体，以及它们的国际分支机构。member_count、jurisdiction_count 和 by_jurisdiction 始终涵盖整个集团；成员列表数量上限为 limit（默认值为 300，最大值为 2000），达到上限时会注明。Siemens AG：572 家申报的子公司，与 GLEIF 自身的最终子公司数量一致。基金管理关系不属于所有权关系，因此不纳入。包含 data_as_of。
• gleif_lei_screen(jurisdiction, registration_status?, entity_status?, category?, event_type?, since_days?, name_contains?, limit?, offset?) — 对全部约 340 万个 LEI 进行批量筛查：例如，查找最近 30 天内在 DE 失效的所有 LEI、本季度被注销的特拉华州（US-DE）实体，或最新事件为合并的英国实体。国家代码包含其下属行政区。since_days 适用于 status_date（LAPSED = 错过续期的日期；RETIRED/ANNULLED = 实体到期日，否则为上次更新日期；ISSUED = 初始注册日期），或者在指定 event_type 时适用于事件日期。total 在 100,000 条以内为精确值。GLEIF 将合并记录为 RETIRED，并附带 MERGERS_AND_ACQUISITIONS/ABSORPTION 事件及 successor_lei——若请求 MERGED，工具会解释后拒绝，而不会返回零行结果。批量结果会隐去个体经营者的姓名（姓名可识别个人）。包含 data_as_of。
• decode_elf_code(code) — 解码 ISO 20275 法律实体形式代码（legal_form 中的 4 字符代码），返回注册名称、语言、国家和司法管辖区，例如，"XJHM" → 瑞典的“ Aktiebolag”。两个 ISO 哨兵代码 "8888"（未记录具体法律形式）和 "9999"（尚未分类）不包含国家信息，并通过 is_sentinel 标记，而不是作为普通未匹配项返回。
• decode_registration_authority(code) — 解码 GLEIF 注册机构代码（registration_authority 中的代码），返回国家商业登记簿的名称、网站和司法管辖区，例如，"RA000585" → 英国的 Companies House。纯数字代码会自动补零并加上 "RA" 前缀。

数据源

gleif_group_members 和 gleif_lei_screen 基于 GLEIF golden copy（Level 2 关系记录和 Level 1 实体参考数据；每天在 goldencopy.gleif.org 发布三次）提供答案，并每日刷新。每个响应中的 data_as_of 是答案所依据的 GLEIF 发布时间。

许可。 GLEIF LEI Data Terms of Use，第 II 节："The data available through the Access Service are provided under the CC0 licence"（terms，于 2026-09-30 阅读）。

decode_elf_code 和 decode_registration_authority 根据 GLEIF 自有的 ISO 20275 Entity Legal Forms 代码列表及其 Registration Authorities 列表，按代码提供答案。get_lei 中的内联 legal_form_decoded / registration_authority_decoded 使用相同的两项查询。

其他工具：

https://api.gleif.org/api/v1/ — 公共 JSON:API，无需密钥。ISIN 和 BIC 联查使用 GLEIF 官方的 ISIN-to-LEI 和 BIC-to-LEI 映射文件，这些文件通过同一 API 提供（filter[isin]、filter[bic]、/lei-records/{lei}/isins）。

传入 LEI

所有接受 lei 参数的工具也接受公司名称——系统会在注册表中解析该名称，并将匹配结果与答案一并返回。只要你掌握的是名称，就请传入名称。

切勿自行构造 LEI 代码。 一个碰巧对应真实 LEI 的猜测性 20 字符字符串，可能属于另一家公司，而 GLEIF 会返回该公司的记录，却不会提示抓取了错误实体——曾有一次，查询 Wirecard AG 却返回了 Baader Bank Aktiengesellschaft。发出任何请求前，系统都会根据 ISO 17442（ISO 7064 MOD 97-10）校验位检查代码；不通过的代码会被拒绝，并提示使用 search_lei。这能拦截大约每 97 个虚构代码中的 96 个，但无法拦截与有效记录碰撞的代码，因此才提供名称查询路径。

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "gleif": {
      "url": "https://gateway.pipeworx.io/gleif/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/gleif/mcp 上的 tools/list 会返回上表中的工具，以及 Pipeworx 共享元工具——ask_pipeworx、 discover_tools、search_within、remember/recall，以及其他网关级工具。因此，你看到的工具数量会多于此表所列：目前，单个工具包端点除了自身工具包的工具，还会列出大约 30 个共享工具。连接的 initialize 响应会说明其确切范围，并且是当天适用范围的权威说明。

这是有意为之，并非意外复用。这些元工具让指定范围的连接能够回答此工具包未覆盖的问题——通过 ask_pipeworx 路由到整个目录——无需再添加第二个 MCP 服务。目前无法挂载不含这些元工具的工具包端点；如果额外的架构占用的上下文超过路由带来的价值，请连接一次完整网关，而不是连接多个工具包端点。

或者连接完整的 Pipeworx 网关，直接列出所有工具包的工具，而不只是此工具包的工具：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

两个 URL 都连接到同一网关和相同的 1879+ 个数据源。唯一的区别是直接列出哪个工具包的工具；无论连接哪一个，ask_pipeworx 都能访问所有工具。

没有 MCP 客户端？通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/search_lei \
  -H 'Content-Type: application/json' \
  -d '{"query":"Apple Inc"}'

首次调用无需账户。检查任意工具：GET https://gateway.pipeworx.io/v1/tools/search_lei。查找工具：使用 {"query":"..."} 向 https://gateway.pipeworx.io/v1/tools/search_packs 发送 POST 请求。

独立运行（无需网关账户）

此软件包也可作为本地 stdio MCP 服务运行——无需 Pipeworx 账户，也无需往返网关：

{
  "mcpServers": {
    "gleif": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-gleif"]
    }
  }
}

也可以直接运行，确认服务能够启动：

npx -y @pipeworx/mcp-gleif

它通过 stdin/stdout 使用 MCP 协议，并且只会针对此工具包的工具响应 initialize/tools/list/tools/call——不包含上述网关连接所添加的任何共享元工具。数据源相同，工具相同，但没有 ask_pipeworx 路由。

使用 ask_pipeworx

无需直接调用工具，你可以用通俗的英语提问—— 这在上方的 pack 端点和完整网关上都适用：

ask_pipeworx({ question: "your question about Gleif data" })

网关会选择合适的工具并自动填入参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT