terraform-cloud-mcp

Instructions

Implementation Reference

• terraform_cloud_mcp/tools/runs.py:242-262 (handler)

  The main handler function that fetches detailed information about a specific Terraform Cloud run using the API endpoint /runs/{run_id}. It takes a run_id parameter and returns an APIResponse.

  @handle_api_errors
  async def get_run_details(run_id: str) -> APIResponse:
      """Get detailed information about a specific run
  
      Retrieves comprehensive information about a run including its current status,
      plan output, and relationship to other resources. Use to check run progress or results.
  
      API endpoint: GET /runs/{run_id}
  
      Args:
          run_id: The ID of the run to retrieve details for (format: "run-xxxxxxxx")
  
      Returns:
          Complete run details including status, plan, and relationships
  
      See:
          docs/tools/run.md for reference documentation
      """
      # Make API request
      return await api_request(f"runs/{run_id}", method="GET")

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

  The registration of the get_run_details tool in the MCP server using the FastMCP tool decorator.

  mcp.tool()(runs.get_run_details)