← 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
| Name | Type | Description | |
|---|---|---|---|
| table | string | required | Dataset id or alias (see the catalog below). |
| query | string | required | Code fragment or term to search. |
| limit | number | optional | Max 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)
| icd10cm | ICD-10-CM diagnoses |
| icd11_codes | ICD-11 (WHO) |
| hpo | Human Phenotype Ontology |
| icd9cm_dx | ICD-9-CM diagnoses |
| icd9cm_sg | ICD-9-CM procedures |
| hcpcs | HCPCS Level II |
| conditions | Medical conditions |
| procedures | Surgeries & implants |
| rxterms | RxTerms drug names |
| drug_ingredients | Prescribable drug ingredients (RxTerms) |
| loinc | LOINC questions & forms |
| npi_idv | NPI individuals |
| npi_org | NPI organizations |
| ucum | UCUM units of measure |
| cosmic | COSMIC somatic mutations (Sanger) |
| cosmic_struct | COSMIC structural rearrangements (Sanger) |
| dbvar | dbVar structural variations, germline GRCh37 (NCBI) |
| genetic_diseases | Genetic diseases (ClinVar disease names → MedGen ConceptID) |
| genes | Genes (HGNC — symbol, name, location, RefSeq) |
| ncbi_genes | NCBI genes (Entrez GeneID, type, description) |
| snps | dbSNP variants (rs → gene, GRCh38 chr/pos/alleles) |
| cytogenetic_locs | Cytogenetic locations (NCBI ideogram, GRCh37) |
| refseqs | RefSeq accessions (NCBI, GRCh37) |
| star_alleles | PharmVar CYP star alleles (pharmacogenomics) |
- Friendly aliases also work, e.g.
icd10,snp,pharmvar,genes.