OpenFIGI

A modern, type-safe TypeScript SDK and MCP server for the OpenFIGI API - the free and open standard for financial instrument identification.

Community Project Disclaimer This is an unofficial, community-maintained project for OpenFIGI. It is not affiliated with or endorsed by OpenFIGI or Bloomberg. For official support, please refer to the OpenFIGI official documentation.

Packages

This monorepo contains two packages:

Package	Version	Description
openfigi-sdk		TypeScript SDK for the OpenFIGI API
openfigi-mcp		MCP server for Claude and AI assistants

openfigi-sdk

Type-safe TypeScript SDK with full API coverage.

Terminal

npm install openfigi-sdk

server.ts

import { searchByISIN, searchByTicker, createClient } from 'openfigi-sdk'

// Search by ISIN
const response = await searchByISIN('US0378331005')

// Search by ticker
await searchByTicker('AAPL', 'US', { securityType2: 'Common Stock' })

// With API key for higher rate limits
const client = createClient({ apiKey: 'your-api-key' })
await client.searchByISIN('US0378331005')

Full SDK documentation →

openfigi-mcp

MCP (Model Context Protocol) server for using OpenFIGI with Claude and other AI assistants.

Terminal

npm install openfigi-mcp

Add to Claude Desktop config:

config.json

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

Features:

Auto-detection: Parse CSV/text and detect identifier types (ISIN, CUSIP, SEDOL, Bloomberg ID, Ticker)
Batch operations: Process up to 100 identifiers at once
Ticker + Exchange: Supports formats like AAPL US, ABLI SS, VOD LN

Using with Vercel AI SDK

Terminal

npm install ai @ai-sdk/mcp @ai-sdk/anthropic @modelcontextprotocol/sdk

server.ts

import { createMCPClient } from '@ai-sdk/mcp'
import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js'
import { generateText } from 'ai'
import { anthropic } from '@ai-sdk/anthropic'

const mcpClient = await createMCPClient({
  transport: new StdioClientTransport({
    command: 'npx',
    args: ['openfigi-mcp'],
    env: { OPENFIGI_API_KEY: process.env.OPENFIGI_API_KEY }
  }),
})

const tools = await mcpClient.tools()

const { text } = await generateText({
  model: anthropic('claude-sonnet-4-20250514'),
  tools,
  maxSteps: 5,
  prompt: 'Find the FIGI for Apple Inc using ISIN US0378331005',
})

await mcpClient.close()

Note: For AI SDK 5.x, use experimental_createMCPClient from 'ai' instead of createMCPClient from '@ai-sdk/mcp'.

Full MCP documentation →

Development

bash

# Install dependencies
bun install

# Build all packages
bun run build

# Run all tests
bun run test

# Type check
bun run typecheck

# Lint
bun run lint

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Development Workflow

Fork the repository
Create your feature branch (git checkout -b feature/AmazingFeature)
Make your changes and add tests
Add a changeset: bun run changeset
Commit and push
Open a Pull Request

Release Process

This project uses Changesets for version management. When PRs with changesets are merged, a release PR is automatically created. Merging the release PR publishes to npm.

License

MIT - see LICENSE

Openfigi README

OpenFIGI

Packages

openfigi-sdk

openfigi-mcp

Using with Vercel AI SDK

Development

Contributing

Development Workflow

Release Process

License

Links