terraform-cloud-mcp

Instructions

Implementation Reference

• terraform_cloud_mcp/tools/state_version_outputs.py:57-80 (handler)

  The main handler function that executes the tool logic: validates input using StateVersionOutputRequest model and calls the Terraform Cloud API to retrieve details for the specified state version output.

  @handle_api_errors
  async def get_state_version_output(state_version_output_id: str) -> APIResponse:
      """Get details for a specific state version output.
  
      Retrieves comprehensive information about a state version output including
      its name, value, type, and sensitivity information.
  
      API endpoint: GET /state-version-outputs/:state_version_output_id
  
      Args:
          state_version_output_id: The ID of the state version output (format: "wsout-xxxxxxxx")
  
      Returns:
          State version output details including name, value, type, and sensitivity information
  
      See:
          docs/tools/state_version_outputs.md for reference documentation
      """
      # Validate parameters
      params = StateVersionOutputRequest(state_version_output_id=state_version_output_id)
  
      # Make API request
      return await api_request(f"state-version-outputs/{params.state_version_output_id}")

• terraform_cloud_mcp/server.py:121-121 (registration)

  Registers the get_state_version_output tool function with the FastMCP server instance.

  mcp.tool()(state_version_outputs.get_state_version_output)