Swissmodel Tools#
Configuration File: swissmodel_tools.json
Tool Type: Local
Tools Count: 4
This page contains all tools defined in the swissmodel_tools.json configuration file.
Available Tools#
SwissModel_download_pdb (Type: SwissModelTool)#
Download the actual 3D atomic coordinates (PDB format) of SWISS-MODEL Repository structures for a…
SwissModel_download_pdb tool specification
Tool Information:
Name:
SwissModel_download_pdbType:
SwissModelToolDescription: Download the actual 3D atomic coordinates (PDB format) of SWISS-MODEL Repository structures for a UniProt accession. Unlike SwissModel_get_models / SwissModel_get_summary (which return only JSON metadata and a coordinates URL), this tool fetches the real ATOM/HETATM records and returns them as text. Optional selectors: ‘sort’ (‘seqid’ = sequence identity, or ‘seqsim’ = sequence similarity) orders the bundled models; ‘provider’ restricts to ‘swissmodel’ (homology models) or ‘pdb’ (experimental structures); ‘template’ selects a specific template; ‘range’ restricts to models covering a residue range. Example: P04637 (human p53) returns ~5.5 MB of coordinates; provider=swissmodel isolates the homology model with a SWISS-MODEL TITLE header. Use the returned ‘pdb_content’ for structural analysis, visualization, or docking.
Parameters:
uniprot_id(string) (required) UniProt accession identifier. Examples: ‘P04637’ (human p53), ‘P00533’ (human EGFR).sort([‘string’, ‘null’]) (optional) Optional ordering for the bundled models. ‘seqid’ sorts by sequence identity to the template, ‘seqsim’ by sequence similarity.provider([‘string’, ‘null’]) (optional) Optional model-provider filter. ‘swissmodel’ = SWISS-MODEL homology models only; ‘pdb’ = experimental PDB structures only. Omit for all.template([‘string’, ‘null’]) (optional) Optional template filter; download only models built from this template (PDB ID, optionally with chain).range([‘string’, ‘null’]) (optional) Optional residue range filter (‘from-to’, e.g. ‘94-312’); download only models covering this range.
Example Usage:
query = {
"name": "SwissModel_download_pdb",
"arguments": {
"uniprot_id": "example_value"
}
}
result = tu.run(query)
SwissModel_get_models (Type: SwissModelTool)#
Get a paginated list of protein structures from SWISS-MODEL Repository for a UniProt accession. R…
SwissModel_get_models tool specification
Tool Information:
Name:
SwissModel_get_modelsType:
SwissModelToolDescription: Get a paginated list of protein structures from SWISS-MODEL Repository for a UniProt accession. Results include homology models and experimental PDB structures, template, coverage, quality scores, coordinates URL, and complete complex-partner lists. Use next_offset while has_more is true; total_models is the total after optional range/provider/template filters and model_count counts the models on this page.
Parameters:
uniprot_id(string) (required) UniProt accession identifier. Examples: ‘P04637’ (human p53), ‘P00533’ (human EGFR), ‘Q9Y6I3’ (human EPN1).range([‘string’, ‘null’]) (optional) Optional residue range filter; only models covering this range are returned. Format ‘from-to’, e.g. ‘94-312’.provider([‘string’, ‘null’]) (optional) Optional model-provider filter. ‘swissmodel’ returns only SWISS-MODEL homology models; ‘pdb’ returns only experimental PDB structures. Omit for both.template([‘string’, ‘null’]) (optional) Optional template filter; restrict results to models built from this template (PDB ID, optionally with chain, e.g. ‘2j6m.1.A’).limit(integer) (optional) Maximum models to return in this page.offset(integer) (optional) Zero-based model offset. Continue with next_offset while has_more is true.
Example Usage:
query = {
"name": "SwissModel_get_models",
"arguments": {
"uniprot_id": "example_value"
}
}
result = tu.run(query)
SwissModel_get_models_batch (Type: SwissModelTool)#
Batch SWISS-MODEL Repository lookup for up to 250 UniProt accessions in a single call. Each resul…
SwissModel_get_models_batch tool specification
Tool Information:
Name:
SwissModel_get_models_batchType:
SwissModelToolDescription: Batch SWISS-MODEL Repository lookup for up to 250 UniProt accessions in a single call. Each result exposes model_count, models_returned, has_more, and next_model_offset, so model lists beyond the default first 30 are recoverable using model_offset. The same offset window is applied independently to every requested accession. Example: P04637 has hundreds of structures that can be paged through without silent truncation.
Parameters:
uniprot_ids([‘array’, ‘string’]) (required) List of up to 250 UniProt accessions, e.g. [‘P04637’, ‘P00533’, ‘P38398’]. A comma-separated string is also accepted.model_limit(integer) (optional) Maximum models returned per accession (1-500; default 30).model_offset(integer) (optional) Zero-based model offset applied independently to each accession.
Example Usage:
query = {
"name": "SwissModel_get_models_batch",
"arguments": {
"uniprot_ids": "example_value"
}
}
result = tu.run(query)
SwissModel_get_summary (Type: SwissModelTool)#
Get a summary of the best available homology model from SWISS-MODEL Repository for a UniProt acce…
SwissModel_get_summary tool specification
Tool Information:
Name:
SwissModel_get_summaryType:
SwissModelToolDescription: Get a summary of the best available homology model from SWISS-MODEL Repository for a UniProt accession. Returns the model with highest sequence coverage, total model count, methods distribution, and quality metrics. Useful for quickly checking if a homology model exists for a protein of interest. Example: P04637 (human p53) has 4 models, best covers residues 12-351 (86.5% coverage).
Parameters:
uniprot_id(string) (required) UniProt accession identifier. Examples: ‘P04637’ (human p53), ‘P00533’ (human EGFR).
Example Usage:
query = {
"name": "SwissModel_get_summary",
"arguments": {
"uniprot_id": "example_value"
}
}
result = tu.run(query)