argocd-mcp

Instructions

Get details for a specific application

Args:
    name: The application name (required)
    project: The project name (optional filter)
    refresh: Forces application reconciliation if set to 'hard' or 'normal'
    namespace: Filter by application namespace

Returns:
    Application details

Implementation Reference

• tools/applications.py:63-98 (handler)

  The handler function that retrieves detailed information for a specific ArgoCD application by making an API request to /applications/{name} with optional filters.

  async def get_application_details(
      name: str, project: str = "", refresh: str = "", namespace: str = ""
  ) -> Dict[str, Any]:
      """
      Get details for a specific application
  
      Args:
          name: The application name (required)
          project: The project name (optional filter)
          refresh: Forces application reconciliation if set to 'hard' or 'normal'
          namespace: Filter by application namespace
  
      Returns:
          Application details
      """
      params = {}
  
      if project:
          params["project"] = project
  
      if refresh in ["hard", "normal"]:
          params["refresh"] = refresh
  
      if namespace:
          params["appNamespace"] = namespace
  
      success, data = await make_api_request(f"applications/{name}", params=params)
  
      if success:
          return data
      else:
          return {
              "error": data.get(
                  "error", f"Failed to get details for application '{name}'"
              )
          }

• server.py:42-42 (registration)

  Registers the get_application_details function as an MCP tool in the FastMCP server.

  mcp.tool()(applications.get_application_details)