terraform-cloud-mcp

Instructions

Implementation Reference

• terraform_cloud_mcp/tools/state_versions.py:81-104 (handler)

  The handler function that retrieves the current state version for a given workspace ID using the Terraform Cloud API endpoint GET /workspaces/:workspace_id/current-state-version. It validates input with CurrentStateVersionRequest model and uses api_request utility.

  @handle_api_errors
  async def get_current_state_version(workspace_id: str) -> APIResponse:
      """Get the current state version for a workspace.
  
      Retrieves the current state version for a workspace, which is the input
      state when running terraform operations.
  
      API endpoint: GET /workspaces/:workspace_id/current-state-version
  
      Args:
          workspace_id: The ID of the workspace (format: "ws-xxxxxxxx")
  
      Returns:
          The current state version including details and download URLs
  
      See:
          docs/tools/state_versions.md for reference documentation
      """
      # Validate parameters
      params = CurrentStateVersionRequest(workspace_id=workspace_id)
  
      # Make API request
      return await api_request(f"workspaces/{params.workspace_id}/current-state-version")

• terraform_cloud_mcp/models/state_versions.py:93-109 (schema)

  Pydantic model for input validation of the workspace_id parameter, ensuring it matches the ws-xxxxxxxx pattern.

  class CurrentStateVersionRequest(APIRequest):
      """Request model for retrieving a workspace's current state version.
  
      Used to validate the workspace ID parameter for current state version API requests.
  
      Reference: https://developer.hashicorp.com/terraform/cloud-docs/api-docs/state-versions#get-current-state-version
  
      See:
          docs/models/state_versions.md for reference
      """
  
      workspace_id: str = Field(
          ...,
          description="The ID of the workspace to retrieve the current state version for",
          pattern=r"^ws-[a-zA-Z0-9]{16}$",  # Standard workspace ID pattern
      )

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

  Tool registration using FastMCP's mcp.tool() decorator, importing from tools.state_versions.

  mcp.tool()(state_versions.get_current_state_version)