CUSIP/ISIN Validator — Security Identifier Validation

by easysolutions906

349 downloads
Not rated
GitHub

About

Validate and parse CUSIP and ISIN security identifiers using official checksum algorithms. Pure computation, no external dependencies. Used by trading platforms, portfolio tools, and fintech.

Details

Author
easysolutions906
Downloads
349
Categories
Developer Tools, Finance

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name CUSIP/ISIN Validator — Security Identifier Validation
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install via npx @easysolutions906/mcp-cusip-isin. For local use with Claude Desktop or Cursor, add the configuration shown in the README to your claude_desktop_config.json or .cursor/mcp.json. Set the PORT environment variable to run as an HTTP server, then use endpoints like `GET /cusip/validate?cusip

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "cusip/isin validator \u2014 security identifier validation": {
            "cusip": {
                "command": "npx",
                "args": [
                    "-y",
                    "@easysolutions906/mcp-cusip-isin"
                ]
            }
        }
    }
}

McpServers

{
    "cusip": {
        "command": "npx",
        "args": [
            "-y",
            "@easysolutions906/mcp-cusip-isin"
        ]
    }
}

MCP CUSIP/ISIN Server

A Model Context Protocol (MCP) server for validating and parsing CUSIP and ISIN security identifiers using check digit algorithms.

Tools (4 total)

| Tool | Description | |------|-------------| | cusip_validate | Validate a 9-character CUSIP using the Luhn-variant check digit algorithm | | cusip_parse | Parse a CUSIP into issuer code, issue number, and check digit | | isin_validate | Validate a 12-character ISIN using the Luhn algorithm | | isin_parse | Parse an ISIN into country code, NSIN, and check digit (extracts embedded CUSIP for US/CA) |

Install

``bash npx @easysolutions906/mcp-cusip-isin `

Claude Desktop

Add to your
claude_desktop_config.json: `json { "mcpServers": { "cusip-isin": { "command": "npx", "args": ["-y", "@easysolutions906/mcp-cusip-isin"] } } } `

Cursor

Add to
.cursor/mcp.json: `json { "mcpServers": { "cusip-isin": { "command": "npx", "args": ["-y", "@easysolutions906/mcp-cusip-isin"] } } } `

REST API

Set
PORT env var to run as an HTTP server. - GET /cusip/validate?cusip=037833100 -- validate a CUSIP - GET /cusip/parse?cusip=037833100 -- parse CUSIP into components - GET /isin/validate?isin=US0378331005 -- validate an ISIN - GET /isin/parse?isin=US0378331005 -- parse ISIN into components - POST /validate/batch -- batch validate multiple CUSIPs and ISINs

Data Source

Pure algorithm -- no external dataset required. CUSIP uses a Luhn-variant checksum; ISIN uses standard Luhn over letter-to-number conversion.

Transport

- stdio (default) -- for local use with Claude Desktop and Cursor - HTTP -- set
PORT env var to start in Streamable HTTP mode on /mcp`
No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.