Openfigi

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:

{

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

Global Installation

npm install -g openfigi-mcp

{

"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

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:

Auto-Detection Tools

Utility Tools

Auto-Detection Examples

Tickers with Exchange Codes

The tools recognize the Bloomberg Terminal format TICKER EXCHANGE:

Ticker

ABLI SS ABSO SS AAPL US VOD LN 7203 JP

Common exchange codes:

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 FOUND No 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:

Environment Variables

API Key

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

License

MIT