Terraform

Terraform Cloud MCP Server for Cloudflare Workers

Available Tools

88 tools available in the Terraform MCP server. Each tool can be called by AI assistants to perform specific actions.

terraform_force_execute_run

Force execute a run, cancelling all prior runs and unlocking the workspace.

Args:

runId: Run ID (required)

Returns: Confirmation of force execute action.

{
  "type": "object",
  "required": [
    "runId"
  ],
  "properties": {
    "runId": {
      "type": "string",
      "description": "Run ID"
    }
  }
}

terraform_remove_policies_from_set

Remove policies from a policy set.

Args:

policySetId: Policy set ID (required)
policyIds: Array of policy IDs (required)

Returns: Confirmation.

{
  "type": "object",
  "required": [
    "policySetId",
    "policyIds"
  ],
  "properties": {
    "policyIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Policy IDs to remove"
    },
    "policySetId": {
      "type": "string",
      "description": "Policy set ID"
    }
  }
}

terraform_get_policy

Get details of a specific policy.

Args:

policyId: Policy ID (required)
format: Response format ('json' or 'markdown')

Returns: Policy details including enforcement level and kind.

{
  "type": "object",
  "required": [
    "policyId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "policyId": {
      "type": "string",
      "description": "Policy ID"
    }
  }
}

terraform_delete_team

Delete a team.

Args:

teamId: Team ID (required)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "teamId"
  ],
  "properties": {
    "teamId": {
      "type": "string",
      "description": "Team ID"
    }
  }
}

terraform_list_agent_pools

List agent pools in an organization.

Args:

organization: Organization name (required)
pageNumber: Page number for pagination
pageSize: Number of items per page
format: Response format ('json' or 'markdown')

Returns: Paginated list of agent pools.

{
  "type": "object",
  "required": [
    "organization"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "pageSize": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Items per page"
    },
    "pageNumber": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number"
    },
    "organization": {
      "type": "string",
      "description": "Organization name"
    }
  }
}

terraform_get_agent_pool

Get details of an agent pool.

Args:

agentPoolId: Agent pool ID (required)
format: Response format ('json' or 'markdown')

Returns: Agent pool details.

{
  "type": "object",
  "required": [
    "agentPoolId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "agentPoolId": {
      "type": "string",
      "description": "Agent pool ID"
    }
  }
}

terraform_create_agent_pool

Create a new agent pool.

Args:

organization: Organization name (required)
name: Agent pool name (required)
organizationScoped: Available to entire organization

Returns: The created agent pool.

{
  "type": "object",
  "required": [
    "organization",
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Agent pool name"
    },
    "organization": {
      "type": "string",
      "description": "Organization name"
    },
    "organizationScoped": {
      "type": "boolean",
      "default": false,
      "description": "Organization scoped"
    }
  }
}

terraform_update_agent_pool

Update an agent pool.

Args:

agentPoolId: Agent pool ID (required)
name: New name
organizationScoped: Organization scoped

Returns: The updated agent pool.

{
  "type": "object",
  "required": [
    "agentPoolId"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "New name"
    },
    "agentPoolId": {
      "type": "string",
      "description": "Agent pool ID"
    },
    "organizationScoped": {
      "type": "boolean",
      "description": "Organization scoped"
    }
  }
}

terraform_delete_agent_pool

Delete an agent pool.

Args:

agentPoolId: Agent pool ID (required)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "agentPoolId"
  ],
  "properties": {
    "agentPoolId": {
      "type": "string",
      "description": "Agent pool ID"
    }
  }
}

terraform_list_agents

List agents in an agent pool.

Args:

agentPoolId: Agent pool ID (required)
format: Response format ('json' or 'markdown')

Returns: List of agents with status.

{
  "type": "object",
  "required": [
    "agentPoolId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "agentPoolId": {
      "type": "string",
      "description": "Agent pool ID"
    }
  }
}

terraform_get_agent

Get details of a specific agent.

Args:

agentId: Agent ID (required)
format: Response format ('json' or 'markdown')

Returns: Agent details including status.

{
  "type": "object",
  "required": [
    "agentId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "agentId": {
      "type": "string",
      "description": "Agent ID"
    }
  }
}

terraform_delete_agent

Delete an agent.

Args:

agentId: Agent ID (required)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "agentId"
  ],
  "properties": {
    "agentId": {
      "type": "string",
      "description": "Agent ID"
    }
  }
}

terraform_list_run_tasks

List run tasks in an organization.

Args:

organization: Organization name (required)
pageNumber: Page number for pagination
pageSize: Number of items per page
format: Response format ('json' or 'markdown')

Returns: Paginated list of run tasks.

{
  "type": "object",
  "required": [
    "organization"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "pageSize": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Items per page"
    },
    "pageNumber": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number"
    },
    "organization": {
      "type": "string",
      "description": "Organization name"
    }
  }
}

terraform_get_run_task

Get details of a run task.

Args:

taskId: Run task ID (required)
format: Response format ('json' or 'markdown')

Returns: Run task details.

{
  "type": "object",
  "required": [
    "taskId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "taskId": {
      "type": "string",
      "description": "Run task ID"
    }
  }
}

terraform_create_run_task

Create a new run task.

Args:

organization: Organization name (required)
name: Run task name (required)
url: Callback URL (required)
description: Description
enabled: Enable the task
hmacKey: HMAC key for verification

Returns: The created run task.

{
  "type": "object",
  "required": [
    "organization",
    "name",
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "Callback URL"
    },
    "name": {
      "type": "string",
      "description": "Run task name"
    },
    "enabled": {
      "type": "boolean",
      "default": true,
      "description": "Enable task"
    },
    "hmacKey": {
      "type": "string",
      "description": "HMAC key"
    },
    "description": {
      "type": "string",
      "description": "Description"
    },
    "organization": {
      "type": "string",
      "description": "Organization name"
    }
  }
}

