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 分