mcpField
C
CUSIP/ISIN Validator — Security Identifier Validation

CUSIP/ISIN Validator — Security Identifier Validation

Local
github.com/easysolutions906Developer Tools0Updated 33w ago
Repository

About CUSIP/ISIN Validator — Security Identifier Validation

This MCP server validates and parses CUSIP and ISIN security identifiers using checksum algorithms. It is intended for finance and trading workflows, and also offers a REST API and batch validation.

Key features

  1. 01Validate CUSIP identifiers
  2. 02Parse CUSIP components
  3. 03Validate ISIN identifiers
  4. 04Parse ISIN components and embedded US/CA CUSIP
  5. 05Batch-validate identifiers through REST API

Use cases

  1. 01Check security identifiers in trading workflows
  2. 02Extract issuer and issue details from a CUSIP
  3. 03Parse an ISIN and inspect its country code
  4. 04Validate multiple identifiers through the REST API

MCP support

Exposes four CUSIP and ISIN validation and parsing tools to MCP clients. Supports stdio by default and Streamable HTTP when `PORT` is set.

#cusip#isin#finance#trading#validation#mcp

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "cusip-api": {
      "command": "npx",
      "args": [
        "-y",
        "@easysolutions906/mcp-cusip-isin"
      ]
    }
  }
}
Run commandnpx -y @easysolutions906/mcp-cusip-isin

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@easysolutions906/mcp-cusip-isin

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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)

ToolDescription
cusip_validateValidate a 9-character CUSIP using the Luhn-variant check digit algorithm
cusip_parseParse a CUSIP into issuer code, issue number, and check digit
isin_validateValidate a 12-character ISIN using the Luhn algorithm
isin_parseParse an ISIN into country code, NSIN, and check digit (extracts embedded CUSIP for US/CA)

Install

npx @easysolutions906/mcp-cusip-isin
Claude Desktop

Add to your claude_desktop_config.json:

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

Add to .cursor/mcp.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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.