Skip to main content
Glama
viktorlarsson

openfigi-mcp

OpenFIGI

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

CI License: MIT

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

npm

TypeScript SDK for the OpenFIGI API

openfigi-mcp

npm

MCP server for Claude and AI assistants

Related MCP server: gangtise-mcp

openfigi-sdk

Type-safe TypeScript SDK with full API coverage.

npm install openfigi-sdk
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.

npm install openfigi-mcp

Add to Claude Desktop config:

{
  "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

npm install ai @ai-sdk/mcp @ai-sdk/anthropic @modelcontextprotocol/sdk
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

# 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

  1. Fork the repository

  2. Create your feature branch (git checkout -b feature/AmazingFeature)

  3. Make your changes and add tests

  4. Add a changeset: bun run changeset

  5. Commit and push

  6. 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

Related MCP Connectors

  • OpenFIGI MCP — financial-instrument symbology.

  • Financial data MCP server for Claude, ChatGPT, Cursor and Codex. Real-time stock quotes, financial statements, options flow, SEC filings, insider trades, 13F holdings, macro data and market news from gloom.sh, the open-source Bloomberg Terminal alternative.

  • MCP server exposing the Backtest360 engine API as tools for AI agents.

  • The Octagon MCP server provides specialized AI-powered financial research and analysis by integrating with the Octagon Market Intelligence API. It enables users to analyze public market data (SEC filings, earnings transcripts, financial metrics, and stock data for 8000+ companies), private market data (3M+ companies, 500k+ funding rounds, 2M+ M&A/IPO transactions), and conduct deep research including web scraping capabilities. The server also features autonomous research agents that search hundreds of sources and return fully cited reports in approximately one minute.

Related MCP Servers

  • A
    license
    B
    quality
    B
    maintenance
    This MCP server enables AI assistants to access Gangtise investment research platform data, including market data, financial reports, research opinions, and more via the Gangtise OpenAPI.
    66
    426 npm
    4
    MIT
  • A
    license
    A
    quality
    A
    maintenance
    MCP server that exposes Yahoo Finance data through tools for searching instruments, fetching quotes, history, company info, financials, dividends, news, recommendations, and options. Enables AI assistants to answer market-data questions using natural language.
    22
    66 PyPI
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Provides access to Refinitiv/LSEG Permanent Identifiers (PermID) through an MCP gateway, enabling AI agents to query financial instrument and entity data via natural language or direct tool calls.
    2 npm
    MIT