terraform_update_run_task

Update a run task.

Args:

taskId: Run task ID (required)
name: New name
url: New callback URL
description: New description
enabled: Enable/disable

Returns: The updated run task.

{
  "type": "object",
  "required": [
    "taskId"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "New callback URL"
    },
    "name": {
      "type": "string",
      "description": "New name"
    },
    "taskId": {
      "type": "string",
      "description": "Run task ID"
    },
    "enabled": {
      "type": "boolean",
      "description": "Enable/disable"
    },
    "description": {
      "type": "string",
      "description": "New description"
    }
  }
}

terraform_delete_run_task

Delete a run task.

Args:

taskId: Run task ID (required)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "taskId"
  ],
  "properties": {
    "taskId": {
      "type": "string",
      "description": "Run task ID"
    }
  }
}

terraform_list_workspace_run_tasks

List run tasks attached to a workspace.

Args:

workspaceId: Workspace ID (required)
format: Response format ('json' or 'markdown')

Returns: List of workspace run tasks.

{
  "type": "object",
  "required": [
    "workspaceId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "workspaceId": {
      "type": "string",
      "description": "Workspace ID"
    }
  }
}

terraform_list_registry_modules

List private registry modules in an organization.

Args:

organization: Organization name (required)
pageNumber: Page number for pagination
pageSize: Number of items per page
format: Response format ('json' or 'markdown')

Returns: Paginated list of registry modules.

{
  "type": "object",
  "required": [
    "organization"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "pageSize": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Items per page"
    },
    "pageNumber": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number"
    },
    "organization": {
      "type": "string",
      "description": "Organization name"
    }
  }
}

terraform_attach_run_task

Attach a run task to a workspace.

Args:

workspaceId: Workspace ID (required)
taskId: Run task ID (required)
stage: 'pre_plan', 'post_plan', 'pre_apply', or 'post_apply' (required)
enforcementLevel: 'advisory' or 'mandatory' (required)

Returns: The workspace run task.

{
  "type": "object",
  "required": [
    "workspaceId",
    "taskId",
    "stage",
    "enforcementLevel"
  ],
  "properties": {
    "stage": {
      "enum": [
        "pre_plan",
        "post_plan",
        "pre_apply",
        "post_apply"
      ],
      "type": "string",
      "description": "Stage"
    },
    "taskId": {
      "type": "string",
      "description": "Run task ID"
    },
    "workspaceId": {
      "type": "string",
      "description": "Workspace ID"
    },
    "enforcementLevel": {
      "enum": [
        "advisory",
        "mandatory"
      ],
      "type": "string",
      "description": "Enforcement level"
    }
  }
}

terraform_detach_run_task

Detach a run task from a workspace.

Args:

workspaceId: Workspace ID (required)
taskId: Workspace run task ID (required)

Returns: Confirmation.

{
  "type": "object",
  "required": [
    "workspaceId",
    "taskId"
  ],
  "properties": {
    "taskId": {
      "type": "string",
      "description": "Workspace run task ID"
    },
    "workspaceId": {
      "type": "string",
      "description": "Workspace ID"
    }
  }
}

terraform_list_organizations

List organizations the authenticated user has access to.

Args:

pageNumber: Page number for pagination
pageSize: Number of items per page
format: Response format ('json' or 'markdown')

Returns: Paginated list of organizations.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "pageSize": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Items per page"
    },
    "pageNumber": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number"
    }
  }
}

terraform_get_organization

Get details of a specific organization.

Args:

name: Organization name (required)
format: Response format ('json' or 'markdown')

Returns: Organization details including settings and permissions.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Organization name"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

terraform_create_organization

Create a new organization.

Args:

name: Organization name (required)
email: Admin email (required)

Returns: The created organization details.

{
  "type": "object",
  "required": [
    "name",
    "email"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Organization name"
    },
    "email": {
      "type": "string",
      "description": "Admin email"
    }
  }
}

terraform_update_organization

Update an organization.

Args:

name: Organization name (required)
email: New admin email
collaboratorAuthPolicy: 'password' or 'two_factor_mandatory'
costEstimationEnabled: Enable cost estimation
sessionTimeout: Session timeout in minutes
sessionRemember: Session remember in minutes

Returns: The updated organization details.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Organization name"
    },
    "email": {
      "type": "string",
      "description": "New admin email"
    },
    "sessionTimeout": {
      "type": "number",
      "description": "Session timeout (minutes)"
    },
    "sessionRemember": {
      "type": "number",
      "description": "Session remember (minutes)"
    },
    "costEstimationEnabled": {
      "type": "boolean",
      "description": "Enable cost estimation"
    },
    "collaboratorAuthPolicy": {
      "enum": [
        "password",
        "two_factor_mandatory"
      ],
      "type": "string",
      "description": "Auth policy"
    }
  }
}

terraform_delete_organization

Delete an organization.

Args:

name: Organization name (required)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Organization name"
    }
  }
}

terraform_get_entitlements

Get organization entitlements/features.

Args:

organization: Organization name (required)

Returns: List of enabled features and entitlements.

{
  "type": "object",
  "required": [
    "organization"
  ],
  "properties": {
    "organization": {
      "type": "string",
      "description": "Organization name"
    }
  }
}

terraform_list_projects

List projects in an organization.

Args:

organization: Organization name (required)
pageNumber: Page number for pagination
pageSize: Number of items per page
format: Response format ('json' or 'markdown')

Returns: Paginated list of projects.

{
  "type": "object",
  "required": [
    "organization"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "pageSize": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Items per page"
    },
    "pageNumber": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number"
    },
    "organization": {
      "type": "string",
      "description": "Organization name"
    }
  }
}

terraform_get_project

Get details of a specific project.

Args:

projectId: Project ID (required)
format: Response format ('json' or 'markdown')

