get_assessment_result_details
Retrieve detailed information about a specific assessment result, including status, drift detection, and links to JSON output and logs, via the Terraform Cloud MCP server.
Instructions
Get details for a specific assessment result.
Retrieves comprehensive information about an assessment result including its current status, whether drift was detected, and links to related resources like JSON output and logs.
API endpoint: GET /api/v2/assessment-results/{assessment_result_id}
Args: assessment_result_id: The ID of the assessment result to retrieve details for (format: "asmtres-xxxxxxxx")
Returns: Assessment result details including status, timestamps, and drift detection information
See: docs/tools/assessment_results.md for reference documentation
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| assessment_result_id | Yes |
Implementation Reference
- The main asynchronous handler function that validates the input assessment_result_id using AssessmentResultRequest and makes an API request to retrieve the assessment result details.@handle_api_errors async def get_assessment_result_details(assessment_result_id: str) -> APIResponse: """Get details for a specific assessment result. Retrieves comprehensive information about an assessment result including its current status, whether drift was detected, and links to related resources like JSON output and logs. API endpoint: GET /api/v2/assessment-results/{assessment_result_id} Args: assessment_result_id: The ID of the assessment result to retrieve details for (format: "asmtres-xxxxxxxx") Returns: Assessment result details including status, timestamps, and drift detection information See: docs/tools/assessment_results.md for reference documentation """ # Validate parameters params = AssessmentResultRequest(assessment_result_id=assessment_result_id) # Make API request return await api_request(f"assessment-results/{params.assessment_result_id}")
- terraform_cloud_mcp/server.py:107-107 (registration)The registration of the 'get_assessment_result_details' tool in the MCP server using the mcp.tool() decorator.mcp.tool()(assessment_results.get_assessment_result_details)