# Rundeck

> Rundeck is an open-source MCP server for developer tools. MCP server that lets AI clients drive Rundeck runbook automation and job scheduling. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, self-hosted
- **Repository:** https://github.com/asklokesh/rundeck-mcp-server
- **MCP Registry name:** io.github.asklokesh/rundeck-mcp-server
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

The README describes this as a Model Context Protocol server that connects Rundeck, an runbook automation and job scheduling platform, to GenAI applications. It is distributed as a Python package on PyPI and can also be installed from source, with configuration handled through environment variables or a .env file that holds the Rundeck API URL and API key.

Once running over stdio, the server is meant to expose Rundeck's API to an AI client. The README lists broad API coverage, several authentication methods, rate limiting, retry handling and async support, though it does not enumerate the individual tools it exposes.

The listing suits teams that already use Rundeck for operations runbooks and want an assistant to inspect or trigger jobs through the same API. The project is released under the MIT licence.

## Features

- **Rundeck API coverage:** Wraps a broad set of Rundeck API endpoints for use from MCP-compatible AI clients.
- **Multiple authentication methods:** Supports more than one way of authenticating against the Rundeck API.
- **Rate limiting and retries:** Includes rate limiting and retry logic for calls to the Rundeck server.
- **Async operation:** Offers asynchronous support intended to improve performance on API calls.
- **Environment-based configuration:** Reads the Rundeck URL and API key from environment variables or a .env file.

## Good for

- Letting an AI assistant check the status of Rundeck jobs
- Triggering existing Rundeck runbooks from a chat-based workflow
- Querying Rundeck job configuration while troubleshooting operations

## Install

### Claude Code (Terminal)

```sh
claude mcp add rundeck-mcp-server --env RUNDECK_API_KEY='<RUNDECK_API_KEY>' -- uvx rundeck-mcp-server
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "rundeck-mcp-server": {
      "command": "uvx",
      "args": [
        "rundeck-mcp-server"
      ],
      "env": {
        "RUNDECK_API_KEY": "<RUNDECK_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "rundeck-mcp-server": {
      "command": "uvx",
      "args": [
        "rundeck-mcp-server"
      ],
      "env": {
        "RUNDECK_API_KEY": "<RUNDECK_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "rundeck-mcp-server": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "rundeck-mcp-server"
      ],
      "env": {
        "RUNDECK_API_KEY": "<RUNDECK_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "rundeck-mcp-server": {
      "command": "uvx",
      "args": [
        "rundeck-mcp-server"
      ],
      "env": {
        "RUNDECK_API_KEY": "<RUNDECK_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "rundeck-mcp-server": {
      "command": "uvx",
      "args": [
        "rundeck-mcp-server"
      ],
      "env": {
        "RUNDECK_API_KEY": "<RUNDECK_API_KEY>"
      }
    }
  }
}
```

## FAQ

### How is the server installed?

The README gives the command pip install rundeck-mcp-server, and also describes installing from a cloned repository with pip install -e.

### What configuration does it need?

The registry entry lists RUNDECK_API_KEY as a required secret and RUNDECK_API_URL as an optional variable pointing to the Rundeck API.

### What license is it under?

The README states it is released under the MIT License.

### Is Rundeck free?

Yes. Rundeck is open source, so you can use and self-host it for free.

### How do I add Rundeck to Claude Code?

Run this command in your terminal: claude mcp add rundeck-mcp-server --env RUNDECK_API_KEY='<RUNDECK_API_KEY>' -- uvx rundeck-mcp-server

### What are the best alternatives to Rundeck?

The closest alternatives to Rundeck are Uipath, Harness, RunCloud MCP by usefulapi, MCP Acedatacloud and McpMux.

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Uipath](https://ai-powered.com/mcp/uipath): Uipath is an open-source MCP server for developer tools.
- [Harness](https://ai-powered.com/mcp/harness-2): Harness is an open-source MCP server for developer tools.
- [RunCloud MCP by usefulapi](https://ai-powered.com/mcp/runcloud-mcp-by-usefulapi): RunCloud MCP by usefulapi is a freemium MCP server for cloud and infrastructure.
- [MCP Acedatacloud](https://ai-powered.com/mcp/mcp-acedatacloud): MCP Acedatacloud is an open-source MCP server for cloud and infrastructure.
- [McpMux](https://ai-powered.com/mcp/mcpmux-2): McpMux is an open-source MCP server for developer tools.
- [fastapi_mcp](https://ai-powered.com/mcp/fastapi-mcp): fastapi_mcp is an open-source MCP server for ai models and llm tooling.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [AgentRQ](https://ai-powered.com/mcp/agentrq): AgentRQ is an open-source MCP server for productivity.

---
Source: https://ai-powered.com/mcp/rundeck
