Bvbrc Tools

Configuration File: bvbrc_tools.json Tool Type: Local Tools Count: 13

This page contains all tools defined in the bvbrc_tools.json configuration file.

Available Tools

BVBRC_get_genome (Type: BVBRCTool)

Get detailed genome information from BV-BRC (Bacterial and Viral Bioinformatics Resource Center, …

BVBRC_get_genome tool specification

Tool Information:

• Name: BVBRC_get_genome

• Type: BVBRCTool

• Description: Get detailed genome information from BV-BRC (Bacterial and Viral Bioinformatics Resource Center, formerly PATRIC). Returns genome metadata including organism name, taxonomy, genome size, GC content, assembly status, host, disease, and isolation information. BV-BRC is the primary NIAID-funded resource for bacterial and viral pathogen genomics. Example: ‘83332.12’ returns Mycobacterium tuberculosis H37Rv.

Parameters:

• genome_id (string) (required) BV-BRC genome identifier (taxon_id.version format). Examples: ‘83332.12’ (M. tuberculosis H37Rv), ‘511145.12’ (E. coli K-12 MG1655), ‘93061.5’ (S. aureus NCTC 8325).

Example Usage:

query = {
    "name": "BVBRC_get_genome",
    "arguments": {
        "genome_id": "example_value"
    }
}
result = tu.run(query)

BVBRC_get_protein_structure (Type: BVBRCTool)

Get detailed pathogen protein structure information from BV-BRC by PDB ID. Returns structure meta…

BVBRC_get_protein_structure tool specification

Tool Information:

• Name: BVBRC_get_protein_structure

• Type: BVBRCTool

• Description: Get detailed pathogen protein structure information from BV-BRC by PDB ID. Returns structure metadata including title, resolution, method, gene, organism, UniProt accession, PMID references, sequence, and taxonomic lineage. Useful for structural biology research on pathogen proteins. Example: ‘6VSB’ returns the SARS-CoV-2 spike glycoprotein structure.

Parameters:

• pdb_id (string) (required) PDB identifier for the protein structure. Examples: ‘6VSB’ (SARS-CoV-2 spike), ‘7CMD’ (SARS-CoV-2 PLpro), ‘6VW1’ (SARS-CoV-2 RBD-ACE2 complex).

Example Usage:

query = {
    "name": "BVBRC_get_protein_structure",
    "arguments": {
        "pdb_id": "example_value"
    }
}
result = tu.run(query)

BVBRC_get_taxonomy (Type: BVBRCTool)

Get detailed taxonomy information for a pathogen from BV-BRC by NCBI Taxonomy ID. Returns taxon n…

BVBRC_get_taxonomy tool specification

Tool Information:

• Name: BVBRC_get_taxonomy

• Type: BVBRCTool

• Description: Get detailed taxonomy information for a pathogen from BV-BRC by NCBI Taxonomy ID. Returns taxon name, rank, lineage, alternative names, and genome counts. Useful for resolving pathogen taxonomy and understanding classification hierarchy. Example: ‘2697049’ returns SARS-CoV-2 taxonomy with full lineage from Viruses to species.

Parameters:

• taxon_id (string) (required) NCBI Taxonomy ID. Examples: ‘2697049’ (SARS-CoV-2), ‘1773’ (M. tuberculosis), ‘1280’ (S. aureus), ‘11320’ (Influenza A).

Example Usage:

query = {
    "name": "BVBRC_get_taxonomy",
    "arguments": {
        "taxon_id": "example_value"
    }
}
result = tu.run(query)

BVBRC_search_amr (Type: BVBRCTool)

Search for antimicrobial resistance (AMR) phenotype data in BV-BRC. Returns resistance/susceptibi…

BVBRC_search_amr tool specification

Tool Information:

• Name: BVBRC_search_amr

• Type: BVBRCTool

• Description: Search for antimicrobial resistance (AMR) phenotype data in BV-BRC. Returns resistance/susceptibility data for pathogens against specific antibiotics, including MIC values, testing methods, and evidence. Essential for AMR surveillance research. Example: search for methicillin resistance in Staphylococcus aureus.

Parameters:

• antibiotic ([‘string’, ‘null’]) (optional) Antibiotic name to search for. Examples: ‘methicillin’, ‘vancomycin’, ‘ciprofloxacin’, ‘amikacin’, ‘isoniazid’.

• genome_id ([‘string’, ‘null’]) (optional) BV-BRC genome ID to get AMR data for a specific genome. Example: ‘83332.12’.

• resistant_phenotype ([‘string’, ‘null’]) (optional) Filter by resistance phenotype. Options: ‘Resistant’, ‘Susceptible’, ‘Intermediate’.

• limit ([‘integer’, ‘null’]) (optional) Maximum number of results. Default: 25. Max: 100.

Example Usage:

query = {
    "name": "BVBRC_search_amr",
    "arguments": {
    }
}
result = tu.run(query)

BVBRC_search_epitopes (Type: BVBRCTool)

Search for pathogen epitopes (B-cell and T-cell) in BV-BRC. Returns epitope sequences, types, pro…

BVBRC_search_epitopes tool specification

Tool Information:

• Name: BVBRC_search_epitopes

• Type: BVBRCTool

• Description: Search for pathogen epitopes (B-cell and T-cell) in BV-BRC. Returns epitope sequences, types, protein associations, and assay results for vaccine and immunology research. Covers epitopes from IEDB for bacteria and viruses including SARS-CoV-2, influenza, tuberculosis, and other pathogens. Example: search taxon_id 2697049 for SARS-CoV-2 spike glycoprotein epitopes.

Parameters:

• taxon_id ([‘string’, ‘null’]) (optional) NCBI Taxonomy ID for the pathogen organism. Examples: ‘2697049’ (SARS-CoV-2), ‘11320’ (Influenza A), ‘1773’ (M. tuberculosis).

• protein_name ([‘string’, ‘null’]) (optional) Target protein name to filter epitopes. Examples: ‘Spike glycoprotein’, ‘Nucleocapsid protein’, ‘Replicase polyprotein 1ab’.

• epitope_type ([‘string’, ‘null’]) (optional) Type of epitope. Options: ‘Linear peptide’, ‘Discontinuous peptide’. Most epitopes are linear peptides.

• organism ([‘string’, ‘null’]) (optional) Organism name keyword to search across epitope records. Example: ‘coronavirus’, ‘influenza’.

• limit ([‘integer’, ‘null’]) (optional) Maximum number of results. Default: 25. Max: 100.

Example Usage:

query = {
    "name": "BVBRC_search_epitopes",
    "arguments": {
    }
}
result = tu.run(query)

BVBRC_search_genome_features (Type: BVBRCTool)

Search for genome features (genes, proteins, CDS) in BV-BRC pathogen genomes. Find specific genes…

BVBRC_search_genome_features tool specification

Tool Information:

• Name: BVBRC_search_genome_features

• Type: BVBRCTool

• Description: Search for genome features (genes, proteins, CDS) in BV-BRC pathogen genomes. Find specific genes like antimicrobial resistance genes (mecA, blaTEM), virulence factors, or any annotated feature across thousands of pathogen genomes. Example: search for ‘mecA’ gene (methicillin resistance) across all genomes.

Parameters:

• gene ([‘string’, ‘null’]) (optional) Gene name to search for. Examples: ‘mecA’ (methicillin resistance), ‘blaTEM’ (beta-lactamase), ‘katG’ (isoniazid resistance).

• product ([‘string’, ‘null’]) (optional) Gene product keyword to search. Examples: ‘beta-lactamase’, ‘penicillin-binding protein’, ‘DNA gyrase’.

• genome_id ([‘string’, ‘null’]) (optional) Restrict search to a specific genome. Example: ‘83332.12’.

• limit ([‘integer’, ‘null’]) (optional) Maximum number of results. Default: 10. Max: 100.

Example Usage:

query = {
    "name": "BVBRC_search_genome_features",
    "arguments": {
    }
}
result = tu.run(query)

BVBRC_search_genomes (Type: BVBRCTool)

Search for pathogen genomes in BV-BRC by organism name or keyword. Returns a list of matching gen…

BVBRC_search_genomes tool specification

Tool Information:

• Name: BVBRC_search_genomes

• Type: BVBRCTool

• Description: Search for pathogen genomes in BV-BRC by organism name or keyword. Returns a list of matching genomes with metadata. Useful for finding bacterial or viral genome assemblies. Example: ‘Staphylococcus aureus’ returns all S. aureus genome assemblies.

Parameters:

• keyword (string) (required) Search keyword - organism name, strain, or pathogen. Examples: ‘Staphylococcus aureus’, ‘Escherichia coli’, ‘Salmonella enterica’, ‘SARS-CoV-2’.

• limit ([‘integer’, ‘null’]) (optional) Maximum number of results to return. Default: 10. Max: 100.

Example Usage:

query = {
    "name": "BVBRC_search_genomes",
    "arguments": {
        "keyword": "example_value"
    }
}
result = tu.run(query)

BVBRC_search_pathways (Type: BVBRCTool)

Search for metabolic pathways in pathogen genomes from BV-BRC. Returns KEGG pathway assignments w…

BVBRC_search_pathways tool specification

Tool Information:

• Name: BVBRC_search_pathways

• Type: BVBRCTool

• Description: Search for metabolic pathways in pathogen genomes from BV-BRC. Returns KEGG pathway assignments with EC numbers, enzyme descriptions, and genome associations. Useful for understanding pathogen metabolism and identifying potential drug targets. Example: search for pathways in M. tuberculosis (taxon_id 1773).

Parameters:

• taxon_id ([‘string’, ‘null’]) (optional) NCBI Taxonomy ID. Examples: ‘1773’ (M. tuberculosis), ‘562’ (E. coli), ‘1280’ (S. aureus).

• pathway_name ([‘string’, ‘null’]) (optional) Pathway name keyword. Examples: ‘Glycolysis’, ‘Fatty acid’, ‘Amino acid’, ‘Sulfur metabolism’.

• ec_number ([‘string’, ‘null’]) (optional) Enzyme Commission number. Examples: ‘1.11.1.6’ (catalase), ‘2.7.1.1’ (hexokinase).

• genome_id ([‘string’, ‘null’]) (optional) Restrict to a specific genome. Example: ‘83332.12’ (M. tuberculosis H37Rv).

• limit ([‘integer’, ‘null’]) (optional) Maximum number of results. Default: 25. Max: 100.

Example Usage:

query = {
    "name": "BVBRC_search_pathways",
    "arguments": {
    }
}
result = tu.run(query)

BVBRC_search_protein_structures (Type: BVBRCTool)

Search for pathogen protein structures in BV-BRC by organism (taxon_id), gene name, or experiment…

BVBRC_search_protein_structures tool specification

Tool Information:

• Name: BVBRC_search_protein_structures

• Type: BVBRCTool

• Description: Search for pathogen protein structures in BV-BRC by organism (taxon_id), gene name, or experimental method. Returns PDB entries with titles, resolution, methods, and references. Covers viral and bacterial protein structures linked to BV-BRC genome annotations. Example: search for all SARS-CoV-2 protein structures with taxon_id 2697049.

Parameters:

• taxon_id ([‘string’, ‘null’]) (optional) NCBI Taxonomy ID. Examples: ‘2697049’ (SARS-CoV-2), ‘1773’ (M. tuberculosis), ‘11320’ (Influenza A).

• gene ([‘string’, ‘null’]) (optional) Gene name filter. Examples: ‘S’ (spike), ‘rep’ (replicase), ‘N’ (nucleocapsid).

• method ([‘string’, ‘null’]) (optional) Experimental method. Examples: ‘X-ray diffraction’, ‘Electron microscopy’, ‘Solution NMR’.

• limit ([‘integer’, ‘null’]) (optional) Maximum number of results. Default: 10. Max: 100.

Example Usage:

query = {
    "name": "BVBRC_search_protein_structures",
    "arguments": {
    }
}
result = tu.run(query)

BVBRC_search_specialty_genes (Type: BVBRCTool)

Search for specialty genes in BV-BRC including virulence factors, antibiotic resistance genes, dr…

BVBRC_search_specialty_genes tool specification

Tool Information:

• Name: BVBRC_search_specialty_genes

• Type: BVBRCTool

• Description: Search for specialty genes in BV-BRC including virulence factors, antibiotic resistance genes, drug targets, and human homologs across pathogen genomes. Data sourced from CARD, NDARO, VFDB, PATRIC_VF, and other curated databases. Essential for identifying key pathogenicity and resistance determinants. Example: search for ‘mecA’ (methicillin resistance gene in Staphylococcus).

Parameters:

• gene ([‘string’, ‘null’]) (optional) Gene name to search. Examples: ‘mecA’ (methicillin resistance), ‘katG’ (isoniazid resistance), ‘drrC’ (efflux pump).

• property ([‘string’, ‘null’]) (optional) Specialty gene property category. Options: ‘Antibiotic Resistance’, ‘Virulence Factor’, ‘Drug Target’, ‘Transporter’, ‘Human Homolog’.

• source ([‘string’, ‘null’]) (optional) Source database for annotation. Options: ‘CARD’, ‘NDARO’, ‘PATRIC_VF’, ‘VFDB’, ‘DrugBank’, ‘TTD’, ‘Human’.

• taxon_id ([‘string’, ‘null’]) (optional) NCBI Taxonomy ID. Examples: ‘1280’ (S. aureus), ‘1773’ (M. tuberculosis), ‘562’ (E. coli).

• limit ([‘integer’, ‘null’]) (optional) Maximum number of results. Default: 25. Max: 100.

Example Usage:

query = {
    "name": "BVBRC_search_specialty_genes",
    "arguments": {
    }
}
result = tu.run(query)

BVBRC_search_subsystems (Type: BVBRCTool)

Search for functional subsystems (curated groups of functionally related proteins) in BV-BRC path…

BVBRC_search_subsystems tool specification

Tool Information:

• Name: BVBRC_search_subsystems

• Type: BVBRCTool

• Description: Search for functional subsystems (curated groups of functionally related proteins) in BV-BRC pathogen genomes. Returns subsystem classifications including superclass, class, subclass, and specific functional roles. Useful for understanding pathogen functional organization and comparing metabolic capabilities. Example: search for virulence-related subsystems in M. tuberculosis.

Parameters:

• taxon_id ([‘string’, ‘null’]) (optional) NCBI Taxonomy ID. Examples: ‘1773’ (M. tuberculosis), ‘1280’ (S. aureus), ‘562’ (E. coli).

• superclass ([‘string’, ‘null’]) (optional) Top-level functional category. Options include: ‘METABOLISM’, ‘STRESS RESPONSE, DEFENSE, VIRULENCE’, ‘ENERGY’, ‘CELLULAR PROCESSES’, ‘DNA PROCESSING’, ‘PROTEIN PROCESSING’, ‘CELL ENVELOPE’, ‘RNA PROCESSING’.

• subsystem_name ([‘string’, ‘null’]) (optional) Subsystem name keyword. Examples: ‘mycothiol’, ‘iron acquisition’, ‘beta-lactam resistance’.

• role_name ([‘string’, ‘null’]) (optional) Specific functional role keyword. Examples: ‘catalase’, ‘penicillin-binding protein’.

• genome_id ([‘string’, ‘null’]) (optional) Restrict to a specific genome. Example: ‘83332.12’.

• limit ([‘integer’, ‘null’]) (optional) Maximum number of results. Default: 25. Max: 100.

Example Usage:

query = {
    "name": "BVBRC_search_subsystems",
    "arguments": {
    }
}
result = tu.run(query)

BVBRC_search_surveillance (Type: BVBRCTool)

Search influenza and pathogen surveillance data in BV-BRC. Returns surveillance samples with host…

BVBRC_search_surveillance tool specification

Tool Information:

• Name: BVBRC_search_surveillance

• Type: BVBRCTool

• Description: Search influenza and pathogen surveillance data in BV-BRC. Returns surveillance samples with host species, geographic location, subtype, and collection metadata. Essential for epidemiological tracking of influenza subtypes (H5N1, H1N1, H3N2) and other monitored pathogens across global regions. Example: search for H5N1 cases in North America.

Parameters:

• subtype ([‘string’, ‘null’]) (optional) Influenza subtype to search for. Examples: ‘H5N1’, ‘H1N1’, ‘H3N2’, ‘H7N9’. Common in surveillance tracking.

• geographic_group ([‘string’, ‘null’]) (optional) Geographic region filter. Options: ‘North America’, ‘Europe’, ‘Asia’, ‘Africa’, ‘South America’, ‘Oceania’.

• host_group ([‘string’, ‘null’]) (optional) Host organism group. Options: ‘Human’, ‘Animal’, ‘Avian’, ‘Swine’, ‘Environment’.

• collection_country ([‘string’, ‘null’]) (optional) Country of sample collection. Examples: ‘USA’, ‘China’, ‘Egypt’, ‘Vietnam’.

• limit ([‘integer’, ‘null’]) (optional) Maximum number of results. Default: 25. Max: 100.

Example Usage:

query = {
    "name": "BVBRC_search_surveillance",
    "arguments": {
    }
}
result = tu.run(query)

BVBRC_search_taxonomy (Type: BVBRCTool)

Search for pathogen taxonomy entries in BV-BRC by keyword. Returns matching taxa with names, rank…

BVBRC_search_taxonomy tool specification

Tool Information:

• Name: BVBRC_search_taxonomy

• Type: BVBRCTool

• Description: Search for pathogen taxonomy entries in BV-BRC by keyword. Returns matching taxa with names, ranks, genome counts, and lineage information. Useful for discovering pathogen taxon IDs for use with other BV-BRC tools. Example: ‘Mycobacterium’ returns the Mycobacterium genus and all its species.

Parameters:

• keyword (string) (required) Taxonomy search keyword. Examples: ‘Mycobacterium’, ‘coronavirus’, ‘Salmonella’, ‘influenza’, ‘Ebola’.

• limit ([‘integer’, ‘null’]) (optional) Maximum number of results. Default: 10. Max: 100.

Example Usage:

query = {
    "name": "BVBRC_search_taxonomy",
    "arguments": {
        "keyword": "example_value"
    }
}
result = tu.run(query)

Navigation

• Available Tools - Back to Tools Overview

• Tool Loading Tutorial - Loading Local Tools