ThermoMPNN
Suggest single amino-acid substitutions aimed at improving thermal stability, based on a protein structure.
API/CLI tool ID: thermompnn
Understanding inputs and outputs
ThermoMPNN predicts how changing one amino acid affects protein stability from a structure. Select chains with chains, or choose all chains with allChains. Each chain is calculated independently, even when several are selected; this is not a calculation of binding energy between chains.
ddG predicts the change in stability caused by a mutation, in kcal/mol. This tool uses lower values as the favorable direction for comparison. It is neither a temperature change nor experimentally measured thermal stability, and adding single-mutation values does not establish the effect of a combined mutation.
Locate a mutation in the original structure using the chain, pdb_residue_number and pdb_insertion_code together. Do not confuse a position carrying an insertion code with another residue sharing the same number. These identifiers may differ from the row order in the table.
Input settings
| Setting | Format | Required | Default | Description and constraints |
|---|---|---|---|---|
pdbFile | pdb | Required | — | Extensions pdb · cif |
chains | chains | Conditionally required | — | Target chain list — Each chain is calculated independently. Do not set together with allChains=true — JSON array, e.g. ["A"] — Applies when: allChains != true |
allChains | boolean | Optional | false | Compute every protein chain in the structure independently |
Output metrics
| Column | Display name | Range | Unit | Description |
|---|---|---|---|---|
ddG | ΔΔG | — | kcal/mol | — |
pdb_residue_number | Original PDB residue number | — | — | Identifies the position together with the chain and insertion code |
pdb_insertion_code | Insertion code | — | — | Insertion letter from the original PDB. Blank if none. |
See Reading results for metric definitions and interpretation. A range shows possible values; whether higher or lower is better depends on the metric.
Execution availability
Open an execution plan in your project to see available tool versions and costs. Review and approve the inputs, settings, and terms before running.
License
Code, model weights, and accompanying data have their own terms. The table summarizes terms from official sources; check your execution plan for the configuration you will use. License texts are available in Third-party notices.
| Component | License | Commercial use | Source | Notes |
|---|---|---|---|---|
| Code | MIT | Allowed, subject to notice requirements | License text | — |
| Model weights | MIT | Allowed, subject to notice requirements | License text | The weights are included under models/ in the repository |
Checked on 2026-10-06.