Get Gene Mutations
get_gene_mutationsRetrieve distinct somatic mutations of one gene in a cBioPortal study, ordered by recurrence, with protein change, samples, mutation type, genomic coordinates, and study licence. Filter by protein change as needed.
Instructions
Get the distinct somatic mutations of one gene in one study, most recurrent first: protein_change, samples, mutation_type and genomic chr/start/end/ref/alt with their assembly (mostly GRCh37), plus mutated_samples and the study's licence and citation. protein_change keeps one change. No sample or patient IDs. Signature: get_gene_mutations(gene, study_id, protein_change=, include_restricted=, response_mode=, limit=, offset=).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"gene": "<gene>",
"study_id": "<study_id>"
},
"name": "get_gene_mutations"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| gene | Yes | Gene symbol (HGNC, e.g. BRAF) or NCBI Gene ID (673 or NCBIGene:673). | |
| limit | No | Max rows (default 20, max 100). | |
| offset | No | Rows to skip; use the previous `next_offset`. | |
| study_id | Yes | cBioPortal study ID (from search_studies). | |
| response_mode | No | minimal: protein change and samples | compact (default): + type and genomic coordinates | standard/full: + variant type, RefSeq transcript, protein position, keyword. | |
| protein_change | No | One-letter protein change, e.g. V600E or G12C (p. prefix optional). | |
| include_restricted | No | Opt in to studies with non-commercial/no-derivatives terms (flagged). |