This MCP server provides a Model Context Protocol interface for integrating Rundeck with GenAI applications. It exposes Rundeck API coverage through a Python-based MCP server, enabling clients to query jobs, executions, projects, and more via the MCP protocol while benefiting from the server's error handling and retry logic. The server is designed to be easily mounted into standard MCP workflows and can be extended with additional authentication methods or rate limiting as needed. To use it, start the server and connect your MCP-enabled agents or clients to the configured endpoint; the server will translate MCP requests into Rundeck API calls and return the results in MCP format.

Prerequisites:

• Python 3.8+ installed on your system
• access to a Rundeck instance with an API token

Installation steps:

1. Install the package from PyPI or clone the repository

   pip install rundeck-mcp-server

   or from source

   git clone https://github.com/LokiMCPUniverse/rundeck-mcp-server.git cd rundeck-mcp-server pip install -e .

2. Configure environment variables Create a .env file or export the following variables:

   RUNDECK_API_BASE_URL=https://your-rundeck-instance/api RUNDECK_API_TOKEN=your-rundeck-api-token RUNDECK_API_TIMEOUT=30

3. Run the server

   python -m rundeck_mcp

4. Verify the server is running by sending a test MCP request or checking the logs for startup confirmation.

Tips:

• Ensure your Rundeck API token has sufficient permissions for the endpoints you plan to access (projects, jobs, executions).
• If hosting behind a reverse proxy, configure appropriate CORS and request size limits as needed.
• The environment variable RUNDECK_API_TIMEOUT controls the request timeout in seconds; adjust based on network conditions.
• If you encounter authentication errors, double-check that RUNDECK_API_BASE_URL ends with /api and that the token is valid.
• This server focuses on Rundeck API coverage; if you need additional endpoints or custom logic, consider extending the rundeck_mcp module and contributing back.