argocd-mcp

Instructions

Delete an application from ArgoCD

Args:
    name: The name of the application to delete (required)
    cascade: Whether to delete application resources as well (default: True)
    propagation_policy: The propagation policy ("foreground", "background", or "orphan")
    namespace: The application namespace (optional)

Returns:
    Success message or error details

Implementation Reference

• tools/applications.py:290-333 (handler)

  The handler function that executes the delete_application tool by sending a DELETE request to the ArgoCD applications/{name} endpoint with parameters for cascade deletion, propagation policy, and namespace.

  async def delete_application(
      name: str, cascade: bool = True, propagation_policy: str = "", namespace: str = ""
  ) -> Dict[str, Any]:
      """
      Delete an application from ArgoCD
  
      Args:
          name: The name of the application to delete (required)
          cascade: Whether to delete application resources as well (default: True)
          propagation_policy: The propagation policy ("foreground", "background", or "orphan")
          namespace: The application namespace (optional)
  
      Returns:
          Success message or error details
      """
      params = {"cascade": str(cascade).lower()}
  
      if propagation_policy and propagation_policy in [
          "foreground",
          "background",
          "orphan",
      ]:
          params["propagationPolicy"] = propagation_policy
  
      if namespace:
          params["appNamespace"] = namespace
  
      success, data = await make_api_request(
          f"applications/{name}", method="DELETE", params=params
      )
  
      if success:
          logger.info(f"Application '{name}' deleted successfully (cascade: {cascade})")
          return {
              "status": "success",
              "message": f"Application '{name}' deleted successfully",
              "details": data,
          }
      else:
          logger.error(f"Failed to delete application '{name}': {data.get('error')}")
          return {
              "error": data.get("error", f"Failed to delete application '{name}'"),
              "details": data,
          }

• server.py:45-45 (registration)

  Registers the delete_application function as an MCP tool using the FastMCP tool decorator.

  mcp.tool()(applications.delete_application)