Addgene Tools#

Configuration File: addgene_tools.json Tool Type: Local Tools Count: 3

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

Available Tools#

Addgene_get_plasmid (Type: AddgeneTool)#

Get detailed information about a specific Addgene plasmid by its catalog ID. Returns full record:…

Addgene_get_plasmid tool specification

Tool Information:

  • Name: Addgene_get_plasmid

  • Type: AddgeneTool

  • Description: Get detailed information about a specific Addgene plasmid by its catalog ID. Returns full record: name, description, cloning details (backbone, promoter, vector types), insert information (gene, species, tags, mutations), bacterial resistance, growth conditions (strain, temperature), article references (DOI, PubMed), and depositor comments. Requires ADDGENE_API_KEY environment variable.

Parameters:

  • operation (string) (optional) Operation type

  • plasmid_id (integer) (required) Addgene plasmid catalog ID (e.g., 39296 for pSpCas9(BB)-2A-Puro, 48138 for pX330)

Example Usage:

query = {
    "name": "Addgene_get_plasmid",
    "arguments": {
        "plasmid_id": 10
    }
}
result = tu.run(query)

Addgene_search_depositors (Type: AddgeneTool)#

Search for Addgene depositors (PIs / principal investigators) by name. The Developers API has no …

Addgene_search_depositors tool specification

Tool Information:

  • Name: Addgene_search_depositors

  • Type: AddgeneTool

  • Description: Search for Addgene depositors (PIs / principal investigators) by name. The Developers API has no reliable institution filter, so institution input returns an explicit error rather than being misapplied to article authors. Depositor plasmid counts are derived from the current plasmid page only; use page continuation to scan all matching plasmids. Requires ADDGENE_API_KEY.

Parameters:

  • operation (string) (optional) Operation type

  • name ([‘string’, ‘null’]) (required) PI or depositor name to search (e.g., ‘Feng Zhang’, ‘Jennifer Doudna’)

  • institution ([‘string’, ‘null’]) (optional) Unsupported by the Addgene Developers API. Supplying this field returns an explicit error instead of an unreliable result.

  • limit (integer) (optional) Number of matching plasmids to scan for depositor information on this page.

  • page (integer) (optional) One-based plasmid result page. Use metadata.next_page to continue scanning depositor matches.

Example Usage:

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

Addgene_search_plasmids (Type: AddgeneTool)#

Search Addgene’s plasmid catalog by name, gene, species, or vector type with explicit page pagina…

Addgene_search_plasmids tool specification

Tool Information:

  • Name: Addgene_search_plasmids

  • Type: AddgeneTool

  • Description: Search Addgene’s plasmid catalog by name, gene, species, or vector type with explicit page pagination. Returns exact total-count and continuation metadata in addition to plasmid fields. Requires ADDGENE_API_KEY environment variable. Use for: finding CRISPR plasmids, AAV vectors, expression constructs, shRNA libraries.

Parameters:

  • operation (string) (optional) Operation type

  • query (string) (required) Plasmid name or keyword to search (e.g., ‘pSpCas9’, ‘GFP’, ‘lentiviral’). Searches the name field.

  • organism ([‘string’, ‘null’]) (optional) Filter by organism/species (e.g., ‘Human’, ‘Mouse’, ‘E. coli’). Maps to the species field.

  • vector_type ([‘string’, ‘null’]) (optional) Filter by vector type (e.g., ‘AAV’, ‘Lentiviral’, ‘Retroviral’, ‘Mammalian Expression’). Maps to vector_types field.

  • limit (integer) (optional) Maximum number of results to return (default 10, max 100)

  • page (integer) (optional) One-based Addgene result page. Use metadata.next_page_number to continue.

Example Usage:

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