openfigi

openfigi-mcp

OpenFIGI API 用の MCP（Model Context Protocol）サーバーです。Claude やその他の MCP 互換 AI アシスタントから、金融識別子を FIGI に直接マッピングできます。

特長

• 識別子の種類で検索：ISIN、CUSIP、SEDOL、ティッカー、Bloomberg ID
• 自動検出：テキスト／CSV データから識別子の種類を自動検出します
• ティッカー＋取引所：AAPL US、ABLI SS、VOD LN のような形式を解析します
• バッチ処理：1 回のリクエストで最大 100 件の識別子を処理します
• 未検出の報告：識別子が存在しない場合に明確に示します
• 参照リソース：識別子の種類、取引所コード、証券の種類にアクセスできます

インストール

npx を使用する（最も簡単）

インストールは不要です。Claude Desktop を設定するだけです。

{
  "mcpServers": {
    "openfigi": {
      "command": "npx",
      "args": ["openfigi-mcp@latest"],
      "env": {
        "OPENFIGI_API_KEY": "your-api-key-here"
      }
    }
  }
}

グローバルインストール

npm install -g openfigi-mcp

{
  "mcpServers": {
    "openfigi": {
      "command": "openfigi-mcp",
      "env": {
        "OPENFIGI_API_KEY": "your-api-key-here"
      }
    }
  }
}

設定ファイルの場所：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

利用可能なツール

検索ツール

ツール	説明	例
search_by_isin	ISIN で検索	US0378331005（Apple）
search_by_cusip	CUSIP で検索	037833100（Apple）
search_by_sedol	SEDOL で検索	2046251（Apple）
search_by_ticker	ティッカーで検索（スマート検索）	取引所コード US を指定した AAPL
search_by_bloomberg_id	Bloomberg ID で検索	BBG000B9XRY4

スマートティッカー検索

search_by_ticker ツールは、検索時に複数の証券の種類を自動的に試すため、株式が普通株か優先株かを把握しておく必要はありません。

# These all work automatically:
AAPL US    → Common Stock (Apple)
VOW3 GY    → Preference shares (Volkswagen preferred)
P911 GY    → Preference shares (Porsche)
RR. LN     → Common Stock (Rolls-Royce)
BA. LN     → Common Stock (BAE Systems)

特定の証券の種類を検索する場合は、オプションの securityType2 パラメーターを使用できます。

securityType2	説明
Common Stock	通常の普通株
Preference	優先株
Depositary Receipt	ADR、GDR
ETP	ETF およびその他の上場取引型商品

自動検出ツール

ツール	説明
search_auto_detect	識別子の種類を自動検出し、単一の識別子を検索します
parse_identifiers	CSV／テキストを解析し、識別子の種類を検出します（API 呼び出しなし）
batch_search_auto_detect	1 回のリクエストで複数の識別子を解析して検索します

ユーティリティツール

ツール	説明
batch_mapping	明示的に種類を指定して最大 100 件の識別子をマッピングします
validate_identifier	検索せずに識別子の形式を検証します
get_rate_limit_status	現在の API レート制限の状態を確認します

自動検出の例

取引所コード付きティッカー

ツールは Bloomberg Terminal 形式の TICKER EXCHANGE を認識します。

Ticker
ABLI SS
ABSO SS
AAPL US
VOD LN
7203 JP

一般的な取引所コード：

コード	取引所
US	米国
SS	ストックホルム（Nasdaq Stockholm）
LN	ロンドン
GY	ドイツ（Xetra）
JP	日本
HK	香港
FP	フランス（Euronext Paris）

混在する識別子

ツールは異なる種類の識別子を自動検出します。

US0378331005      → ISIN [high confidence]
BBG000B9XRY4      → Bloomberg ID [high confidence]
AAPL US           → Ticker with exchange [high confidence]
037833100         → CUSIP [medium confidence]
2046251           → SEDOL [medium confidence]
AAPL              → Ticker [low confidence]

未検出の処理

識別子が OpenFIGI に存在しない場合、出力に明確に示されます。

単一検索：

Detected type: TICKER (Exchange: SS) [high confidence]

⚠️ NOT FOUND: "BLABLABLA" on exchange SS returned no results.

No results found

バッチ検索：

Detected 3 identifiers:
  - Ticker: 3

[1] TICKER: AAPL [US]
Result 1:
  FIGI: BBG000B9XRY4
  Name: APPLE INC
  ...

---

[2] TICKER: INVALID [SS] ⚠️ NOT FOUND
No results found

---

[3] TICKER: MSFT [US]
Result 1:
  FIGI: BBG000BPH459
  ...

---
Results: 2 found, 1 not found

⚠️ Not found:
  - INVALID [SS]

利用可能なリソース

MCP リソースから参照データにアクセスできます。

リソース URI	説明
openfigi://identifier-types	サポートされている識別子の種類の一覧（ID_ISIN、ID_CUSIP など）
openfigi://exchange-codes	一般的な取引所コード（US、SS、LN など）
openfigi://security-types	証券の種類の値（Common Stock、ETF など）
openfigi://market-sectors	市場セクターの値（Equity、Corp など）

環境変数

変数	説明	必須
OPENFIGI_API_KEY	OpenFIGI API キー	いいえ（ただし推奨）

API キー

無料の API キーは openfigi.com/api で取得できます。

	API キーなし	API キーあり
レート制限	25 req/min	250 req/min

ライセンス

MIT