Returns: Project details.

{
  "type": "object",
  "required": [
    "projectId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "projectId": {
      "type": "string",
      "description": "Project ID"
    }
  }
}

terraform_create_project

Create a new project in an organization.

Args:

organization: Organization name (required)
name: Project name (required)
description: Project description

Returns: The created project details.

{
  "type": "object",
  "required": [
    "organization",
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Project name"
    },
    "description": {
      "type": "string",
      "description": "Project description"
    },
    "organization": {
      "type": "string",
      "description": "Organization name"
    }
  }
}

terraform_update_project

Update a project.

Args:

projectId: Project ID (required)
name: New project name
description: New description

Returns: The updated project details.

{
  "type": "object",
  "required": [
    "projectId"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "New project name"
    },
    "projectId": {
      "type": "string",
      "description": "Project ID"
    },
    "description": {
      "type": "string",
      "description": "New description"
    }
  }
}

terraform_delete_project

Delete a project.

Args:

projectId: Project ID (required)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "projectId"
  ],
  "properties": {
    "projectId": {
      "type": "string",
      "description": "Project ID"
    }
  }
}

terraform_list_policies

List policies in an organization.

Args:

organization: Organization name (required)
pageNumber: Page number for pagination
pageSize: Number of items per page
format: Response format ('json' or 'markdown')

Returns: Paginated list of policies.

{
  "type": "object",
  "required": [
    "organization"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "pageSize": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Items per page"
    },
    "pageNumber": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number"
    },
    "organization": {
      "type": "string",
      "description": "Organization name"
    }
  }
}

terraform_create_policy

Create a new policy.

Args:

organization: Organization name (required)
name: Policy name (required)
description: Policy description
kind: 'sentinel' or 'opa'
enforcementLevel: 'hard-mandatory', 'soft-mandatory', 'advisory', or 'mandatory'
query: OPA query (for OPA policies)

Returns: The created policy details.

{
  "type": "object",
  "required": [
    "organization",
    "name"
  ],
  "properties": {
    "kind": {
      "enum": [
        "sentinel",
        "opa"
      ],
      "type": "string",
      "description": "Policy kind"
    },
    "name": {
      "type": "string",
      "description": "Policy name"
    },
    "query": {
      "type": "string",
      "description": "OPA query"
    },
    "description": {
      "type": "string",
      "description": "Policy description"
    },
    "organization": {
      "type": "string",
      "description": "Organization name"
    },
    "enforcementLevel": {
      "enum": [
        "hard-mandatory",
        "soft-mandatory",
        "advisory",
        "mandatory"
      ],
      "type": "string",
      "description": "Enforcement level"
    }
  }
}

terraform_upload_policy_code

Upload policy code (Sentinel or OPA).

Args:

policyId: Policy ID (required)
code: Policy code (required)

Returns: Confirmation of upload.

{
  "type": "object",
  "required": [
    "policyId",
    "code"
  ],
  "properties": {
    "code": {
      "type": "string",
      "description": "Policy code"
    },
    "policyId": {
      "type": "string",
      "description": "Policy ID"
    }
  }
}

terraform_update_policy

Update a policy.

Args:

policyId: Policy ID (required)
description: New description
enforcementLevel: 'hard-mandatory', 'soft-mandatory', 'advisory', or 'mandatory'
query: OPA query

Returns: The updated policy details.

{
  "type": "object",
  "required": [
    "policyId"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "OPA query"
    },
    "policyId": {
      "type": "string",
      "description": "Policy ID"
    },
    "description": {
      "type": "string",
      "description": "New description"
    },
    "enforcementLevel": {
      "enum": [
        "hard-mandatory",
        "soft-mandatory",
        "advisory",
        "mandatory"
      ],
      "type": "string",
      "description": "Enforcement level"
    }
  }
}

terraform_delete_policy

Delete a policy.

Args:

policyId: Policy ID (required)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "policyId"
  ],
  "properties": {
    "policyId": {
      "type": "string",
      "description": "Policy ID"
    }
  }
}

terraform_list_policy_sets

List policy sets in an organization.

Args:

organization: Organization name (required)
pageNumber: Page number for pagination
pageSize: Number of items per page
format: Response format ('json' or 'markdown')

Returns: Paginated list of policy sets.

{
  "type": "object",
  "required": [
    "organization"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "pageSize": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Items per page"
    },
    "pageNumber": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number"
    },
    "organization": {
      "type": "string",
      "description": "Organization name"
    }
  }
}

terraform_get_policy_set

Get details of a policy set.

Args:

policySetId: Policy set ID (required)
format: Response format ('json' or 'markdown')

Returns: Policy set details.

{
  "type": "object",
  "required": [
    "policySetId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "policySetId": {
      "type": "string",
      "description": "Policy set ID"
    }
  }
}

terraform_create_policy_set

Create a new policy set.

Args:

organization: Organization name (required)
name: Policy set name (required)
description: Description
kind: 'sentinel' or 'opa'
global: Apply to all workspaces
agentEnabled: Enable for agent runs
policiesPath: Path to policies in VCS repo
vcsIdentifier: VCS repository identifier
vcsOauthTokenId: OAuth token ID for VCS

Returns: The created policy set.

{
  "type": "object",
  "required": [
    "organization",
    "name"
  ],
  "properties": {
    "kind": {
      "enum": [
        "sentinel",
        "opa"
      ],
      "type": "string",
      "description": "Policy kind"
    },
    "name": {
      "type": "string",
      "description": "Policy set name"
    },
    "global": {
      "type": "boolean",
      "description": "Apply globally"
    },
    "description": {
      "type": "string",
      "description": "Description"
    },
    "agentEnabled": {
      "type": "boolean",
      "description": "Enable for agent runs"
    },
    "organization": {
      "type": "string",
      "description": "Organization name"
    },
    "policiesPath": {
      "type": "string",
      "description": "Policies path in VCS"
    },
    "vcsIdentifier": {
      "type": "string",
      "description": "VCS repository identifier"
    },
    "vcsOauthTokenId": {
      "type": "string",
      "description": "OAuth token ID"
    }
  }
}

