@sequoiaport/codex-sdk

sequoiacodex

Official TypeScript client for the Sequoia Medical Codex API.

Installation

npm install sequoiacodex

Quick Start

import { SequoiaCodexClient } from "sequoiacodex";

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

// Search for ICD-10 codes
const icd10Results = await client.icd10.searchCode({ query: "diabetes type 2" });
console.log(icd10Results.results);

// Look up a specific SNOMED code
const snomedCode = await client.snomed.identifyCode({ code: "73211009" });
console.log(snomedCode.concept);

// Search for CPT procedures
const cptResults = await client.cpt.searchCode({ query: "knee replacement" });
console.log(cptResults.results);

API Categories

Coding Systems

• client.snomed - SNOMED CT clinical terminology
• client.icd10 - ICD-10 diagnosis codes
• client.cpt - CPT procedure codes
• client.hcpcs - HCPCS procedure codes
• client.loinc - LOINC laboratory test codes
• client.rxnorm - RxNorm drug/medication codes

Guidelines

• client.lcd - Local Coverage Determinations
• client.ncd - National Coverage Determinations

Orchestrators

• client.clinical - Cross-engine clinical operations
• client.system - System health and async results

Examples

SNOMED

// Hybrid search
const results = await client.snomed.searchCode({
  query: "heart failure",
  limit: 10,
});

// Lookup by code
const concept = await client.snomed.identifyCode({ code: "84114007" });

ICD-10

// Search with billing filter
const results = await client.icd10.searchCode({
  query: "diabetes",
  billingOnly: true,
  limit: 20,
});

// Lookup specific code
const code = await client.icd10.identifyCode({ code: "E11.9" });

// Get all chapters
const chapters = await client.icd10.getChapters();

CPT/HCPCS

// Search CPT codes
const cptResults = await client.cpt.searchCode({ query: "colonoscopy" });

// Get cost/RVU data
const cost = await client.cpt.getCost({ code: "45378" });

// Get ICD-10 linking terms
const linkTerms = await client.cpt.linkIcd10({ code: "99213" });

// Search HCPCS codes
const hcpcsResults = await client.hcpcs.searchCode({ query: "wheelchair" });

LOINC

// Search lab tests
const results = await client.loinc.searchCode({ query: "glucose" });

// Lookup specific code
const test = await client.loinc.identifyCode({ code: "2345-7" });

// Get panel members
const panel = await client.loinc.getPanelMembers({ code: "24323-8" });

RxNorm

// Search drugs
const results = await client.rxnorm.searchCode({ query: "metformin" });

// Lookup by NDC
const ndcResult = await client.rxnorm.identifyCode({
  type: "ndc",
  code: "0002-4112-01",
});

// Lookup by RXCUI
const rxcuiResult = await client.rxnorm.identifyCode({
  type: "rxcui",
  code: "861004",
});

// Get active ingredients
const ingredients = await client.rxnorm.getIngredients({ rxcui: "861004" });

Guidelines (LCD/NCD)

// Search LCD guidelines
const lcdResults = await client.lcd.searchGuidelines({ query: "MRI" });

// Lookup specific LCD
const lcd = await client.lcd.identifyGuideline({ id: "L33288" });

// Search NCD guidelines
const ncdResults = await client.ncd.searchGuidelines({ query: "oxygen" });

// Lookup NCD by section
const ncd = await client.ncd.identifyGuideline({ section: "220.6" });

Clinical Orchestrator

// Check coverage for CPT + ICD-10 pair
const coverage = await client.clinical.checkCoverage({
  cpt_code: "99213",
  icd10_code: "E11.9",
});

// Map diagnosis to procedures
const procedures = await client.clinical.getProceduresForDiagnosis({
  icd10_code: "M17.11",
});

// Get metadata from all engines
const metadata = await client.clinical.getMetadata();

System

// Health check
const health = await client.system.health();

// Get async result
const result = await client.system.getResult({ request_id: "abc123" });

Configuration

const client = new SequoiaCodexClient({
  apiKey: "your-api-key",
  baseUrl: "https://api.sequoiacodex.com", // optional
  version: "v1", // optional
});

Error Handling

import { SequoiaCodexClient, CodexApiError } from "sequoiacodex";

try {
  const result = await client.icd10.searchCode({ query: "test" });
} catch (error) {
  if (error instanceof CodexApiError) {
    console.error(`API Error ${error.status}: ${error.message}`);
    console.error(`Action: ${error.action}`);
  }
}

TypeScript Support

All methods are fully typed. Import types as needed:

import type {
  SnomedConcept,
  Icd10Code,
  CPTCode,
  LoincCode,
  RxnormDrug,
} from "sequoiacodex";

Agent Skills

This SDK includes agent skills compatible with the Vercel Agent Skills ecosystem. Skills give AI coding agents the knowledge to use the Sequoia Codex SDK for medical coding tasks.

Install Skills

# Install all skills from this repo
npx skills add sequoiaport/sequoia-codex-sdk

# Or install individual skills
npx skills add sequoiaport/sequoia-codex-sdk/medical-codes
npx skills add sequoiaport/sequoia-codex-sdk/icd10-codes
npx skills add sequoiaport/sequoia-codex-sdk/cpt-codes
npx skills add sequoiaport/sequoia-codex-sdk/snomed-codes
npx skills add sequoiaport/sequoia-codex-sdk/hcpcs-codes
npx skills add sequoiaport/sequoia-codex-sdk/loinc-codes
npx skills add sequoiaport/sequoia-codex-sdk/rxnorm-codes

Available Skills

Skill	Description
medical-codes	Comprehensive skill covering all coding systems, guidelines, and clinical orchestration
icd10-codes	ICD-10 diagnosis code search and lookup
cpt-codes	CPT procedure code search, lookup, cost/RVU, and ICD-10 linking
snomed-codes	SNOMED CT clinical terminology search and lookup
hcpcs-codes	HCPCS Level II code search, lookup, and cost
loinc-codes	LOINC laboratory test code search, lookup, and panel members
rxnorm-codes	RxNorm drug code search, NDC/RXCUI lookup, and ingredients

Skills are compatible with Claude Code, Cursor, GitHub Copilot, Gemini, and 17+ other agents.

License

MIT