ValuefocusValuefocus
Get the app
Security mapping

OpenFIGI Mapping Skill

Help an agent resolve tickers, ISINs and exchange context into normalized security identifiers.

Source
Bloomberg OpenFIGI
Access
Key optional

What this adds to your agent

Map ticker and exchange to FIGI

Reduce ambiguous company matches

Normalize identifiers across tools

Implementation statusGuide reviewed · 2026-07
Implementation status

Key optional

Expected result

Map ticker and exchange to FIGI

Known failure mode

A ticker alone is often ambiguous; ask for exchange or market context before mapping.

Compatibility

Bloomberg OpenFIGI · identity

Build the tool server

server.py
from mcp.server.fastmcp import FastMCP
import os, requests

mcp = FastMCP("OpenFIGI")

@mcp.tool()
def map_ticker(ticker: str, exchange: str = "US") -> list:
    """Map a ticker and exchange code to FIGI identifiers."""
    headers = {"Content-Type": "application/json"}
    if os.getenv("OPENFIGI_API_KEY"):
        headers["X-OPENFIGI-APIKEY"] = os.environ["OPENFIGI_API_KEY"]
    body = [{"idType": "TICKER", "idValue": ticker, "exchCode": exchange}]
    return requests.post("https://api.openfigi.com/v3/mapping",
                         json=body, headers=headers, timeout=20).json()

if __name__ == "__main__": mcp.run()

Examples and expected outcomes

Example 1

Fetch prices and statements in agent chat

  • Sourced evidence
  • Repeatable steps
  • Explicit uncertainty
Example 2

Create a read-only research brief

  • Sourced evidence
  • Repeatable steps
  • Explicit uncertainty
Example 3

Compare tickers with source timestamps

  • Sourced evidence
  • Repeatable steps
  • Explicit uncertainty

Access requirements

Keys and runtime

OPENFIGI_API_KEY

License and data rights

Review source and upstream data licenses

Rate limits

Use caching, backoff and bounded concurrency

Connect to your Agent

Claude config
{
  "mcpServers": {
    "openfigi-agent": {
      "command": "python",
      "args": [
        "server.py"
      ],
      "env": {
        "OPENFIGI_API_KEY": "YOUR_KEY"
      }
    }
  }
}
Prompt example

“Use OpenFIGI Mapping Skill to research AAPL. List sources and timestamps first, then separate facts, calculations, risks and missing data. Do not give personalized trading advice.”

When not to use it

  • A ticker alone is often ambiguous; ask for exchange or market context before mapping.

Connect it to your agent

Claude Desktop
{
  "mcpServers": {
    "openfigi-agent": {
      "command": "python",
      "args": [
        "server.py"
      ],
      "env": {
        "OPENFIGI_API_KEY": "YOUR_KEY"
      }
    }
  }
}
Prompt to test

“Use the connected tool to research AAPL. State the source and timestamp for every factual claim, separate facts from interpretation, and do not give personalized financial advice.”

Production checklist

  • Keep secrets outside prompts and source code
  • Allowlist read-only tools first
  • Log tool inputs, outputs and source timestamps
  • Require citations and handle missing data explicitly

When not to use it

A ticker alone is often ambiguous; ask for exchange or market context before mapping.

Open official documentation

Project-specific questions

What can OpenFIGI Mapping Skill do in a real workflow?

Map ticker and exchange to FIGI Reduce ambiguous company matches Normalize identifiers across tools

What access and compatibility does OpenFIGI Mapping Skill require?

Key optional. Bloomberg OpenFIGI.

What is the main implementation risk with OpenFIGI Mapping Skill?

A ticker alone is often ambiguous; ask for exchange or market context before mapping.

Related agent tutorials