get_genotox_details
Retrieve detailed genotoxicity study data including test methods, guidelines, species, exposure conditions, and results to assess DNA damage potential of substances.
Instructions
Get genotoxicity study details from GENOTOX table by GENOTOX_ID.
Retrieves detailed genotoxicity study records including test methods, guidelines,
and results. This tool provides the experimental data used to assess whether
substances have genotoxic or mutagenic properties that could cause DNA damage.
Args:
genotox_id: Single GENOTOX_ID (int) or list of GENOTOX_IDs (list[int]) to query.
Use search_substance tool first to find GENOTOX_IDs through the STUDY table.
Returns:
JSON string containing a DataFrame with genotoxicity study records. Each record
includes study category, test guidelines, species, exposure conditions, and
genotoxicity results.
The returned data includes:
- Study category: STUDY_CATEGORY
- Test guidelines: GENOTOXGUIDELINE, GENOTOXGUIDELINEFULLTXT
- Test conditions: SPECIES, STRAIN, SEX, ROUTE, EXP_PERIOD, EXPPERIODUNIT
- Genotoxicity result: IS_GENOTOXIC
- Study quality: GLP_COMPL, DEVIATION
- Study details: NUMBER_INDIVIDUALS, CONTROL, MET_INDICATOR, REMARKS
Note: Multiple records may be returned if multiple GENOTOX_IDs are provided.
Genotoxicity studies are critical for assessing cancer risk and mutagenic potential.
<dictionary_descriptions>
<name>STUDY_CATEGORY</name>
<description>Mutagenicity or genotoxicity study</description>
<name>SPECIES</name>
<description>Description of the organism/cell culture tested</description>
<name>SEX</name>
<description>Sex of the tested animals in vivo genotoxicity study</description>
<name>ROUTE</name>
<description>Description of the route of administration</description>
<name>NUMBER_INDIVIDUALS</name>
<description>Number of organisms dosed at each dose level of the in vivo genotoxicty study</description>
<name>CONTROL</name>
<description>Indicates whether and what type of concurrent control groups were used in in vivo genotoxicity study</description>
<name>IS_GENOTOXIC</name>
<description>Positive or negative result</description>
<name>REMARKS</name>
<description>Remarks on genotoxicity study</description>
</dictionary_descriptions>Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| genotox_id | Yes |
Implementation Reference
- The handler function for the 'get_genotox_details' tool. It takes a genotox_id (int or list[int]), queries the database using query_by_id, and returns the results as JSON. Includes comprehensive docstring describing inputs, outputs, and data fields.
def get_genotox_details(genotox_id: Union[int, list[int]]): """ Get genotoxicity study details from GENOTOX table by GENOTOX_ID. Retrieves detailed genotoxicity study records including test methods, guidelines, and results. This tool provides the experimental data used to assess whether substances have genotoxic or mutagenic properties that could cause DNA damage. Args: genotox_id: Single GENOTOX_ID (int) or list of GENOTOX_IDs (list[int]) to query. Use search_substance tool first to find GENOTOX_IDs through the STUDY table. Returns: JSON string containing a DataFrame with genotoxicity study records. Each record includes study category, test guidelines, species, exposure conditions, and genotoxicity results. The returned data includes: - Study category: STUDY_CATEGORY - Test guidelines: GENOTOXGUIDELINE, GENOTOXGUIDELINEFULLTXT - Test conditions: SPECIES, STRAIN, SEX, ROUTE, EXP_PERIOD, EXPPERIODUNIT - Genotoxicity result: IS_GENOTOXIC - Study quality: GLP_COMPL, DEVIATION - Study details: NUMBER_INDIVIDUALS, CONTROL, MET_INDICATOR, REMARKS Note: Multiple records may be returned if multiple GENOTOX_IDs are provided. Genotoxicity studies are critical for assessing cancer risk and mutagenic potential. <dictionary_descriptions> <name>STUDY_CATEGORY</name> <description>Mutagenicity or genotoxicity study</description> <name>SPECIES</name> <description>Description of the organism/cell culture tested</description> <name>SEX</name> <description>Sex of the tested animals in vivo genotoxicity study</description> <name>ROUTE</name> <description>Description of the route of administration</description> <name>NUMBER_INDIVIDUALS</name> <description>Number of organisms dosed at each dose level of the in vivo genotoxicty study</description> <name>CONTROL</name> <description>Indicates whether and what type of concurrent control groups were used in in vivo genotoxicity study</description> <name>IS_GENOTOXIC</name> <description>Positive or negative result</description> <name>REMARKS</name> <description>Remarks on genotoxicity study</description> </dictionary_descriptions> """ df = query_by_id(genotox_id, "genotox") return df.to_json() - main.py:21-21 (registration)Registration of the get_genotox_details tool with the FastMCP server.
mcp.add_tool(get_genotox_details) - main.py:5-5 (registration)Import of the get_genotox_details tool function in main.py for registration.
from src.mcp_openfoodtox.tools.get_genotox_details import get_genotox_details