terraform-cloud-mcp

Instructions

Implementation Reference

• terraform_cloud_mcp/tools/variables.py:464-483 (handler)

  The main handler function that executes the tool: lists all variables in a Terraform Cloud variable set by making a GET API request to /varsets/{varset_id}/relationships/vars endpoint.

  @handle_api_errors
  async def list_variables_in_variable_set(varset_id: str) -> APIResponse:
      """List all variables in a variable set.
  
      Retrieves all variables that belong to a specific variable set,
      including their configuration and values.
  
      API endpoint: GET /varsets/{varset_id}/relationships/vars
  
      Args:
          varset_id: The ID of the variable set (format: "varset-xxxxxxxx")
  
      Returns:
          List of variables in the variable set with their configuration
  
      See:
          docs/tools/variables.md#list-variables-in-variable-set for reference documentation
      """
      endpoint = f"varsets/{varset_id}/relationships/vars"
      return await api_request(endpoint, method="GET")

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

  Registers the list_variables_in_variable_set tool in the MCP server using FastMCP's mcp.tool() decorator.

  mcp.tool()(variables.list_variables_in_variable_set)