terraform_update_policy_set

Update a policy set.

Args:

policySetId: Policy set ID (required)
name: New name
description: New description
global: Apply globally
agentEnabled: Enable for agent runs
policiesPath: Policies path in VCS

Returns: The updated policy set.

{
  "type": "object",
  "required": [
    "policySetId"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "New name"
    },
    "global": {
      "type": "boolean",
      "description": "Apply globally"
    },
    "description": {
      "type": "string",
      "description": "New description"
    },
    "policySetId": {
      "type": "string",
      "description": "Policy set ID"
    },
    "agentEnabled": {
      "type": "boolean",
      "description": "Enable for agent runs"
    },
    "policiesPath": {
      "type": "string",
      "description": "Policies path"
    }
  }
}

terraform_delete_policy_set

Delete a policy set.

Args:

policySetId: Policy set ID (required)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "policySetId"
  ],
  "properties": {
    "policySetId": {
      "type": "string",
      "description": "Policy set ID"
    }
  }
}

terraform_add_policies_to_set

Add policies to a policy set.

Args:

policySetId: Policy set ID (required)
policyIds: Array of policy IDs (required)

Returns: Confirmation.

{
  "type": "object",
  "required": [
    "policySetId",
    "policyIds"
  ],
  "properties": {
    "policyIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Policy IDs to add"
    },
    "policySetId": {
      "type": "string",
      "description": "Policy set ID"
    }
  }
}

terraform_add_workspaces_to_policy_set

Add workspaces to a policy set.

Args:

policySetId: Policy set ID (required)
workspaceIds: Array of workspace IDs (required)

Returns: Confirmation.

{
  "type": "object",
  "required": [
    "policySetId",
    "workspaceIds"
  ],
  "properties": {
    "policySetId": {
      "type": "string",
      "description": "Policy set ID"
    },
    "workspaceIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Workspace IDs to add"
    }
  }
}

terraform_remove_workspaces_from_policy_set

Remove workspaces from a policy set.

Args:

policySetId: Policy set ID (required)
workspaceIds: Array of workspace IDs (required)

Returns: Confirmation.

{
  "type": "object",
  "required": [
    "policySetId",
    "workspaceIds"
  ],
  "properties": {
    "policySetId": {
      "type": "string",
      "description": "Policy set ID"
    },
    "workspaceIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Workspace IDs to remove"
    }
  }
}

terraform_get_registry_module

Get details of a private registry module.

Args:

organization: Organization name (required)
name: Module name (required)
provider: Provider name (required)
format: Response format ('json' or 'markdown')

Returns: Registry module details.

{
  "type": "object",
  "required": [
    "organization",
    "name",
    "provider"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Module name"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "provider": {
      "type": "string",
      "description": "Provider name"
    },
    "organization": {
      "type": "string",
      "description": "Organization name"
    }
  }
}

terraform_create_registry_module

Create a new registry module (without VCS connection).

Args:

organization: Organization name (required)
name: Module name (required)
provider: Provider name (required)

Returns: The created registry module.

{
  "type": "object",
  "required": [
    "organization",
    "name",
    "provider"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Module name"
    },
    "provider": {
      "type": "string",
      "description": "Provider name"
    },
    "organization": {
      "type": "string",
      "description": "Organization name"
    }
  }
}

terraform_create_registry_module_vcs

Create a registry module from a VCS repository.

Args:

organization: Organization name (required)
vcsIdentifier: VCS repository identifier (required)
oauthTokenId: OAuth token ID (required)
displayIdentifier: Display identifier
tagsRegex: Regex for version tags
publishingMechanism: 'git_tag' or 'branch'
testsEnabled: Enable module tests

Returns: The created registry module.

{
  "type": "object",
  "required": [
    "organization",
    "vcsIdentifier",
    "oauthTokenId"
  ],
  "properties": {
    "tagsRegex": {
      "type": "string",
      "description": "Version tags regex"
    },
    "oauthTokenId": {
      "type": "string",
      "description": "OAuth token ID"
    },
    "organization": {
      "type": "string",
      "description": "Organization name"
    },
    "testsEnabled": {
      "type": "boolean",
      "description": "Enable module tests"
    },
    "vcsIdentifier": {
      "type": "string",
      "description": "VCS repository identifier"
    },
    "displayIdentifier": {
      "type": "string",
      "description": "Display identifier"
    },
    "publishingMechanism": {
      "enum": [
        "git_tag",
        "branch"
      ],
      "type": "string",
      "description": "Publishing mechanism"
    }
  }
}

terraform_delete_registry_module

Delete a registry module (all versions).

Args:

organization: Organization name (required)
name: Module name (required)
provider: Provider name (required)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "organization",
    "name",
    "provider"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Module name"
    },
    "provider": {
      "type": "string",
      "description": "Provider name"
    },
    "organization": {
      "type": "string",
      "description": "Organization name"
    }
  }
}

terraform_delete_registry_module_version

Delete a specific version of a registry module.

Args:

organization: Organization name (required)
name: Module name (required)
provider: Provider name (required)
version: Version to delete (required)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "organization",
    "name",
    "provider",
    "version"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Module name"
    },
    "version": {
      "type": "string",
      "description": "Version to delete"
    },
    "provider": {
      "type": "string",
      "description": "Provider name"
    },
    "organization": {
      "type": "string",
      "description": "Organization name"
    }
  }
}

terraform_list_runs

List runs for a workspace or organization.

Args:

workspaceId: Workspace ID (optional, list runs for specific workspace)
organization: Organization name (optional, list all runs in org)
pageNumber: Page number for pagination
pageSize: Number of items per page
format: Response format ('json' or 'markdown')

