MCP for ArgoCD
An implementation of Model Context Protocol (MCP) server for Argo CD.
What is MCP for ArgoCD?
MCP for ArgoCD is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to implementation of model context protocol (mcp) server for argo cd.
An implementation of Model Context Protocol (MCP) server for Argo CD.
This server falls under the Cloud Services category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- An implementation of Model Context Protocol (MCP) server for
Use Cases
Maintainer
Works with
Installation
NPM
npx -y argocd-mcpManual Installation
npx -y argocd-mcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use MCP for ArgoCD
MCP for ArgoCD is the official argoproj-labs MCP server implementation that bridges AI assistants with the Argo CD GitOps continuous delivery platform via a standardised MCP interface. It exposes tools for full application lifecycle management — listing, creating, updating, deleting, and syncing apps — as well as resource tree inspection, workload log retrieval, event queries, and resource actions. Platform teams and DevOps engineers can use it to manage GitOps workflows through natural language without switching context away from their AI assistant.
Prerequisites
- Node.js v18 or higher installed
- A running Argo CD instance with API access
- An ArgoCD API token with sufficient permissions
- The ArgoCD instance base URL
- An MCP client such as Claude Desktop, VS Code, or Cursor
Generate an ArgoCD API token
Create an API token in Argo CD for the account that the MCP server will use. Store the token securely — you will pass it via an environment variable.
argocd account generate-token --account <your-account>Run the server with npx to verify connectivity
Use npx to start the server in STDIO mode with your credentials before adding it to your client config.
ARGOCD_BASE_URL=https://argo.example.com ARGOCD_API_TOKEN=your-token npx -y argocd-mcp@latest stdioAdd the server to your MCP client configuration
Add the argocd-mcp entry to your claude_desktop_config.json or equivalent client config file with the correct environment variables.
Optionally enable read-only mode
Set MCP_READ_ONLY=true to restrict the server to read operations only, disabling sync, create, update, delete, and resource action tools.
Optionally configure multi-instance access
For organisations with multiple ArgoCD clusters, create a token registry JSON file and reference it via ARGOCD_TOKEN_REGISTRY_PATH instead of setting a single ARGOCD_API_TOKEN.
[
{ "baseUrl": "https://argo-prod.example.com", "token": "<prod-token>" },
{ "baseUrl": "https://argo-staging.example.com", "token": "<staging-token>" }
]MCP for ArgoCD Examples
Client configuration
Standard claude_desktop_config.json entry for the MCP for ArgoCD server using STDIO transport.
{
"mcpServers": {
"argocd-mcp": {
"command": "npx",
"args": ["-y", "argocd-mcp@latest", "stdio"],
"env": {
"ARGOCD_BASE_URL": "https://argo.example.com",
"ARGOCD_API_TOKEN": "your-argocd-api-token"
}
}
}
}Prompts to try
Try these prompts once MCP for ArgoCD is connected to your assistant.
- "List all applications currently managed by ArgoCD and show which ones are out of sync."
- "Sync the backend-api application and wait for it to become healthy."
- "Show me the full resource tree for the frontend application."
- "Get the logs for the worker pods in the data-pipeline application."
- "What clusters are registered in this ArgoCD instance?"Troubleshooting MCP for ArgoCD
Self-signed TLS certificate causes connection failures
Add NODE_TLS_REJECT_UNAUTHORIZED=0 to the env block in your MCP client config. This should only be used in non-production environments.
The server starts but returns empty results for list_applications
Verify ARGOCD_BASE_URL is correct and does not include a trailing slash. Confirm the API token has at least read permissions for the applications you expect to see.
Cannot find the Docker image for containerised deployment
Use 'docker pull argoprojlabs/mcp-for-argocd' and run with 'docker run -e ARGOCD_BASE_URL=<url> -e ARGOCD_API_TOKEN=<token> argoprojlabs/mcp-for-argocd http --stateless'.
Frequently Asked Questions about MCP for ArgoCD
What is MCP for ArgoCD?
MCP for ArgoCD is a Model Context Protocol (MCP) server that implementation of model context protocol (mcp) server for argo cd. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install MCP for ArgoCD?
Install via npm with the command: npx -y argocd-mcp. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with MCP for ArgoCD?
MCP for ArgoCD works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is MCP for ArgoCD free to use?
Yes, MCP for ArgoCD is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.
MCP for ArgoCD Alternatives — Similar Cloud Services Servers
Looking for alternatives to MCP for ArgoCD? Here are other popular cloud services servers you can use with Claude, Cursor, and VS Code.
Open WebUI
★ 138.2kUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)
Anything LLM
★ 60.4kThe all-in-one AI productivity accelerator. On device and privacy first with no annoying setup or configuration.
LocalAI
★ 46.4kLocalAI is the open-source AI engine. Run any model - LLMs, vision, voice, image, video - on any hardware. No GPU required.
Nacos
★ 33.0kan easy-to-use dynamic service discovery, configuration and service management platform for building AI cloud native applications.
Xiaozhi ESP32
★ 26.7k本项目为xiaozhi-esp32提供后端服务，帮助您快速搭建ESP32设备控制服务器。Backend service for xiaozhi-esp32, helps you quickly build an ESP32 device control server.
Gateway
★ 11.8kA blazing fast AI Gateway with integrated guardrails. Route to 1,600+ LLMs, 50+ AI Guardrails with 1 fast & friendly API.
Browse More Cloud Services MCP Servers
Explore all cloud services servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up MCP for ArgoCD in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use MCP for ArgoCD?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.