Get Gene Alteration Frequency
get_gene_alteration_frequencyCalculate how often a gene is mutated or copy-number altered across cBioPortal studies, optionally by protein change, with profiled denominators and per-study licence details.
Instructions
Get how often a gene is altered per cBioPortal study: mutation (altered / profiled samples, panel-aware), optional protein_change (e.g. KRAS G12C) and CNA (amplified / deep-deleted / profiled), each row with licence, citation and import_date. Pick studies by cancer_type (OncoTree code, subtypes included, largest first, max_studies; total/truncated count matching studies) or study_ids; neither = MSK-IMPACT 2017 pan-cancer. Never sum rows (cohorts overlap). Restricted (NC/ND) studies are skipped unless include_restricted. Signature: get_gene_alteration_frequency(gene, cancer_type=, study_ids=, protein_change=, include_restricted=, max_studies=).
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>"
},
"name": "get_gene_alteration_frequency"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| gene | Yes | Gene symbol (HGNC, e.g. BRAF) or NCBI Gene ID (673 or NCBIGene:673). | |
| study_ids | No | Explicit study IDs (1-10); instead of cancer_type. | |
| cancer_type | No | Lowercase OncoTree code as cBioPortal uses it (luad, skcm, mel); subtypes are included. Find codes with list_cancer_types. | |
| max_studies | No | With cancer_type: studies to query (default 3). | |
| 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). |