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

SettingFormatRequiredDefaultDescription and constraints
pdbFilepdbRequired—Extensions pdb · cif
chainschainsConditionally 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
allChainsbooleanOptionalfalseCompute every protein chain in the structure independently

Output metrics

ColumnDisplay nameRangeUnitDescription
ddGΔΔG—kcal/mol—
pdb_residue_numberOriginal PDB residue number——Identifies the position together with the chain and insertion code
pdb_insertion_codeInsertion 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.

ComponentLicenseCommercial useSourceNotes
CodeMITAllowed, subject to notice requirementsLicense text—
Model weightsMITAllowed, subject to notice requirementsLicense textThe weights are included under models/ in the repository

Checked on 2026-10-06.

References

On this page