Gleif

@pipeworx/gleif

Global Legal Entity Identifier Foundation MCP — LEI の検索、ISIN/BIC から法人へのマッピング、企業階層の確認を認証なしで行えます。

Pipeworx の一部です。AI エージェントを 1879 以上の稼働中のデータソースに接続する MCP ゲートウェイです。これは独立した非公式の連携であり、上流プロバイダーとは提携も推奨もされておらず、同プロバイダーによって公開されたものでもありません。

ツール

• search_lei(query, country?, status?, page_size?) — 法人名をあいまい検索します。country で絞り込んだ結果がゼロ件の場合、フィルターは解除され、その旨が country_filter_dropped で通知されます。GLEIF は 登録上の法的住所 で絞り込むため、その住所は法人が事業を行っている場所と異なることがよくあります（Sberbank の名前を含むレコードにロシアの住所を持つものはなく、CY/SK/LU/GB に所在しています）。
• get_lei(lei) — 法人名、住所、管轄区域、法的形態、LEI 登録ステータスを含む完全な Level 1 レコードを取得します。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は日本の国税庁、RA000472はBrønnøysundです。これにより、名称の類似性ではなく、キーによってLEIを国内登記簿の記録に結び付けられます（名称による方法では、「Porsche」がマルティニークの事業体に解決されました）。IDは登記簿内でのみ一意なので、必ずペアで確認してください。知っておくべき点が2つあります。GLEIFは一部の登記簿のIDに空白を含めて公開しています（Equinorのノルウェーの組織番号は923 609 016として届きます）。このパックでは、IDを結合できるようにすべての空白を取り除きます — -、.、_、/は各登記簿が独自のID形式で使用する文字なので、それ以外は変更しません。また、RA999999はGLEIFの「その他／該当なし」を示すセンチネルで、IDは付与されません（サンプルの日次差分201件中0件）。GLEIFがIDを公開していない場合はNullです — レコードの約7.5％です。
• get_lei_relationships(lei) — レベル2の直接親会社、最終親会社、直接子会社（1階層）。
• isin_to_lei(isin) — 証券のISINから、発行した法人（LEI + 法的名称）を解決します。有効だがマッピングされていないISINは、mapped: false, reason: "isin_unmapped"として報告されます — マッピングは新規発行への反映が遅れるため、未マッピングは不存在を意味しません。
• lei_to_isins(lei) — 事業体が発行したすべてのISINを返します（LEIまたは会社名を指定できます）。完全な一覧を返します — 1つの事業体が多数の証券を発行します。
• 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?) — あらゆる法域にまたがる連結グループ全体を1回の呼び出しで取得します。任意のメンバー（LEIまたは名称）を渡すと、ツールは最終会計連結親会社までさかのぼり、その親会社を報告しているすべての事業体、直接親会社から連なるすべての子孫、およびそれらの国際支店を返します。member_count、jurisdiction_count、by_jurisdictionは常にグループ全体を対象とします。メンバー一覧には上限があり（既定値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とsuccessor_leiを含むMERGERS_AND_ACQUISITIONS／ABSORPTIONイベントとして記録されます — MERGEDは0件の行として回答せず、その説明を返します。個人名を含むため、個人事業主の名称は一括結果では非公開になります。data_as_ofを含みます。
• decode_elf_code(code) — ISO 20275 Entity Legal Formコード（legal_formに含まれる4文字のコード）をデコードし、登録名、言語、国、法域を返します。例："XJHM" → スウェーデンの「Aktiebolag」。2つのISOセンチネルコード"8888"（特定の法的形態が記録されていない）と"9999"（未分類）は国を持たず、単に見つからなかったものとして返すのではなく、is_sentinelでフラグが立てられます。
• decode_registration_authority(code) — GLEIF Registration Authorityコード（registration_authorityに含まれるコード）をデコードし、国内商業登記簿の名称、ウェブサイト、法域を返します。例："RA000585" → 英国のCompanies House。数字のみを指定した場合は、自動的にゼロ埋めして"RA"を付加します。

データソース

gleif_group_members と gleif_lei_screen は、GLEIF ゴールデンコピー（Level 2 の関係レコードと Level 1 の法人参照データ。goldencopy.gleif.org で1日3回公開）を参照して回答し、毎日更新されます。各レスポンスの data_as_of は、回答が反映している GLEIF の公開時刻です。

ライセンス。 GLEIF LEI Data Terms of Use、第 II 条：「Access Service を通じて利用できるデータは、CC0 ライセンスに基づいて提供されます」（利用規約、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 でも、同じ2つの参照先を使用します。

その他のツール：

https://api.gleif.org/api/v1/ — 公開 JSON:API で、キーは不要です。ISIN と BIC の照合には、同じ API（filter[isin]、filter[bic]、/lei-records/{lei}/isins）経由で提供される、GLEIF 公式の ISIN-to-LEI および BIC-to-LEI マッピングファイルを使用します。

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 サーバーをもう1つ追加せずに回答できます。現在、これらのメタツールなしでパックのエンドポイントを接続する方法はありません。追加のスキーマがルーティングの利点よりも多くのコンテキストを消費する場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度接続してください。

このパックのツールだけでなく、すべてのパックのツールを直接一覧表示するには、フル 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":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの 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 での使用

ツールを直接呼び出す代わりに、平易な英語で質問できます。 これは、上記のパックエンドポイントだけでなく、フルゲートウェイでも機能します。

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

ゲートウェイが適切なツールを選び、引数を自動的に設定します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT