Usda Plants Tools

Configuration File: usda_plants_tools.json Tool Type: Local Tools Count: 6

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

Available Tools

USDA_plants_get_characteristics (Type: USDAPlantsCharacteristicsTool)

Get the USDA PLANTS morphology/physiology, growth-requirement, and reproduction characteristics f…

USDA_plants_get_characteristics tool specification

Tool Information:

  • Name: USDA_plants_get_characteristics

  • Type: USDAPlantsCharacteristicsTool

  • Description: Get the USDA PLANTS morphology/physiology, growth-requirement, and reproduction characteristics for a plant by its PLANTS symbol (e.g. ‘ABBA’). Returns a list of characteristic name/value/category entries (e.g. active growth period, shade tolerance, drought tolerance, mature height, bloom period). Resolves the symbol to the plant id automatically. No API key required.

Parameters:

  • symbol (string) (required) USDA PLANTS symbol, e.g. ‘ABBA’, ‘ACRU’.

Example Usage:

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

USDA_plants_get_invasive_status (Type: USDAPlantsProfileTool)

Get state-by-state invasive and noxious-weed legal status for a plant from the USDA PLANTS Databa…

USDA_plants_get_invasive_status tool specification

Tool Information:

  • Name: USDA_plants_get_invasive_status

  • Type: USDAPlantsProfileTool

  • Description: Get state-by-state invasive and noxious-weed legal status for a plant from the USDA PLANTS Database. Returns per-jurisdiction invasive listings (e.g. ‘Invasive’, ‘Potentially Invasive’, ‘Prohibited’ by state) and federal/state noxious-weed statuses. Critical for agriculture, land management, and regulatory compliance. Provide a PLANTS ‘symbol’ (e.g. ‘PUMO’ = kudzu, resolved to its plant Id automatically) or a numeric ‘id’ directly. No API key required.

Parameters:

  • symbol ([‘string’, ‘null’]) (optional) USDA PLANTS symbol, e.g. ‘PUMO’ (Pueraria montana / kudzu). Resolved to the plant Id automatically. Use USDA_plants_search_by_name to find a symbol from a name.

  • id ([‘integer’, ‘null’]) (optional) Numeric USDA PLANTS Id (e.g. 82047). Use instead of ‘symbol’ if known.

Example Usage:

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

USDA_plants_get_profile (Type: USDAPlantsProfileTool)

Get a USDA PLANTS Database profile for a plant by its PLANTS symbol (e.g. ‘ABBA’ = balsam fir): s…

USDA_plants_get_profile tool specification

Tool Information:

  • Name: USDA_plants_get_profile

  • Type: USDAPlantsProfileTool

  • Description: Get a USDA PLANTS Database profile for a plant by its PLANTS symbol (e.g. ‘ABBA’ = balsam fir): scientific name, common name, taxonomic group/rank, duration (annual/perennial), growth habits (tree/shrub/forb), native status, synonyms, and US distribution FIPS codes. Authoritative US plant taxonomy. No API key required.

Parameters:

  • symbol (string) (required) USDA PLANTS symbol, e.g. ‘ABBA’ (balsam fir), ‘ACRU’ (red maple), ‘QUAL’ (white oak).

Example Usage:

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

USDA_plants_get_wetland_status (Type: USDAPlantsProfileTool)

Get USACE wetland indicator status by geographic region for a plant from the USDA PLANTS Database…

USDA_plants_get_wetland_status tool specification

Tool Information:

  • Name: USDA_plants_get_wetland_status

  • Type: USDAPlantsProfileTool

  • Description: Get USACE wetland indicator status by geographic region for a plant from the USDA PLANTS Database. Returns the wetland indicator code per region: OBL (obligate wetland), FACW (facultative wetland), FAC (facultative), FACU (facultative upland), or UPL (upland). Core data for wetland delineation, restoration ecology, and Clean Water Act jurisdictional determinations. Provide a PLANTS ‘symbol’ (e.g. ‘TYLA’ = common cattail, resolved to its plant Id automatically) or a numeric ‘id’ directly. No API key required.

Parameters:

  • symbol ([‘string’, ‘null’]) (optional) USDA PLANTS symbol, e.g. ‘TYLA’ (Typha latifolia / common cattail). Resolved to the plant Id automatically. Use USDA_plants_search_by_name to find a symbol from a name.

  • id ([‘integer’, ‘null’]) (optional) Numeric USDA PLANTS Id (e.g. 27001). Use instead of ‘symbol’ if known.

Example Usage:

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

USDA_plants_get_wildlife_value (Type: USDAPlantsProfileTool)

Get wildlife food and cover value ratings for a plant from the USDA PLANTS Database. Returns fora…

USDA_plants_get_wildlife_value tool specification

Tool Information:

  • Name: USDA_plants_get_wildlife_value

  • Type: USDAPlantsProfileTool

  • Description: Get wildlife food and cover value ratings for a plant from the USDA PLANTS Database. Returns forage/cover importance ratings (e.g. Minor, Low, Moderate, High) to large mammals, small mammals, water birds, and terrestrial birds, by source, plus the cited sources. Used in habitat/restoration and conservation planning. Provide a PLANTS ‘symbol’ (e.g. ‘SANIC4’ = elderberry, resolved to its plant Id automatically) or a numeric ‘id’ directly. No API key required.

Parameters:

  • symbol ([‘string’, ‘null’]) (optional) USDA PLANTS symbol, e.g. ‘SANIC4’ (Sambucus nigra ssp. canadensis / elderberry). Resolved to the plant Id automatically. Use USDA_plants_search_by_name to find a symbol from a name.

  • id ([‘integer’, ‘null’]) (optional) Numeric USDA PLANTS Id (e.g. 42834). Use instead of ‘symbol’ if known.

Example Usage:

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

USDA_plants_search_by_name (Type: USDAPlantsProfileTool)

Resolve a plant scientific name, common name, or genus to USDA PLANTS symbol(s). The other USDA P…

USDA_plants_search_by_name tool specification

Tool Information:

  • Name: USDA_plants_search_by_name

  • Type: USDAPlantsProfileTool

  • Description: Resolve a plant scientific name, common name, or genus to USDA PLANTS symbol(s). The other USDA PLANTS tools (USDA_plants_get_profile, USDA_plants_get_characteristics) require a PLANTS symbol (e.g. ‘ABBA’) as input; use this tool first when you only know the plant by name. Returns a list of matching plants, each with its Symbol, ScientificName, CommonName, and Rank (Species/Genus/Variety). Example: ‘white oak’ -> QUAR / Quercus arizonica (Arizona white oak); ‘red maple’ -> ACRU / Acer rubrum; ‘Quercus’ -> QUERC (Genus). No API key required.

Parameters:

  • searchText (string) (required) Plant scientific name, common name, or genus to search. Examples: ‘white oak’, ‘red maple’, ‘Quercus’, ‘Acer rubrum’.

  • limit ([‘integer’, ‘null’]) (optional) Maximum number of matches to return (default 25, max 200).

Example Usage:

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