argocd-mcp

Instructions

Update an existing application in ArgoCD

Args:
    name: The application name to update (required)
    project: New project name (optional)
    repo_url: New Git repository URL (optional)
    path: New path within the repository (optional)
    dest_server: New destination K8s API server URL (optional)
    dest_namespace: New destination namespace (optional)
    revision: New Git revision (optional)
    automated_sync: Enable/disable automated sync (optional)
    prune: Enable/disable auto-pruning resources (optional)
    self_heal: Enable/disable self-healing (optional)
    validate: Whether to validate the application

Returns:
    The updated application details

Implementation Reference

• tools/applications.py:180-287 (handler)

  The primary handler function for the 'update_application' tool. It fetches the current application details from ArgoCD, applies the provided optional updates to project, source (repo, path, revision), destination (server, namespace), and sync policy fields, then performs a PUT request to update the application via the API client.

  async def update_application(
      name: str,
      project: Optional[str] = None,
      repo_url: Optional[str] = None,
      path: Optional[str] = None,
      dest_server: Optional[str] = None,
      dest_namespace: Optional[str] = None,
      revision: Optional[str] = None,
      automated_sync: Optional[bool] = None,
      prune: Optional[bool] = None,
      self_heal: Optional[bool] = None,
      validate: bool = True,
  ) -> Dict[str, Any]:
      """
      Update an existing application in ArgoCD
  
      Args:
          name: The application name to update (required)
          project: New project name (optional)
          repo_url: New Git repository URL (optional)
          path: New path within the repository (optional)
          dest_server: New destination K8s API server URL (optional)
          dest_namespace: New destination namespace (optional)
          revision: New Git revision (optional)
          automated_sync: Enable/disable automated sync (optional)
          prune: Enable/disable auto-pruning resources (optional)
          self_heal: Enable/disable self-healing (optional)
          validate: Whether to validate the application
  
      Returns:
          The updated application details
      """
      # First get the current application details
      success, app_data = await make_api_request(f"applications/{name}")
      if not success:
          return {
              "error": app_data.get(
                  "error", f"Failed to get current application details for '{name}'"
              )
          }
  
      # Update fields only if provided
      if project:
          app_data["spec"]["project"] = project
  
      if repo_url or path or revision:
          # Update source fields
          source = app_data["spec"].get("source", {})
          if repo_url:
              source["repoURL"] = repo_url
          if path:
              source["path"] = path
          if revision:
              source["targetRevision"] = revision
          app_data["spec"]["source"] = source
  
      if dest_server or dest_namespace:
          # Update destination fields
          destination = app_data["spec"].get("destination", {})
          if dest_server:
              destination["server"] = dest_server
          if dest_namespace:
              destination["namespace"] = dest_namespace
          app_data["spec"]["destination"] = destination
  
      # Update sync policy if any of those parameters are provided
      if automated_sync is not None or prune is not None or self_heal is not None:
          sync_policy = app_data["spec"].get("syncPolicy", {})
          automated = (
              sync_policy.get("automated", {}) if "automated" in sync_policy else None
          )
  
          # Create automated section if it doesn't exist but should
          if automated_sync is True and automated is None:
              automated = {}
              sync_policy["automated"] = automated
  
          # Remove automated section if it exists but should not
          elif automated_sync is False and automated is not None:
              del sync_policy["automated"]
  
          # Update automated settings
          if automated is not None:
              if prune is not None:
                  automated["prune"] = prune
              if self_heal is not None:
                  automated["selfHeal"] = self_heal
  
          app_data["spec"]["syncPolicy"] = sync_policy
  
      # Add query parameters
      params = {}
      if validate:
          params["validate"] = "true"
  
      # Update the application
      success, response = await make_api_request(
          f"applications/{name}", method="PUT", data=app_data, params=params
      )
  
      if success:
          logger.info(f"Application '{name}' updated successfully")
          return response
      else:
          logger.error(f"Failed to update application '{name}': {response.get('error')}")
          return {
              "error": response.get("error", f"Failed to update application '{name}'")
          }

• server.py:44-44 (registration)

  Registers the update_application function from tools.applications as an MCP tool using the FastMCP tool decorator.

  mcp.tool()(applications.update_application)

• server.py:18-18 (registration)

  Imports the applications module containing the update_application handler for registration.

  import tools.settings as settings