$git clone https://github.com/argoproj-labs/mcp-for-argocdAn implementation of Model Context Protocol (MCP) server for Argo CD, enabling AI assistants to interact with your Argo CD applications through natural language. This server allows for seamless integr
| 1 | # Argo CD MCP Server |
| 2 | |
| 3 | An implementation of [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server for [Argo CD](https://argo-cd.readthedocs.io/en/stable/), enabling AI assistants to interact with your Argo CD applications through natural language. This server allows for seamless integration with Visual Studio Code and other MCP clients through stdio and HTTP stream transport protocols. |
| 4 | |
| 5 | <a href="https://glama.ai/mcp/servers/@akuity/argocd-mcp"> |
| 6 | <img width="380" height="200" src="https://glama.ai/mcp/servers/@akuity/argocd-mcp/badge" alt="argocd-mcp MCP server" /> |
| 7 | </a> |
| 8 | |
| 9 | <!-- |
| 10 | // Generate using?: |
| 11 | const config = JSON.stringify({ |
| 12 | "name": "argocd-mcp", |
| 13 | "command": "npx", |
| 14 | "args": ["argocd-mcp@latest", "stdio"], |
| 15 | "env": { |
| 16 | "ARGOCD_BASE_URL": "<argocd_url>", |
| 17 | "ARGOCD_API_TOKEN": "<argocd_token>" |
| 18 | } |
| 19 | }); |
| 20 | const urlForWebsites = `vscode:mcp/install?${encodeURIComponent(config)}`; |
| 21 | // Github markdown does not allow linking to `vscode:` directly, so you can use our redirect: |
| 22 | const urlForGithub = `https://insiders.vscode.dev/redirect?url=${encodeURIComponent(urlForWebsites)}`; |
| 23 | --> |
| 24 | |
| 25 | [<img src="https://img.shields.io/badge/VS_Code-VS_Code?style=flat-square&label=Install%20Server&color=0098FF" alt="Install in VS Code">](https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522argocd-mcp%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522argocd-mcp%2540latest%2522%252C%2522stdio%2522%255D%252C%2522env%2522%253A%257B%2522ARGOCD_BASE_URL%2522%253A%2522%253Cargocd_url%253E%2522%252C%2522ARGOCD_API_TOKEN%2522%253A%2522%253Cargocd_token%253E%2522%257D%257D) [<img alt="Install in VS Code Insiders" src="https://img.shields.io/badge/VS_Code_Insiders-VS_Code_Insiders?style=flat-square&label=Install%20Server&color=24bfa5">](https://insiders.vscode.dev/redirect?url=vscode-insiders%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522argocd-mcp%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522argocd-mcp%2540latest%2522%252C%2522stdio%2522%255D%252C%2522env%2522%253A%257B%2522ARGOCD_BASE_URL%2522%253A%2522%253Cargocd_url%253E%2522%252C%2522ARGOCD_API_TOKEN%2522%253A%2522%253Cargocd_token%253E%2522%257D%257D) |
| 26 | |
| 27 | --- |
| 28 |  |
| 29 | |
| 30 | ## Features |
| 31 | |
| 32 | - **Transport Protocols**: Supports both stdio and HTTP stream transport modes for flexible integration with different clients |
| 33 | - **Complete Argo CD API Integration**: Provides comprehensive access to Argo CD resources and operations |
| 34 | - **AI Assistant Ready**: Pre-configured tools for AI assistants to interact with Argo CD in natural language |
| 35 | |
| 36 | ## Available Tools |
| 37 | |
| 38 | The server provides the following ArgoCD management tools: |
| 39 | |
| 40 | ### Cluster Management |
| 41 | - `list_clusters`: List all clusters registered with ArgoCD |
| 42 | |
| 43 | ### Project Management |
| 44 | - `get_appproject`: Get detailed information about a specific AppProject (project) |
| 45 | |
| 46 | ### Application Management |
| 47 | - `list_applications`: List and filter all applications |
| 48 | - `get_application`: Get detailed information about a specific application |
| 49 | - `create_application`: Create a new application |
| 50 | - `update_application`: Update an existing application |
| 51 | - `delete_application`: Delete an application |
| 52 | - `sync_application`: Trigger a sync operation on an application |
| 53 | |
| 54 | ### Resource Management |
| 55 | - `get_application_resource_tree`: Get the resource tree for a specific application |
| 56 | - `get_application_managed_resources`: Get managed resources for a specific application |
| 57 | - `get_application_workload_logs`: Get logs for application workloads (Pods, Deployments, etc.) |
| 58 | - `get_resource_events`: Get events for resources managed by an application |
| 59 | - `get_resource_actions`: Get available actions for resources |
| 60 | - `run_resource_action`: Run an action on a resource |
| 61 | |
| 62 | ## Installation |
| 63 | |
| 64 | ### Prerequisites |
| 65 | |
| 66 | - Node.js (v18 or higher recommended) |
| 67 | - pnpm package manager (for development) |
| 68 | - Argo CD instance with API access |
| 69 | - Argo CD API token (see t |