Back to Browse
Free
Server data from the Official MCP Registry
50 tools to manage Rundeck jobs, executions, projects, nodes, and system via MCP
About
50 tools to manage Rundeck jobs, executions, projects, nodes, and system via MCP
Security Report
4.8
Use Caution4.8High RiskThis MCP server provides comprehensive Rundeck automation capabilities with proper authentication via API tokens stored in environment variables. The codebase is well-structured with appropriate input validation using Zod, consistent error handling, and no evidence of malicious patterns or credential exposure. Permissions align well with the server's purpose as a Rundeck management tool. Minor code quality improvements around error logging could be made, but these do not constitute security risks. Supply chain analysis found 3 known vulnerabilities in dependencies (0 critical, 3 high severity). Package verification found 1 issue.
7 files analyzed · 7 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
What You'll Need
Set these up before or after installing:
Rundeck server URL (e.g., http://localhost:4440)
Environment variable: RUNDECK_URL
API token for authenticationRequired
Environment variable: RUNDECK_API_TOKEN
Rundeck API version (default: 41)
Environment variable: RUNDECK_API_VERSION
Request timeout in milliseconds (default: 30000)
Environment variable: RUNDECK_TIMEOUT
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-mariomorenodev-rundeck-mcp-server": {
"env": {
"RUNDECK_URL": "your-rundeck-url-here",
"RUNDECK_TIMEOUT": "your-rundeck-timeout-here",
"RUNDECK_API_TOKEN": "your-rundeck-api-token-here",
"RUNDECK_API_VERSION": "your-rundeck-api-version-here"
},
"args": [
"-y",
"rundeck-mcp-server"
],
"command": "npx"
}
}
}Documentation
View on GitHubFrom the project's GitHub README.
rundeck-mcp-server
The most comprehensive MCP (Model Context Protocol) server for Rundeck. Manage jobs, executions, projects, nodes, and more from Claude, Cursor, or any MCP-compatible client.
50 tools across 7 domains — full CRUD operations, execution monitoring, and system management.
Features
- Projects — List, create, delete, and configure projects
- Jobs — List, create, run, retry, import/export, enable/disable execution and scheduling
- Executions — Monitor running jobs, get logs, abort executions, query history
- Nodes — Browse node inventory with filter expressions
- System — Server info, health checks, metrics, execution mode control
- Key Storage — Manage secrets, passwords, and SSH keys
- Webhooks — Create and manage webhook triggers
- ACL Policies — Full CRUD for system access control policies
Quick Start
Prerequisites
- Node.js 18+
- A Rundeck instance with API access
- A Rundeck API token (how to generate one)
Using with Claude Code
Add to your MCP settings:
{
"mcpServers": {
"rundeck": {
"command": "npx",
"args": ["-y", "rundeck-mcp-server"],
"env": {
"RUNDECK_URL": "http://your-rundeck-server:4440",
"RUNDECK_API_TOKEN": "your-api-token"
}
}
}
}
Using with Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"rundeck": {
"command": "npx",
"args": ["-y", "rundeck-mcp-server"],
"env": {
"RUNDECK_URL": "http://your-rundeck-server:4440",
"RUNDECK_API_TOKEN": "your-api-token"
}
}
}
}
Using with Cursor
Add to your Cursor MCP settings (.cursor/mcp.json):
{
"mcpServers": {
"rundeck": {
"command": "npx",
"args": ["-y", "rundeck-mcp-server"],
"env": {
"RUNDECK_URL": "http://your-rundeck-server:4440",
"RUNDECK_API_TOKEN": "your-api-token"
}
}
}
}
Configuration
| Environment Variable | Required | Default | Description |
|---|---|---|---|
RUNDECK_URL | Yes | — | Rundeck server URL (e.g., http://localhost:4440) |
RUNDECK_API_TOKEN | Yes | — | API token for authentication |
RUNDECK_API_VERSION | No | 41 | Rundeck API version |
RUNDECK_TIMEOUT | No | 30000 | Request timeout in milliseconds |
Available Tools
Projects (6 tools)
| Tool | Description |
|---|---|
rundeck_list_projects | List all projects |
rundeck_get_project | Get project details and configuration |
rundeck_create_project | Create a new project |
rundeck_delete_project | Delete a project permanently |
rundeck_get_project_config | Get project configuration properties |
rundeck_set_project_config | Update project configuration |
Jobs (14 tools)
| Tool | Description |
|---|---|
rundeck_list_jobs | List jobs with filtering by group, name, tags |
rundeck_get_job | Get full job definition (steps, options, schedule) |
rundeck_get_job_metadata | Get job metadata (author, dates) |
rundeck_run_job | Execute a job with options and node filters |
rundeck_retry_job | Retry a failed execution |
rundeck_import_jobs | Import jobs from JSON/YAML/XML |
rundeck_export_jobs | Export job definitions |
rundeck_delete_job | Delete a job |
rundeck_bulk_delete_jobs | Delete multiple jobs at once |
rundeck_enable_job_execution | Enable job execution |
rundeck_disable_job_execution | Disable job execution |
rundeck_enable_job_schedule | Enable job scheduling |
rundeck_disable_job_schedule | Disable job scheduling |
rundeck_get_job_forecast | Get upcoming scheduled execution times |
Executions (8 tools)
| Tool | Description |
|---|---|
rundeck_list_executions | Query executions with status and time filters |
rundeck_list_running_executions | List currently running executions |
rundeck_get_execution | Get execution details (status, duration, nodes) |
rundeck_get_execution_output | Get execution log output |
rundeck_abort_execution | Abort a running execution |
rundeck_get_job_executions | List execution history for a job |
rundeck_delete_job_executions | Delete all executions for a job |
rundeck_bulk_delete_executions | Delete multiple executions by ID |
Nodes (2 tools)
| Tool | Description |
|---|---|
rundeck_list_nodes | List nodes with filter expressions |
rundeck_get_node | Get node details |
System (12 tools)
| Tool | Description |
|---|---|
rundeck_system_info | Server version, uptime, and system stats |
rundeck_get_execution_mode | Check active/passive execution mode |
rundeck_set_execution_mode | Enable or disable executions system-wide |
rundeck_get_metrics | Server performance metrics |
rundeck_healthcheck | System health check |
rundeck_list_users | List all users |
rundeck_get_log_storage | Log storage status |
rundeck_list_acl_policies | List ACL policy files |
rundeck_get_acl_policy | Get ACL policy content |
rundeck_create_acl_policy | Create ACL policy |
rundeck_update_acl_policy | Update ACL policy |
rundeck_delete_acl_policy | Delete ACL policy |
Key Storage (4 tools)
| Tool | Description |
|---|---|
rundeck_list_keys | Browse key storage tree |
rundeck_get_key_metadata | Get key metadata (not the secret value) |
rundeck_create_key | Store a password, public key, or private key |
rundeck_delete_key | Delete a stored key |
Webhooks (4 tools)
| Tool | Description |
|---|---|
rundeck_list_webhooks | List webhooks in a project |
rundeck_get_webhook | Get webhook details |
rundeck_create_webhook | Create a webhook trigger |
rundeck_delete_webhook | Delete a webhook |
Usage Examples
Once configured, you can interact with Rundeck using natural language:
- "List all projects in Rundeck"
- "Show me the running executions in the production project"
- "Run the deploy-app job in the staging project with version=2.1.0"
- "Get the logs from execution 1234"
- "Abort execution 5678"
- "Show me all failed executions in the last 24 hours"
- "List the nodes tagged as 'web' in the production project"
- "Check the Rundeck server health"
- "Disable the cleanup job schedule"
Development
# Clone the repository
git clone https://github.com/mariomorenodev/rundeck-mcp-server.git
cd rundeck-mcp-server
# Install dependencies
npm install
# Build
npm run build
# Run in development mode
RUNDECK_URL=http://localhost:4440 RUNDECK_API_TOKEN=your-token npm run dev
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
License
This project is licensed under the Apache License 2.0 — see the LICENSE file for details.
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
80.0K
Stars
3
Installs
6.5
Security
No ratings yet
Local
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
114
Stars
401
Installs
8.0
Security
4.8
Local
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
-
Stars
55
Installs
10.0
Security
5.0
Local