{
  "markdown": "# OpenFIGI\n\nA modern, type-safe TypeScript SDK and MCP server for the [OpenFIGI API](https://www.openfigi.com/api) - the free and open standard for financial instrument identification.\n\n[![CI](https://github.com/viktorlarsson/openfigi/actions/workflows/ci.yml/badge.svg)](https://github.com/viktorlarsson/openfigi/actions/workflows/ci.yml)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n> **Community Project Disclaimer**\n> 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](https://www.openfigi.com/api).\n\n## Packages\n\nThis monorepo contains two packages:\n\n| Package | Version | Description |\n|---------|---------|-------------|\n| [openfigi-sdk](./packages/openfigi-sdk) | [![npm](https://badge.fury.io/js/openfigi-sdk.svg)](https://www.npmjs.com/package/openfigi-sdk) | TypeScript SDK for the OpenFIGI API |\n| [openfigi-mcp](./packages/mcp) | [![npm](https://badge.fury.io/js/openfigi-mcp.svg)](https://www.npmjs.com/package/openfigi-mcp) | MCP server for Claude and AI assistants |\n\n## openfigi-sdk\n\nType-safe TypeScript SDK with full API coverage.\n\n```bash\nnpm install openfigi-sdk\n```\n\n```typescript\nimport { searchByISIN, searchByTicker, createClient } from 'openfigi-sdk'\n\n// Search by ISIN\nconst response = await searchByISIN('US0378331005')\n\n// Search by ticker\nawait searchByTicker('AAPL', 'US', { securityType2: 'Common Stock' })\n\n// With API key for higher rate limits\nconst client = createClient({ apiKey: 'your-api-key' })\nawait client.searchByISIN('US0378331005')\n```\n\n[Full SDK documentation →](./packages/openfigi-sdk/README.md)\n\n## openfigi-mcp\n\nMCP (Model Context Protocol) server for using OpenFIGI with Claude and other AI assistants.\n\n```bash\nnpm install openfigi-mcp\n```\n\nAdd to Claude Desktop config:\n```json\n{\n  \"mcpServers\": {\n    \"openfigi\": {\n      \"command\": \"npx\",\n      \"args\": [\"openfigi-mcp@latest\"],\n      \"env\": {\n        \"OPENFIGI_API_KEY\": \"your-api-key-here\"\n      }\n    }\n  }\n}\n```\n\nFeatures:\n- **Auto-detection**: Parse CSV/text and detect identifier types (ISIN, CUSIP, SEDOL, Bloomberg ID, Ticker)\n- **Batch operations**: Process up to 100 identifiers at once\n- **Ticker + Exchange**: Supports formats like `AAPL US`, `ABLI SS`, `VOD LN`\n\n### Using with Vercel AI SDK\n\n```bash\nnpm install ai @ai-sdk/mcp @ai-sdk/anthropic @modelcontextprotocol/sdk\n```\n\n```typescript\nimport { createMCPClient } from '@ai-sdk/mcp'\nimport { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js'\nimport { generateText } from 'ai'\nimport { anthropic } from '@ai-sdk/anthropic'\n\nconst mcpClient = await createMCPClient({\n  transport: new StdioClientTransport({\n    command: 'npx',\n    args: ['openfigi-mcp'],\n    env: { OPENFIGI_API_KEY: process.env.OPENFIGI_API_KEY }\n  }),\n})\n\nconst tools = await mcpClient.tools()\n\nconst { text } = await generateText({\n  model: anthropic('claude-sonnet-4-20250514'),\n  tools,\n  maxSteps: 5,\n  prompt: 'Find the FIGI for Apple Inc using ISIN US0378331005',\n})\n\nawait mcpClient.close()\n```\n\n> **Note**: For AI SDK 5.x, use `experimental_createMCPClient` from `'ai'` instead of `createMCPClient` from `'@ai-sdk/mcp'`.\n\n[Full MCP documentation →](./packages/mcp/README.md)\n\n## Development\n\n```bash\n# Install dependencies\nbun install\n\n# Build all packages\nbun run build\n\n# Run all tests\nbun run test\n\n# Type check\nbun run typecheck\n\n# Lint\nbun run lint\n```\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n### Development Workflow\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/AmazingFeature`)\n3. Make your changes and add tests\n4. Add a changeset: `bun run changeset`\n5. Commit and push\n6. Open a Pull Request\n\n### Release Process\n\nThis project uses [Changesets](https://github.com/changesets/changesets) for version management. When PRs with changesets are merged, a release PR is automatically created. Merging the release PR publishes to npm.\n\n## License\n\nMIT - see [LICENSE](LICENSE)\n\n## Links\n\n- [OpenFIGI API Documentation](https://www.openfigi.com/api/documentation)\n- [OpenFIGI Website](https://www.openfigi.com/)\n- [GitHub Repository](https://github.com/viktorlarsson/openfigi)\n",
  "bytes": 4357,
  "sha": "d6604ebeb54123790e88f92d70d4a383ea21c64ba1c82f0b8dbe7c473123a461",
  "repo_slug": "viktorlarsson/openfigi",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_viktorlarsson_openfigi_4a987f51/readme"
}