Labsco
MCP SERVER

ArgoCD MCP Server

by severity1

List, inspect, create and sync ArgoCD applications, and read the server's settings, plugins and version, over the ArgoCD API.

Containers, Kubernetes & Cluster Operations
Summary
Read the drift and fix it in the same conversation.

The application tools cover the loop that matters day to day: list what is `OutOfSync` or `Degraded`, open the one that looks wrong, then sync it. Creating and deleting applications is in the same set, so give the token the scope you would give a person doing that, and check `get_user_info` to see which account it maps to.

What it is

An MCP server for ArgoCD, the GitOps continuous-delivery controller for Kubernetes. It wraps the ArgoCD REST API so an assistant can answer "what is out of sync in production" and act on the answer, with the API token supplied once through the environment instead of pasted into every request.

What you get
  • Applications listed with filters on project, name and namespace, and one application's full detail — `list_applications`, `get_application_details`
  • Applications created, changed and removed — `create_application`, `update_application`, `delete_application`
  • A sync triggered on an application, returning the resources it updated and the operation status — `sync_application`
  • The identity the token resolves to, so you can confirm which account the agent is acting as — `get_user_info`
  • Server settings including UI, OIDC and cluster configuration, the configured plugins, and the API server version — `get_settings`, `get_plugins`, `get_version`
Requirements

An ArgoCD API token in `ARGOCD_TOKEN` and your endpoint in `ARGOCD_API_URL` — the default points at an example host, so it will not work until you set it. Python 3.12+ and the `uv` package manager; install with `uv pip install -e .` and run `uv run server.py`. For self-signed certificates set `ARGOCD_VERIFY_SSL` to `false`. Tokens are masked in the server's own logging. `mcp dev server.py` opens the MCP Inspector for debugging.