Update tooling information

Author: egorpavlikhin

README.md

@@ -131,295 +131,43 @@ npx "your/folders/full/path" -y @octopusdeploy/mcp-server
 
 ## 🔨 Tools
 
-<details>
-<summary>list_spaces</summary>
-
-**Description**: List all spaces in the Octopus Deploy instance
-
-**Parameters**: None
-
-</details>
-
-<details>
-<summary>list_projects</summary>
-
-**Description**: List projects in a space
-  
-  This tool lists all projects in a given space. The space name is required; if you can't find the space name, ask the user directly for the name of the space. Optionally filter by partial name match using partialName parameter.
-
-**Parameters**: 
-- `spaceName` (string, required): The space name
-- `partialName` (string, optional): Filter by partial name match
-
-</details>
-
-<details>
-<summary>list_environments</summary>
-
-**Description**: List environments in a space
-  
-  This tool lists all environments in a given space. The space name is required. Optionally filter by partial name match using partialName parameter.
-
-**Parameters**: 
-- `spaceName` (string, required): The space name
-- `partialName` (string, optional): Filter by partial name match
-
-</details>
-
-<details>
-<summary>list_deployments</summary>
-
-**Description**: List deployments in a space
-  
-  This tool lists deployments in a given space. The space name is required. Optional filters include: projects (array of project IDs), environments (array of environment IDs), tenants (array of tenant IDs), channels (array of channel IDs), taskState (one of: Canceled, Cancelling, Executing, Failed, Queued, Success, TimedOut), and take (number of results to return).
-
-**Parameters**: 
-- `spaceName` (string, required): The space name
-- `projects` (array of strings, optional): Array of project IDs to filter by
-- `environments` (array of strings, optional): Array of environment IDs to filter by
-- `tenants` (array of strings, optional): Array of tenant IDs to filter by
-- `channels` (array of strings, optional): Array of channel IDs to filter by
-- `taskState` (string, optional): One of: Canceled, Cancelling, Executing, Failed, Queued, Success, TimedOut
-- `take` (number, optional): Number of results to return
-
-</details>
-
-<details>
-<summary>get_release_by_id</summary>
-
-**Description**: Get details for a specific release by its ID
-
-**Parameters**: 
-- `spaceName` (string, required): The space name
-- `releaseId` (string, required): The ID of the release to retrieve
-
-</details>
-
-<details>
-<summary>list_releases</summary>
-
-**Description**: List releases in a space
-  
-  This tool lists all releases in a given space. The space name is required. Optionally provide skip and take parameters for pagination.
-
-**Parameters**: 
-- `spaceName` (string, required): The space name
-- `skip` (number, optional): Number of items to skip for pagination
-- `take` (number, optional): Number of items to take for pagination
-
-</details>
-
-<details>
-<summary>list_releases_for_project</summary>
-
-**Description**: List releases for a specific project
-  
-  This tool lists all releases for a given project in a space. The space name and project ID are required. Optionally provide skip, take, and searchByVersion parameters.
-
-**Parameters**: 
-- `spaceName` (string, required): The space name
-- `projectId` (string, required): The ID of the project to list releases for
-- `skip` (number, optional): Number of items to skip for pagination
-- `take` (number, optional): Number of items to take for pagination
-- `searchByVersion` (string, optional): Search releases by version string
-
-</details>
-
-<details>
-<summary>get_task_by_id</summary>
-
-**Description**: Get details for a specific server task by its ID
-
-**Parameters**: 
-- `spaceName` (string, required): The space name
-- `taskId` (string, required): The ID of the task to retrieve
-
-</details>
-
-<details>
-<summary>get_task_details</summary>
-
-**Description**: Get detailed information for a specific server task by its ID
-
-**Parameters**: 
-- `spaceName` (string, required): The space name
-- `taskId` (string, required): The ID of the task to retrieve
-
-</details>
-
-<details>
-<summary>get_task_raw</summary>
-
-**Description**: Get raw details for a specific server task by its ID
-
-**Parameters**: 
-- `spaceName` (string, required): The space name
-- `taskId` (string, required): The ID of the task to retrieve
-
-</details>
-
-<details>
-<summary>list_deployment_targets</summary>
-
-**Description**: List deployment targets (machines) in a space
-
-This tool lists all deployment targets in a given space. The space name is required. You can optionally filter by various parameters like name, roles, health status, etc.
-
-**Parameters**: 
-- `spaceName` (string, required): The space name
-- `skip` (number, optional): Number of items to skip for pagination
-- `take` (number, optional): Number of items to take for pagination
-- `name` (string, optional): Filter by exact name match
-- `ids` (array of strings, optional): Array of deployment target IDs to filter by
-- `partialName` (string, optional): Filter by partial name match
-- `roles` (array of strings, optional): Array of roles to filter by
-- `isDisabled` (boolean, optional): Filter by disabled status
-- `healthStatuses` (array of strings, optional): Array of health statuses to filter by
-- `commStyles` (array of strings, optional): Array of communication styles to filter by
-- `tenantIds` (array of strings, optional): Array of tenant IDs to filter by
-- `tenantTags` (array of strings, optional): Array of tenant tags to filter by
-- `environmentIds` (array of strings, optional): Array of environment IDs to filter by
-- `thumbprint` (string, optional): Filter by certificate thumbprint
-- `deploymentId` (string, optional): Filter by deployment ID
-- `shellNames` (array of strings, optional): Array of shell names to filter by
-- `deploymentTargetTypes` (array of strings, optional): Array of deployment target types to filter by
-
-</details>
-
-<details>
-<summary>get_deployment_target</summary>
-
-**Description**: Get a specific deployment target (machine) by ID
-
-This tool retrieves detailed information about a specific deployment target using its ID. The space name and target ID are both required.
-
-**Parameters**: 
-- `spaceName` (string, required): The space name
-- `targetId` (string, required): The ID of the deployment target to retrieve
-
-</details>
-
-<details>
-<summary>get_deployment_process</summary>
-
-**Description**: Get deployment process by ID
-
-This tool retrieves a deployment process by its ID. Each project has a deployment process attached, and releases/deployments can also have frozen processes attached.
-
-**Parameters**: 
-- `spaceName` (string, required): The space name
-- `projectId` (string, optional): The ID of the project to retrieve the deployment process for. If processId is not provided, this parameter is required.
-- `processId` (string, optional): The ID of the deployment process to retrieve. If not provided, the deployment process for the project will be retrieved.
-- `branchName` (string, optional): Optional branch name to get the deployment process for a specific branch (if using version controlled projects). Try `main` or `master` if unsure.
-- `includeDetails` (boolean, optional): Include detailed properties for steps and actions. Defaults to false.
-
-</details>
-
-<details>
-<summary>get_branches</summary>
-
-**Description**: Get Git branches for a version-controlled project
-
-This tool retrieves Git branches for a specific project in a space. The space name and project ID are required. Optionally provide searchByName, skip, and take parameters for filtering and pagination.
-
-**Parameters**: 
-- `spaceName` (string, required): The space name
-- `projectId` (string, required): The ID of the project
-- `searchByName` (string, optional): Filter branches by partial name match
-- `skip` (number, optional): Number of items to skip for pagination
-- `take` (number, optional): Number of items to take for pagination
-
-</details>
-
-<details>
-<summary>list_tenants</summary>
-
-**Description**: List tenants in a space
-  
-  This tool lists all tenants in a given space. The space name is required. Optionally provide skip and take parameters for pagination.
-
-**Parameters**: 
-- `spaceName` (string, required): The space name
-- `skip` (number, optional): Number of items to skip for pagination
-- `take` (number, optional): Number of items to take for pagination
-- `ids` (array of strings, optional): Filter by specific tenant IDs
-- `partialName` (string, optional): Filter by partial tenant name match
-- `projectId` (string, optional): Filter by specific project ID
-- `tags` (string, optional): Filter by tenant tags (comma-separated list)
-
-</details>
-
-<details>
-<summary>get_tenant_by_id</summary>
-
-**Description**: Get details for a specific tenant by its ID
-
-**Parameters**: 
-- `spaceName` (string, required): The space name
-- `tenantId` (string, required): The ID of the tenant to retrieve
-
-</details>
-
-<details>
-<summary>get_tenant_variables</summary>
-
-**Description**: Get tenant variables by type
-  
-  This tool retrieves different types of tenant variables. Use variableType parameter to specify which type:
-  - "all": Get all tenant variables
-  - "common": Get common variables only
-  - "project": Get project-specific variables only
-
-**Parameters**: 
-- `spaceName` (string, required): The space name
-- `tenantId` (string, required): The ID of the tenant to retrieve variables for
-- `variableType` (string, required): Type of variables to retrieve (all, common, project)
-- `includeMissingVariables` (boolean, optional): Include missing variables in the response (for common/project types)
-
-</details>
-
-<details>
-<summary>get_missing_tenant_variables</summary>
-
-**Description**: Get missing tenant variables
-  
-  This tool retrieves tenant variables that are missing values. Optionally filter by tenant, project, or environment.
-
-**Parameters**: 
-- `spaceName` (string, required): The space name
-- `tenantId` (string, optional): Filter by specific tenant ID
-- `projectId` (string, optional): Filter by specific project ID
-- `environmentId` (string, optional): Filter by specific environment ID
-- `includeDetails` (boolean, optional): Include detailed information about missing variables
-
-</details>
-
-<details>
-<summary>get_kubernetes_live_status</summary>
-
-**Description**: Get Kubernetes live status for a project and environment
-  
-  This tool retrieves the live status of Kubernetes resources for a specific project and environment. Optionally include a tenant ID for multi-tenant deployments.
-
-**Parameters**: 
-- `spaceName` (string, required): The space name
-- `projectId` (string, required): The ID of the project
-- `environmentId` (string, required): The ID of the environment
-- `tenantId` (string, optional): The ID of the tenant (for multi-tenant deployments)
-- `summaryOnly` (boolean, optional): Return summary information only
-
-</details>
-
-<details>
-<summary>get_current_user</summary>
-
-**Description**: Get information about the current authenticated user
-
-This tool retrieves information about the currently authenticated user from the Octopus Deploy API.
-
-**Parameters**: None
-
-</details>
+### Core Tools
+- `list_spaces`: List all spaces in the Octopus Deploy instance
+- `list_environments`: List all environments in a given space
+
+### Projects
+- `list_projects`: List all projects in a given space
+
+### Deployments
+- `list_deployments`: List deployments in a space with optional filtering
+
+### Releases
+- `get_release_by_id`: Get details for a specific release by its ID
+- `list_releases`: List all releases in a given space
+- `list_releases_for_project`: List all releases for a specific project
+
+### Tasks
+- `get_task_by_id`: Get details for a specific server task by its ID
+- `get_task_details`: Get detailed information for a specific server task
+- `get_task_raw`: Get raw details for a specific server task
+
+### Tenants
+- `list_tenants`: List all tenants in a given space
+- `get_tenant_by_id`: Get details for a specific tenant by its ID
+- `get_tenant_variables`: Get tenant variables by type (all, common, or project)
+- `get_missing_tenant_variables`: Get tenant variables that are missing values
+
+### Kubernetes
+- `get_kubernetes_live_status`: Get live status of Kubernetes resources for a project and environment (only supported in Octopus Server starting with version `2025.3`)
+
+### Machines (Deployment Targets)
+- `list_deployment_targets`: List all deployment targets in a space with optional filtering
+- `get_deployment_target`: Get detailed information about a specific deployment target
+
+### Additional Tools
+- `get_deployment_process`: Get deployment process by ID for projects or releases
+- `get_branches`: Get Git branches for a version-controlled project
+- `get_current_user`: Get information about the current authenticated user
 
 ## Security Considerations