Openfigi

io.github.viktorlarsson由 GitHub 帳號 viktorlarsson 發布v0.2.4更新於 Oct 24, 2026

Map financial identifiers (ISIN, CUSIP, SEDOL, Ticker) to FIGIs via OpenFIGI API

已驗證STDIO僅桌面金融資料與分析

概覽

AI 產生的概覽

一個本機 MCP 伺服器，讓助理透過 OpenFIGI 將 ISIN、CUSIP、SEDOL、股票代號與 Bloomberg ID 等金融識別碼對應為 FIGI。

可以做什麼
依 ISIN、CUSIP、SEDOL、附交易所代號的股票代號或 Bloomberg ID 查詢 FIGI，股票代號支援跨證券類型的智慧搜尋與可選的證券類型篩選。從自由文字或 CSV 自動辨識識別碼類型，並搜尋單一識別碼或一次批次搜尋。以明確類型在一次批次呼叫中對應最多 100 個識別碼。在不呼叫 API 的情況下驗證識別碼格式、解析 CSV 或文字。查看目前 API 速率限制狀態，並讀取識別碼類型、交易所代號、證券類型與市場板塊等參考資源。
適用情境
適合處理證券資料時需要把識別碼解析為 FIGI 的情境，例如清理試算表中的 ISIN 或股票代號清單，或在合併資料集前確認某個識別碼是否存在。
執行需求
以 npm 套件（openfigi-mcp）形式透過 npx 或全域安裝在本機執行，並在桌面用戶端中設定。需要連線至 OpenFIGI API 的網路存取。OPENFIGI_API_KEY 環境變數為選用但建議設定：未設定時速率限制為每分鐘 25 次請求，設定後為 250 次。
安裝前請注意
選用的 OPENFIGI_API_KEY 密鑰會存放在用戶端設定檔中。識別碼查詢會傳送給第三方 OpenFIGI 服務。批次呼叫最多 100 個識別碼且受速率限制，大批量工作可能被限流。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Openfigi，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

openfigi-mcp

MCP (Model Context Protocol) server for the OpenFIGI API. Map financial identifiers to FIGIs directly from Claude and other MCP-compatible AI assistants.

Features

  • Search by identifier type: ISIN, CUSIP, SEDOL, Ticker, Bloomberg ID
  • Auto-detection: Automatically detect identifier types from text/CSV data
  • Ticker + Exchange: Parse formats like AAPL US, ABLI SS, VOD LN
  • Batch operations: Process up to 100 identifiers in a single request
  • Not Found reporting: Clear indicators when identifiers don't exist
  • Reference resources: Access identifier types, exchange codes, security types

Installation

Using npx (easiest)

No installation required - just configure Claude Desktop:

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

Global Installation

bash
npm install -g openfigi-mcp
json
{  "mcpServers": {    "openfigi": {      "command": "openfigi-mcp",      "env": {        "OPENFIGI_API_KEY": "your-api-key-here"      }    }  }}

Config file location:

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

Available Tools

Search Tools

ToolDescriptionExample
search_by_isinSearch by ISINUS0378331005 (Apple)
search_by_cusipSearch by CUSIP037833100 (Apple)
search_by_sedolSearch by SEDOL2046251 (Apple)
search_by_tickerSearch by ticker (smart search)AAPL with exchCode US
search_by_bloomberg_idSearch by Bloomberg IDBBG000B9XRY4
Smart Ticker Search

The search_by_ticker tool automatically tries multiple security types when searching, so you don't need to know if a stock is common or preferred:

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

If you need to search for a specific security type, you can use the optional securityType2 parameter:

securityType2Description
Common StockRegular common shares
PreferencePreferred/preference shares
Depositary ReceiptADRs, GDRs
ETPETFs and other exchange-traded products

Auto-Detection Tools

ToolDescription
search_auto_detectAuto-detect identifier type and search a single identifier
parse_identifiersParse CSV/text and detect identifier types (no API call)
batch_search_auto_detectParse and search multiple identifiers in one request

Utility Tools

ToolDescription
batch_mappingMap up to 100 identifiers with explicit types
validate_identifierValidate identifier format without searching
get_rate_limit_statusCheck current API rate limit status

Auto-Detection Examples

Tickers with Exchange Codes

The tools recognize the Bloomberg Terminal format TICKER EXCHANGE:

TickerABLI SSABSO SSAAPL USVOD LN7203 JP

Common exchange codes:

CodeExchange
USUnited States
SSStockholm (Nasdaq Stockholm)
LNLondon
GYGermany (Xetra)
JPJapan
HKHong Kong
FPFrance (Euronext Paris)

Mixed Identifiers

The tools auto-detect different identifier types:

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]

Not Found Handling

When identifiers don't exist in OpenFIGI, the output clearly indicates:

Single search:

Detected type: TICKER (Exchange: SS) [high confidence]
⚠️ NOT FOUND: "BLABLABLA" on exchange SS returned no results.
No results found

Batch search:

Detected 3 identifiers:  - Ticker: 3
[1] TICKER: AAPL [US]Result 1:  FIGI: BBG000B9XRY4  Name: APPLE INC  ...
---
[2] TICKER: INVALID [SS] ⚠️ NOT FOUNDNo results found
---
[3] TICKER: MSFT [US]Result 1:  FIGI: BBG000BPH459  ...
---Results: 2 found, 1 not found
⚠️ Not found:  - INVALID [SS]

Available Resources

Access reference data via MCP resources:

Resource URIDescription
openfigi://identifier-typesList of supported identifier types (ID_ISIN, ID_CUSIP, etc.)
openfigi://exchange-codesCommon exchange codes (US, SS, LN, etc.)
openfigi://security-typesSecurity type values (Common Stock, ETF, etc.)
openfigi://market-sectorsMarket sector values (Equity, Corp, etc.)

Environment Variables

VariableDescriptionRequired
OPENFIGI_API_KEYYour OpenFIGI API keyNo (but recommended)

API Key

Get your free API key at openfigi.com/api.

Without API KeyWith API Key
Rate Limit25 req/min250 req/min

License

MIT

來源：packages/mcp/README.md，提交 9e41d12

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.2.4最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分