Returns: Paginated list of runs with status, message, and timestamps.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "pageSize": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Items per page"
    },
    "pageNumber": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number"
    },
    "workspaceId": {
      "type": "string",
      "description": "Workspace ID"
    },
    "organization": {
      "type": "string",
      "description": "Organization name"
    }
  }
}

terraform_get_run

Get details of a specific run.

Args:

runId: Run ID (required)
format: Response format ('json' or 'markdown')

Returns: Detailed run information including status, plan/apply details, and timestamps.

{
  "type": "object",
  "required": [
    "runId"
  ],
  "properties": {
    "runId": {
      "type": "string",
      "description": "Run ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

terraform_get_team

Get details of a specific team.

Args:

teamId: Team ID (required)
format: Response format ('json' or 'markdown')

Returns: Team details including permissions and organization access.

{
  "type": "object",
  "required": [
    "teamId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "teamId": {
      "type": "string",
      "description": "Team ID"
    }
  }
}

terraform_create_run

Create a new run (plan) for a workspace.

Args:

workspaceId: Workspace ID (required)
message: Run message/description
isDestroy: Create a destroy plan
autoApply: Auto-apply after successful plan
planOnly: Plan only, don't allow apply
refreshOnly: Refresh state only
refresh: Refresh state before plan (default: true)
targetAddrs: Target specific resources (array of resource addresses)
replaceAddrs: Force replacement of resources (array of resource addresses)

Returns: The created run details.

{
  "type": "object",
  "required": [
    "workspaceId"
  ],
  "properties": {
    "message": {
      "type": "string",
      "description": "Run message"
    },
    "refresh": {
      "type": "boolean",
      "description": "Refresh state before plan"
    },
    "planOnly": {
      "type": "boolean",
      "description": "Plan only mode"
    },
    "autoApply": {
      "type": "boolean",
      "description": "Auto-apply after plan"
    },
    "isDestroy": {
      "type": "boolean",
      "description": "Create destroy plan"
    },
    "refreshOnly": {
      "type": "boolean",
      "description": "Refresh only mode"
    },
    "targetAddrs": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Target resource addresses"
    },
    "workspaceId": {
      "type": "string",
      "description": "Workspace ID"
    },
    "replaceAddrs": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Replace resource addresses"
    }
  }
}

terraform_apply_run

Apply a run that is waiting for confirmation.

Args:

runId: Run ID (required)
comment: Comment for the apply action

Returns: Confirmation of apply action.

{
  "type": "object",
  "required": [
    "runId"
  ],
  "properties": {
    "runId": {
      "type": "string",
      "description": "Run ID"
    },
    "comment": {
      "type": "string",
      "description": "Apply comment"
    }
  }
}

terraform_discard_run

Discard a run that is waiting for confirmation.

Args:

runId: Run ID (required)
comment: Comment for the discard action

Returns: Confirmation of discard action.

{
  "type": "object",
  "required": [
    "runId"
  ],
  "properties": {
    "runId": {
      "type": "string",
      "description": "Run ID"
    },
    "comment": {
      "type": "string",
      "description": "Discard comment"
    }
  }
}

terraform_cancel_run

Cancel a run that is currently planning or applying.

Args:

runId: Run ID (required)
comment: Comment for the cancel action
force: Force cancel (immediately terminate)

Returns: Confirmation of cancel action.

{
  "type": "object",
  "required": [
    "runId"
  ],
  "properties": {
    "force": {
      "type": "boolean",
      "default": false,
      "description": "Force cancel"
    },
    "runId": {
      "type": "string",
      "description": "Run ID"
    },
    "comment": {
      "type": "string",
      "description": "Cancel comment"
    }
  }
}

terraform_get_plan

Get details of a specific plan.

Args:

planId: Plan ID (required)
format: Response format ('json' or 'markdown')

Returns: Plan details including resource changes and status.

{
  "type": "object",
  "required": [
    "planId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "planId": {
      "type": "string",
      "description": "Plan ID"
    }
  }
}

terraform_get_plan_json

Get the JSON execution plan output.

Args:

planId: Plan ID (required)

Returns: JSON execution plan with detailed resource changes.

{
  "type": "object",
  "required": [
    "planId"
  ],
  "properties": {
    "planId": {
      "type": "string",
      "description": "Plan ID"
    }
  }
}

terraform_get_current_state

Get the current state version for a workspace.

Args:

workspaceId: Workspace ID (required)
format: Response format ('json' or 'markdown')

Returns: Current state version details including serial, terraform version, and download URLs.

{
  "type": "object",
  "required": [
    "workspaceId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "workspaceId": {
      "type": "string",
      "description": "Workspace ID"
    }
  }
}

terraform_list_state_versions

List state versions for a workspace.

Args:

workspaceId: Workspace ID (required)
pageNumber: Page number for pagination
pageSize: Number of items per page
format: Response format ('json' or 'markdown')

Returns: Paginated list of state versions.

{
  "type": "object",
  "required": [
    "workspaceId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "pageSize": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Items per page"
    },
    "pageNumber": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number"
    },
    "workspaceId": {
      "type": "string",
      "description": "Workspace ID"
    }
  }
}

terraform_get_state_version

Get details of a specific state version.

Args:

stateVersionId: State version ID (required)
format: Response format ('json' or 'markdown')

Returns: State version details.

{
  "type": "object",
  "required": [
    "stateVersionId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "stateVersionId": {
      "type": "string",
      "description": "State version ID"
    }
  }
}

terraform_list_state_outputs

List outputs from a state version.

Args:

stateVersionId: State version ID (required)
format: Response format ('json' or 'markdown')

Returns: List of state outputs with names, types, and values.

{
  "type": "object",
  "required": [
    "stateVersionId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "stateVersionId": {
      "type": "string",
      "description": "State version ID"
    }
  }
}

terraform_rollback_state

Rollback to a previous state version.

Args:

workspaceId: Workspace ID (required)
stateVersionId: State version ID to rollback to (required)

Returns: The new state version created from rollback.

{
  "type": "object",
  "required": [
    "workspaceId",
    "stateVersionId"
  ],
  "properties": {
    "workspaceId": {
      "type": "string",
      "description": "Workspace ID"
    },
    "stateVersionId": {
      "type": "string",
      "description": "State version ID to rollback to"
    }
  }
}

terraform_list_teams

List teams in an organization.

Args:

organization: Organization name (required)
pageNumber: Page number for pagination
pageSize: Number of items per page
format: Response format ('json' or 'markdown')

Returns: Paginated list of teams.

{
  "type": "object",
  "required": [
    "organization"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "pageSize": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Items per page"
    },
    "pageNumber": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number"
    },
    "organization": {
      "type": "string",
      "description": "Organization name"
    }
  }
}

terraform_create_team

Create a new team in an organization.

Args:

organization: Organization name (required)
name: Team name (required)
visibility: 'secret' or 'organization'
managePolicies: Can manage policies
manageWorkspaces: Can manage workspaces
manageVcsSettings: Can manage VCS settings
manageProviders: Can manage providers
manageModules: Can manage modules
manageRunTasks: Can manage run tasks
manageProjects: Can manage projects
readWorkspaces: Can read workspaces
readProjects: Can read projects

Returns: The created team details.

{
  "type": "object",
  "required": [
    "organization",
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Team name"
    },
    "visibility": {
      "enum": [
        "secret",
        "organization"
      ],
      "type": "string",
      "description": "Team visibility"
    },
    "organization": {
      "type": "string",
      "description": "Organization name"
    },
    "readProjects": {
      "type": "boolean",
      "description": "Can read projects"
    },
    "manageModules": {
      "type": "boolean",
      "description": "Can manage modules"
    },
    "managePolicies": {
      "type": "boolean",
      "description": "Can manage policies"
    },
    "manageProjects": {
      "type": "boolean",
      "description": "Can manage projects"
    },
    "manageRunTasks": {
      "type": "boolean",
      "description": "Can manage run tasks"
    },
    "readWorkspaces": {
      "type": "boolean",
      "description": "Can read workspaces"
    },
    "manageProviders": {
      "type": "boolean",
      "description": "Can manage providers"
    },
    "manageWorkspaces": {
      "type": "boolean",
      "description": "Can manage workspaces"
    },
    "manageVcsSettings": {
      "type": "boolean",
      "description": "Can manage VCS settings"
    }
  }
}

terraform_update_team

Update a team.

Args:

teamId: Team ID (required)
name: New team name
visibility: 'secret' or 'organization'
managePolicies: Can manage policies
manageWorkspaces: Can manage workspaces
manageVcsSettings: Can manage VCS settings
manageProviders: Can manage providers
manageModules: Can manage modules
manageRunTasks: Can manage run tasks
manageProjects: Can manage projects
readWorkspaces: Can read workspaces
readProjects: Can read projects

Returns: The updated team details.

{
  "type": "object",
  "required": [
    "teamId"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "New team name"
    },
    "teamId": {
      "type": "string",
      "description": "Team ID"
    },
    "visibility": {
      "enum": [
        "secret",
        "organization"
      ],
      "type": "string",
      "description": "Team visibility"
    },
    "readProjects": {
      "type": "boolean",
      "description": "Can read projects"
    },
    "manageModules": {
      "type": "boolean",
      "description": "Can manage modules"
    },
    "managePolicies": {
      "type": "boolean",
      "description": "Can manage policies"
    },
    "manageProjects": {
      "type": "boolean",
      "description": "Can manage projects"
    },
    "manageRunTasks": {
      "type": "boolean",
      "description": "Can manage run tasks"
    },
    "readWorkspaces": {
      "type": "boolean",
      "description": "Can read workspaces"
    },
    "manageProviders": {
      "type": "boolean",
      "description": "Can manage providers"
    },
    "manageWorkspaces": {
      "type": "boolean",
      "description": "Can manage workspaces"
    },
    "manageVcsSettings": {
      "type": "boolean",
      "description": "Can manage VCS settings"
    }
  }
}

terraform_list_variables

List variables for a workspace.

Args:

workspaceId: Workspace ID (required)
format: Response format ('json' or 'markdown')

Returns: List of variables with key, category, and sensitivity status.

{
  "type": "object",
  "required": [
    "workspaceId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "workspaceId": {
      "type": "string",
      "description": "Workspace ID"
    }
  }
}

terraform_get_variable

Get details of a specific variable.

Args:

workspaceId: Workspace ID (required)
variableId: Variable ID (required)
format: Response format ('json' or 'markdown')

Returns: Variable details including key, value (if not sensitive), and metadata.

{
  "type": "object",
  "required": [
    "workspaceId",
    "variableId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "variableId": {
      "type": "string",
      "description": "Variable ID"
    },
    "workspaceId": {
      "type": "string",
      "description": "Workspace ID"
    }
  }
}

terraform_create_variable

Create a new variable in a workspace.

Args:

workspaceId: Workspace ID (required)
key: Variable key/name (required)
value: Variable value (required)
category: 'terraform' or 'env' (required)
description: Variable description
hcl: Parse value as HCL
sensitive: Mark as sensitive (value hidden after creation)

Returns: The created variable details.

