Openfigi

io.github.viktorlarssonPublished by GitHub account viktorlarssonv0.2.4Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyFinanceData & Analytics

Overview

AI-generated overview

A local MCP server that lets an assistant map financial identifiers such as ISIN, CUSIP, SEDOL, tickers and Bloomberg IDs to OpenFIGI FIGIs.

What you can do
Look up FIGIs by ISIN, CUSIP, SEDOL, ticker with exchange code, or Bloomberg ID, with smart ticker search across security types and an optional security type filter. Auto-detect identifier types from free text or CSV and search a single identifier or a batch in one request. Map up to 100 identifiers with explicit types in a single batch call. Validate identifier formats and parse CSV or text without calling the API. Check current API rate limit status and read reference resources for identifier types, exchange codes, security types and market sectors.
When to use it
Useful when you work with securities data and need to resolve identifiers to FIGIs, for example cleaning a list of ISINs or tickers from a spreadsheet, or checking whether an identifier exists before joining datasets.
Requirements
Runs locally as an npm package (openfigi-mcp) via npx or a global install, configured in the desktop client. Needs network access to the OpenFIGI API. The OPENFIGI_API_KEY environment variable is optional but recommended: without it the rate limit is 25 requests per minute, with it 250.
Before you install
The optional OPENFIGI_API_KEY secret is stored in the client configuration file. Identifier lookups are sent to the third-party OpenFIGI service. Batch calls are capped at 100 identifiers and rate limits apply, so large jobs may be throttled.

Installation

In SourceWeft

  1. Open Openfigi in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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

Source: packages/mcp/README.md at commit 9e41d12

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.2.4LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts