ICD-10 Codes

Search and lookup ICD-10 diagnosis codes via the @sequoiaport/codes package.

When to Apply

User asks for an ICD-10 code
User needs a diagnosis code for a clinical condition
User mentions billing codes or diagnosis coding
User wants to browse ICD-10 chapters

Getting an API Key

First check if SEQUOIA_CODES_API_KEY is already set in the environment. If it is, skip key generation entirely and proceed to usage. Only if no key exists, see AGENT_PROMPT.md for how your agent can obtain one via the agent auth flow.

MCP Server

Once you have an API key, you can set up the MCP server for direct tool access from Claude Code, Cursor, or VS Code. See MCP_SETUP.md.

How It Works

import { SequoiaCodesClient } from "@sequoiaport/codes";

const client = new SequoiaCodesClient({
  apiKey: process.env.SEQUOIA_CODES_API_KEY!,
});

Available Operations

`client.icd10.searchCode({ query, limit?, billingOnly? })`

Hybrid search for ICD-10 codes by clinical description.

const results = await client.icd10.searchCode({
  query: "type 2 diabetes mellitus",
  limit: 10,
  billingOnly: true, // only return billable codes
});
// results.results → [{ code, short_description, long_description, is_billable, similarity, ... }]

`client.icd10.identifyCode({ code })`

Look up a specific ICD-10 code.

const result = await client.icd10.identifyCode({ code: "E11.9" });
// result.result → { code: "E11.9", short_description: "Type 2 diabetes mellitus without complications", chapter, block, is_billable, ... }

`client.icd10.getChapters()`

Get all 21 ICD-10 chapters with code ranges.

const chapters = await client.icd10.getChapters();
// chapters.chapters → [{ chapter_code: "1", chapter_description: "Certain infectious and parasitic diseases", code_range: "A00-B99" }, ...]

REST API (curl)

# Search ICD-10 codes
curl -X GET "https://api.sequoiacodes.com/v1/icd10/searchCode?query=diabetes&limit=10" \
  -H "Authorization: Bearer $SEQUOIA_CODES_API_KEY"

# Search billable codes only
curl -X GET "https://api.sequoiacodes.com/v1/icd10/searchCode?query=diabetes&billingOnly=true&limit=20" \
  -H "Authorization: Bearer $SEQUOIA_CODES_API_KEY"

# Lookup specific code
curl -X GET "https://api.sequoiacodes.com/v1/icd10/identifyCode?code=E11.9" \
  -H "Authorization: Bearer $SEQUOIA_CODES_API_KEY"

# Get all chapters
curl -X GET "https://api.sequoiacodes.com/v1/icd10/getChapters" \
  -H "Authorization: Bearer $SEQUOIA_CODES_API_KEY"

Response Fields

Each ICD-10 code result includes:

code - The ICD-10 code (e.g., "E11.9")
short_description - Brief description
long_description - Full description
chapter / chapter_description - Chapter info
block / block_description - Block info
category / subcategory - Category breakdown
is_billable - Whether the code is valid for billing
valid_for_submission - Whether valid for claims submission
similarity - Search relevance score (0-1)

icd10-codes