{
  "type": "object",
  "required": [
    "workspaceId",
    "key",
    "value",
    "category"
  ],
  "properties": {
    "hcl": {
      "type": "boolean",
      "default": false,
      "description": "Parse as HCL"
    },
    "key": {
      "type": "string",
      "description": "Variable key"
    },
    "value": {
      "type": "string",
      "description": "Variable value"
    },
    "category": {
      "enum": [
        "terraform",
        "env"
      ],
      "type": "string",
      "description": "Variable category"
    },
    "sensitive": {
      "type": "boolean",
      "default": false,
      "description": "Mark as sensitive"
    },
    "description": {
      "type": "string",
      "description": "Variable description"
    },
    "workspaceId": {
      "type": "string",
      "description": "Workspace ID"
    }
  }
}

terraform_update_variable

Update an existing variable.

Args:

workspaceId: Workspace ID (required)
variableId: Variable ID (required)
key: New variable key
value: New variable value
category: 'terraform' or 'env'
description: New description
hcl: Parse as HCL
sensitive: Mark as sensitive

Returns: The updated variable details.

{
  "type": "object",
  "required": [
    "workspaceId",
    "variableId"
  ],
  "properties": {
    "hcl": {
      "type": "boolean",
      "description": "Parse as HCL"
    },
    "key": {
      "type": "string",
      "description": "New variable key"
    },
    "value": {
      "type": "string",
      "description": "New variable value"
    },
    "category": {
      "enum": [
        "terraform",
        "env"
      ],
      "type": "string",
      "description": "Variable category"
    },
    "sensitive": {
      "type": "boolean",
      "description": "Mark as sensitive"
    },
    "variableId": {
      "type": "string",
      "description": "Variable ID"
    },
    "description": {
      "type": "string",
      "description": "New description"
    },
    "workspaceId": {
      "type": "string",
      "description": "Workspace ID"
    }
  }
}

terraform_delete_variable

Delete a variable from a workspace.

Args:

workspaceId: Workspace ID (required)
variableId: Variable ID (required)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "workspaceId",
    "variableId"
  ],
  "properties": {
    "variableId": {
      "type": "string",
      "description": "Variable ID"
    },
    "workspaceId": {
      "type": "string",
      "description": "Workspace ID"
    }
  }
}

terraform_list_variable_sets

List variable sets for an organization.

Args:

organization: Organization name (required)
pageNumber: Page number for pagination
pageSize: Number of items per page
format: Response format ('json' or 'markdown')

Returns: Paginated list of variable sets.

{
  "type": "object",
  "required": [
    "organization"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "pageSize": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Items per page"
    },
    "pageNumber": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number"
    },
    "organization": {
      "type": "string",
      "description": "Organization name"
    }
  }
}

terraform_get_variable_set

Get details of a variable set.

Args:

varsetId: Variable set ID (required)
format: Response format ('json' or 'markdown')

Returns: Variable set details.

{
  "type": "object",
  "required": [
    "varsetId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "varsetId": {
      "type": "string",
      "description": "Variable set ID"
    }
  }
}

terraform_create_variable_set

Create a new variable set.

Args:

organization: Organization name (required)
name: Variable set name (required)
description: Description
global: Apply to all workspaces
priority: Override workspace variables

Returns: The created variable set.

{
  "type": "object",
  "required": [
    "organization",
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Variable set name"
    },
    "global": {
      "type": "boolean",
      "default": false,
      "description": "Apply globally"
    },
    "priority": {
      "type": "boolean",
      "default": false,
      "description": "Override workspace variables"
    },
    "description": {
      "type": "string",
      "description": "Description"
    },
    "organization": {
      "type": "string",
      "description": "Organization name"
    }
  }
}

terraform_update_variable_set

Update a variable set.

Args:

varsetId: Variable set ID (required)
name: New name
description: New description
global: Apply globally
priority: Override workspace variables

Returns: The updated variable set.

{
  "type": "object",
  "required": [
    "varsetId"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "New name"
    },
    "global": {
      "type": "boolean",
      "description": "Apply globally"
    },
    "priority": {
      "type": "boolean",
      "description": "Override workspace variables"
    },
    "varsetId": {
      "type": "string",
      "description": "Variable set ID"
    },
    "description": {
      "type": "string",
      "description": "New description"
    }
  }
}

terraform_delete_variable_set

Delete a variable set.

Args:

varsetId: Variable set ID (required)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "varsetId"
  ],
  "properties": {
    "varsetId": {
      "type": "string",
      "description": "Variable set ID"
    }
  }
}

terraform_list_variable_set_vars

List variables in a variable set.

Args:

varsetId: Variable set ID (required)
format: Response format ('json' or 'markdown')

Returns: List of variables in the set.

{
  "type": "object",
  "required": [
    "varsetId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "varsetId": {
      "type": "string",
      "description": "Variable set ID"
    }
  }
}

terraform_add_variable_to_set

Add a variable to a variable set.

Args:

varsetId: Variable set ID (required)
key: Variable key (required)
value: Variable value (required)
category: 'terraform' or 'env' (required)
description: Variable description
hcl: Parse as HCL
sensitive: Mark as sensitive

Returns: The created variable.

{
  "type": "object",
  "required": [
    "varsetId",
    "key",
    "value",
    "category"
  ],
  "properties": {
    "hcl": {
      "type": "boolean",
      "default": false,
      "description": "Parse as HCL"
    },
    "key": {
      "type": "string",
      "description": "Variable key"
    },
    "value": {
      "type": "string",
      "description": "Variable value"
    },
    "category": {
      "enum": [
        "terraform",
        "env"
      ],
      "type": "string",
      "description": "Variable category"
    },
    "varsetId": {
      "type": "string",
      "description": "Variable set ID"
    },
    "sensitive": {
      "type": "boolean",
      "default": false,
      "description": "Mark as sensitive"
    },
    "description": {
      "type": "string",
      "description": "Description"
    }
  }
}

terraform_apply_varset_to_workspaces

Apply a variable set to workspaces.

Args:

varsetId: Variable set ID (required)
workspaceIds: Array of workspace IDs (required)

Returns: Confirmation of application.

