{
  "markdown": "# rundeck-mcp-server\n\n[![npm version](https://img.shields.io/npm/v/rundeck-mcp-server.svg)](https://www.npmjs.com/package/rundeck-mcp-server)\n[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)\n\nThe most comprehensive [MCP (Model Context Protocol)](https://modelcontextprotocol.io) server for [Rundeck](https://www.rundeck.com). Manage jobs, executions, projects, nodes, and more from Claude, Cursor, or any MCP-compatible client.\n\n**50 tools** across 7 domains — full CRUD operations, execution monitoring, and system management.\n\n## Features\n\n- **Projects** — List, create, delete, and configure projects\n- **Jobs** — List, create, run, retry, import/export, enable/disable execution and scheduling\n- **Executions** — Monitor running jobs, get logs, abort executions, query history\n- **Nodes** — Browse node inventory with filter expressions\n- **System** — Server info, health checks, metrics, execution mode control\n- **Key Storage** — Manage secrets, passwords, and SSH keys\n- **Webhooks** — Create and manage webhook triggers\n- **ACL Policies** — Full CRUD for system access control policies\n\n## Quick Start\n\n### Prerequisites\n\n- Node.js 18+\n- A Rundeck instance with API access\n- A Rundeck API token ([how to generate one](https://docs.rundeck.com/docs/manual/10-user.html#user-api-tokens))\n\n### Using with Claude Code\n\nAdd to your MCP settings:\n\n```json\n{\n  \"mcpServers\": {\n    \"rundeck\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"rundeck-mcp-server\"],\n      \"env\": {\n        \"RUNDECK_URL\": \"http://your-rundeck-server:4440\",\n        \"RUNDECK_API_TOKEN\": \"your-api-token\"\n      }\n    }\n  }\n}\n```\n\n### Using with Claude Desktop\n\nAdd to `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"rundeck\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"rundeck-mcp-server\"],\n      \"env\": {\n        \"RUNDECK_URL\": \"http://your-rundeck-server:4440\",\n        \"RUNDECK_API_TOKEN\": \"your-api-token\"\n      }\n    }\n  }\n}\n```\n\n### Using with Cursor\n\nAdd to your Cursor MCP settings (`.cursor/mcp.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"rundeck\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"rundeck-mcp-server\"],\n      \"env\": {\n        \"RUNDECK_URL\": \"http://your-rundeck-server:4440\",\n        \"RUNDECK_API_TOKEN\": \"your-api-token\"\n      }\n    }\n  }\n}\n```\n\n## Configuration\n\n| Environment Variable | Required | Default | Description |\n|---------------------|----------|---------|-------------|\n| `RUNDECK_URL` | Yes | — | Rundeck server URL (e.g., `http://localhost:4440`) |\n| `RUNDECK_API_TOKEN` | Yes | — | API token for authentication |\n| `RUNDECK_API_VERSION` | No | `41` | Rundeck API version |\n| `RUNDECK_TIMEOUT` | No | `30000` | Request timeout in milliseconds |\n\n## Available Tools\n\n### Projects (6 tools)\n\n| Tool | Description |\n|------|-------------|\n| `rundeck_list_projects` | List all projects |\n| `rundeck_get_project` | Get project details and configuration |\n| `rundeck_create_project` | Create a new project |\n| `rundeck_delete_project` | Delete a project permanently |\n| `rundeck_get_project_config` | Get project configuration properties |\n| `rundeck_set_project_config` | Update project configuration |\n\n### Jobs (14 tools)\n\n| Tool | Description |\n|------|-------------|\n| `rundeck_list_jobs` | List jobs with filtering by group, name, tags |\n| `rundeck_get_job` | Get full job definition (steps, options, schedule) |\n| `rundeck_get_job_metadata` | Get job metadata (author, dates) |\n| `rundeck_run_job` | Execute a job with options and node filters |\n| `rundeck_retry_job` | Retry a failed execution |\n| `rundeck_import_jobs` | Import jobs from JSON/YAML/XML |\n| `rundeck_export_jobs` | Export job definitions |\n| `rundeck_delete_job` | Delete a job |\n| `rundeck_bulk_delete_jobs` | Delete multiple jobs at once |\n| `rundeck_enable_job_execution` | Enable job execution |\n| `rundeck_disable_job_execution` | Disable job execution |\n| `rundeck_enable_job_schedule` | Enable job scheduling |\n| `rundeck_disable_job_schedule` | Disable job scheduling |\n| `rundeck_get_job_forecast` | Get upcoming scheduled execution times |\n\n### Executions (8 tools)\n\n| Tool | Description |\n|------|-------------|\n| `rundeck_list_executions` | Query executions with status and time filters |\n| `rundeck_list_running_executions` | List currently running executions |\n| `rundeck_get_execution` | Get execution details (status, duration, nodes) |\n| `rundeck_get_execution_output` | Get execution log output |\n| `rundeck_abort_execution` | Abort a running execution |\n| `rundeck_get_job_executions` | List execution history for a job |\n| `rundeck_delete_job_executions` | Delete all executions for a job |\n| `rundeck_bulk_delete_executions` | Delete multiple executions by ID |\n\n### Nodes (2 tools)\n\n| Tool | Description |\n|------|-------------|\n| `rundeck_list_nodes` | List nodes with filter expressions |\n| `rundeck_get_node` | Get node details |\n\n### System (12 tools)\n\n| Tool | Description |\n|------|-------------|\n| `rundeck_system_info` | Server version, uptime, and system stats |\n| `rundeck_get_execution_mode` | Check active/passive execution mode |\n| `rundeck_set_execution_mode` | Enable or disable executions system-wide |\n| `rundeck_get_metrics` | Server performance metrics |\n| `rundeck_healthcheck` | System health check |\n| `rundeck_list_users` | List all users |\n| `rundeck_get_log_storage` | Log storage status |\n| `rundeck_list_acl_policies` | List ACL policy files |\n| `rundeck_get_acl_policy` | Get ACL policy content |\n| `rundeck_create_acl_policy` | Create ACL policy |\n| `rundeck_update_acl_policy` | Update ACL policy |\n| `rundeck_delete_acl_policy` | Delete ACL policy |\n\n### Key Storage (4 tools)\n\n| Tool | Description |\n|------|-------------|\n| `rundeck_list_keys` | Browse key storage tree |\n| `rundeck_get_key_metadata` | Get key metadata (not the secret value) |\n| `rundeck_create_key` | Store a password, public key, or private key |\n| `rundeck_delete_key` | Delete a stored key |\n\n### Webhooks (4 tools)\n\n| Tool | Description |\n|------|-------------|\n| `rundeck_list_webhooks` | List webhooks in a project |\n| `rundeck_get_webhook` | Get webhook details |\n| `rundeck_create_webhook` | Create a webhook trigger |\n| `rundeck_delete_webhook` | Delete a webhook |\n\n## Usage Examples\n\nOnce configured, you can interact with Rundeck using natural language:\n\n- *\"List all projects in Rundeck\"*\n- *\"Show me the running executions in the production project\"*\n- *\"Run the deploy-app job in the staging project with version=2.1.0\"*\n- *\"Get the logs from execution 1234\"*\n- *\"Abort execution 5678\"*\n- *\"Show me all failed executions in the last 24 hours\"*\n- *\"List the nodes tagged as 'web' in the production project\"*\n- *\"Check the Rundeck server health\"*\n- *\"Disable the cleanup job schedule\"*\n\n## Development\n\n```bash\n# Clone the repository\ngit clone https://github.com/mariomorenodev/rundeck-mcp-server.git\ncd rundeck-mcp-server\n\n# Install dependencies\nnpm install\n\n# Build\nnpm run build\n\n# Run in development mode\nRUNDECK_URL=http://localhost:4440 RUNDECK_API_TOKEN=your-token npm run dev\n```\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n## License\n\nThis project is licensed under the Apache License 2.0 — see the [LICENSE](LICENSE) file for details.\n",
  "bytes": 7550,
  "sha": "35bbdacc30986e0846ecbac269b056fc85b1c221c007f05e9e3e94126ad64d65",
  "repo_slug": "mariomorenodev/rundeck-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_mariomorenodev_rundeck_mcp_ser_9f9277ff/readme"
}