clinical-mcp

Tool reference
← All tools  /  Clinical Tables & Code Lookups
search_clinical_codeslive API

Search any clinical/genomics dataset

One generic lookup over every registered NLM Clinical Tables dataset — clinical codes (ICD, HCPCS, LOINC, conditions, NPI, UCUM, HPO) AND genomics (ClinVar, COSMIC, dbVar, genes, dbSNP, PharmVar, …). Returns uniform {code, name} rows.

How to use

Pass a `table` id (or a friendly alias like "icd10", "snp", "pharmvar") and a search `query`. For the most common datasets, prefer the dedicated tools (they return richer fields). Unknown table → a helpful error listing valid ids.

Parameters

NameTypeDescription
tablestringrequiredDataset id or alias (see the catalog below).
querystringrequiredCode fragment or term to search.
limitnumberoptionalMax results (default 20).

Example input

{
  "table": "cosmic",
  "query": "BRAF",
  "limit": 3
}

Example output

{
  "table": "COSMIC somatic mutations (Sanger)",
  "total": 828,
  "rows": [
    {
      "code": "COSM6904785",
      "name": "BRAF — c.? — p.A598V"
    },
    {
      "code": "COSM476",
      "name": "BRAF — c.1799T>A — p.V600E"
    }
  ]
}

Call it (MCP tools/call)

{
  "method": "tools/call",
  "params": {
    "name": "search_clinical_codes",
    "arguments": {
      "table": "cosmic",
      "query": "BRAF",
      "limit": 3
    }
  }
}
  • Endpoint: POST https://clinical-mcp.mcharge.in/mcp (Streamable HTTP).

Available datasets (the table parameter)

icd10cmICD-10-CM diagnoses
icd11_codesICD-11 (WHO)
hpoHuman Phenotype Ontology
icd9cm_dxICD-9-CM diagnoses
icd9cm_sgICD-9-CM procedures
hcpcsHCPCS Level II
conditionsMedical conditions
proceduresSurgeries & implants
rxtermsRxTerms drug names
drug_ingredientsPrescribable drug ingredients (RxTerms)
loincLOINC questions & forms
npi_idvNPI individuals
npi_orgNPI organizations
ucumUCUM units of measure
cosmicCOSMIC somatic mutations (Sanger)
cosmic_structCOSMIC structural rearrangements (Sanger)
dbvardbVar structural variations, germline GRCh37 (NCBI)
genetic_diseasesGenetic diseases (ClinVar disease names → MedGen ConceptID)
genesGenes (HGNC — symbol, name, location, RefSeq)
ncbi_genesNCBI genes (Entrez GeneID, type, description)
snpsdbSNP variants (rs → gene, GRCh38 chr/pos/alleles)
cytogenetic_locsCytogenetic locations (NCBI ideogram, GRCh37)
refseqsRefSeq accessions (NCBI, GRCh37)
star_allelesPharmVar CYP star alleles (pharmacogenomics)
  • Friendly aliases also work, e.g. icd10, snp, pharmvar, genes.