{
  "type": "object",
  "required": [
    "varsetId",
    "workspaceIds"
  ],
  "properties": {
    "varsetId": {
      "type": "string",
      "description": "Variable set ID"
    },
    "workspaceIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Workspace IDs"
    }
  }
}

terraform_remove_varset_from_workspaces

Remove a variable set from workspaces.

Args:

varsetId: Variable set ID (required)
workspaceIds: Array of workspace IDs (required)

Returns: Confirmation of removal.

{
  "type": "object",
  "required": [
    "varsetId",
    "workspaceIds"
  ],
  "properties": {
    "varsetId": {
      "type": "string",
      "description": "Variable set ID"
    },
    "workspaceIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Workspace IDs"
    }
  }
}

terraform_list_workspaces

List workspaces in a Terraform Cloud organization.

Returns a paginated list of workspaces with their configuration and status.

Args:

organization: Organization name (required)
pageNumber: Page number for pagination (default: 1)
pageSize: Number of items per page (default: 20)
format: Response format ('json' or 'markdown')

Returns: Paginated list of workspaces with ID, name, execution mode, terraform version, and lock status.

{
  "type": "object",
  "required": [
    "organization"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "pageSize": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Items per page"
    },
    "pageNumber": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number"
    },
    "organization": {
      "type": "string",
      "description": "Organization name"
    }
  }
}

terraform_get_workspace

Get details of a specific workspace by ID or by organization and name.

Args:

workspaceId: Workspace ID (optional if organization and name provided)
organization: Organization name (optional if workspaceId provided)
name: Workspace name (optional if workspaceId provided)
format: Response format ('json' or 'markdown')

Returns: Detailed workspace information including settings, VCS configuration, and permissions.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Workspace name"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "workspaceId": {
      "type": "string",
      "description": "Workspace ID"
    },
    "organization": {
      "type": "string",
      "description": "Organization name"
    }
  }
}

terraform_create_workspace

Create a new workspace in a Terraform Cloud organization.

Args:

organization: Organization name (required)
name: Workspace name (required)
description: Workspace description
autoApply: Auto-apply runs after successful plan
executionMode: 'remote', 'local', or 'agent'
terraformVersion: Terraform version to use
workingDirectory: Working directory for Terraform
projectId: Project ID to associate workspace with
vcsIdentifier: VCS repository identifier (e.g., 'owner/repo')
vcsOauthTokenId: OAuth token ID for VCS connection
vcsBranch: VCS branch to use

Returns: The created workspace details.

{
  "type": "object",
  "required": [
    "organization",
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Workspace name"
    },
    "autoApply": {
      "type": "boolean",
      "description": "Auto-apply after plan"
    },
    "projectId": {
      "type": "string",
      "description": "Project ID"
    },
    "vcsBranch": {
      "type": "string",
      "description": "VCS branch"
    },
    "description": {
      "type": "string",
      "description": "Workspace description"
    },
    "organization": {
      "type": "string",
      "description": "Organization name"
    },
    "executionMode": {
      "enum": [
        "remote",
        "local",
        "agent"
      ],
      "type": "string",
      "description": "Execution mode"
    },
    "vcsIdentifier": {
      "type": "string",
      "description": "VCS repository identifier"
    },
    "vcsOauthTokenId": {
      "type": "string",
      "description": "OAuth token ID for VCS"
    },
    "terraformVersion": {
      "type": "string",
      "description": "Terraform version"
    },
    "workingDirectory": {
      "type": "string",
      "description": "Working directory"
    }
  }
}

terraform_update_workspace

Update an existing workspace.

Args:

workspaceId: Workspace ID (required)
name: New workspace name
description: New description
autoApply: Auto-apply after plan
executionMode: 'remote', 'local', or 'agent'
terraformVersion: Terraform version
workingDirectory: Working directory

Returns: The updated workspace details.

{
  "type": "object",
  "required": [
    "workspaceId"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "New workspace name"
    },
    "autoApply": {
      "type": "boolean",
      "description": "Auto-apply after plan"
    },
    "description": {
      "type": "string",
      "description": "New description"
    },
    "workspaceId": {
      "type": "string",
      "description": "Workspace ID"
    },
    "executionMode": {
      "enum": [
        "remote",
        "local",
        "agent"
      ],
      "type": "string",
      "description": "Execution mode"
    },
    "terraformVersion": {
      "type": "string",
      "description": "Terraform version"
    },
    "workingDirectory": {
      "type": "string",
      "description": "Working directory"
    }
  }
}

terraform_delete_workspace

Delete a workspace from Terraform Cloud.

Args:

workspaceId: Workspace ID (required)
safe: Use safe delete (fails if workspace has resources)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "workspaceId"
  ],
  "properties": {
    "safe": {
      "type": "boolean",
      "default": true,
      "description": "Use safe delete"
    },
    "workspaceId": {
      "type": "string",
      "description": "Workspace ID"
    }
  }
}

terraform_lock_workspace

Lock a workspace to prevent runs.

Args:

workspaceId: Workspace ID (required)
reason: Reason for locking

Returns: The locked workspace details.

{
  "type": "object",
  "required": [
    "workspaceId"
  ],
  "properties": {
    "reason": {
      "type": "string",
      "description": "Reason for locking"
    },
    "workspaceId": {
      "type": "string",
      "description": "Workspace ID"
    }
  }
}

terraform_unlock_workspace

Unlock a workspace to allow runs.

Args:

workspaceId: Workspace ID (required)
force: Force unlock (even if locked by another user)

Returns: The unlocked workspace details.

{
  "type": "object",
  "required": [
    "workspaceId"
  ],
  "properties": {
    "force": {
      "type": "boolean",
      "default": false,
      "description": "Force unlock"
    },
    "workspaceId": {
      "type": "string",
      "description": "Workspace ID"
    }
  }
}