sequoia-port/cpt-codes

CPT Codes

Search, lookup, and get cost data for CPT procedure codes via the @sequoiaport/codes package.

When to Apply

• User asks for a CPT code or procedure code
• User needs RVU values or cost data for a procedure
• User wants to find ICD-10 linking terms for a CPT code
• User mentions medical billing, fee schedules, or procedure coding

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.cpt.searchCode({ query, limit? })

Hybrid search for CPT codes by procedure description.

const results = await client.cpt.searchCode({
  query: "knee replacement surgery",
  limit: 10,
});
// results.results → [{ code, short_description, long_description, category, specialty, similarity, ... }]

client.cpt.identifyCode({ code })

Look up a specific CPT code.

const result = await client.cpt.identifyCode({ code: "27447" });
// result.result → { code: "27447", short_description: "Total knee arthroplasty", ... }

client.cpt.getCost({ code })

Get RVU and cost data for a CPT code.

const cost = await client.cpt.getCost({ code: "99213" });
// cost.cost → { code, rvu_work, rvu_pe, rvu_mp, rvu_total, conversion_factor, fee_schedule }

client.cpt.linkIcd10({ code })

Get ICD-10 linking/search terms for a CPT code.

const linking = await client.cpt.linkIcd10({ code: "45378" });
// linking → { code, code_type, short_description, indications, search_terms }

REST API (curl)

# Search CPT codes
curl -X GET "https://api.sequoiacodes.com/v1/cpt/searchCode?query=knee%20arthroscopy&limit=10" \
  -H "Authorization: Bearer $SEQUOIA_CODES_API_KEY"

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

# Get RVU/cost data
curl -X GET "https://api.sequoiacodes.com/v1/cpt/getCost?code=99213" \
  -H "Authorization: Bearer $SEQUOIA_CODES_API_KEY"

# Get ICD-10 linking terms
curl -X GET "https://api.sequoiacodes.com/v1/cpt/linkIcd10?code=29881" \
  -H "Authorization: Bearer $SEQUOIA_CODES_API_KEY"

Response Fields

Each CPT code result includes:

• code - The CPT code (e.g., "99213")
• code_type - "CPT" or "HCPCS"
• short_description / long_description - Descriptions
• indications - Clinical indications
• category / specialty - Classification
• similarity - Search relevance score (0-1)
• rvu_work / rvu_pe / rvu_mp - RVU components (when available)