Steadybit MCP Server

> [!WARNING]

> Deprecated. This standalone MCP server is no longer maintained. Use the hosted

> Remote MCP Server that is built into the

> Steadybit platform instead — it needs no local installation, supports OAuth, and covers considerably more tools

> (environments, targets, actions, services, experiment design, suggestions, and run analysis).

> See the documentation for setup instructions.

MCP server for Steadybit, enabling LLM tools like Claude to interact with the Steadybit platform.

Tools

1. `list-experiment-designs`

2. `get_experiment_design`

3. `list_experiment_executions`

are [CREATED, PREPARED, RUNNING, FAILED, CANCELED, COMPLETED, ERRORED]

4. `get_experiment_execution`

5. `list_actions`

6. `list_environments`

7. `list_teams`

8. `list_experiment_schedules`

9. `list_experiment_templates`

10. `get_experiment_template`

11. `create_experiment_from_template`

Setup

You need a Steadybit account and an API token. You can create an API token in the Steadybit platform under

Settings → API Access Tokens. Both token types — `Admin` or `Team` — are supported.

If you want to create experiments, you need a team token for the team you want to create experiments in.

Supported environment variables

• `API_TOKEN`: The API token to use for authentication. Required.
• `API_URL`: The URL of the Steadybit API. Defaults to `https://platform.steadybit.com/api`.
• `CAPABILITIES_ENABLED_0`, `CAPABILITIES_ENABLED_1`, ...: Additional capabilities to enable. Currently supported:

Usage with Claude Desktop

In Claude Desktop go to Settings → Developer → Edit and add the following JSON, replacing ``

with your actual token:

{
  "mcpServers": {
    "steadybit": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "API_TOKEN",
        "ghcr.io/steadybit/mcp:latest"
      ],
      "env": {
        "API_TOKEN": ""
      }
    }
  }
}

Local Development

Prerequisites

• Java 21+
• Maven 3.9+
• Docker (only required for the Docker image flow)
• Node.js / `npx` (used to run the MCP inspector)

> The MCP server uses STDIO transport, so there is no console logging. Server output is written to `steadybit-mcp.log`

> in the directory where you start the server.

Build

mvn clean install

The resulting jar is at `target/mcp--SNAPSHOT.jar`.

Run locally with the MCP inspector

npx @modelcontextprotocol/inspector \
  java -jar target/mcp-1.0.0-SNAPSHOT.jar \
  -e API_URL=https://platform.steadybit.com/api \
  -e API_TOKEN=

Logs are written to `steadybit-mcp.log` in the directory where you launched the inspector.

Run in Claude Desktop against your local jar

Edit Claude Desktop's developer config (Settings → Developer → Edit) to point at your local Java binary and the

freshly-built jar:

{
  "mcpServers": {
    "steadybit": {
      "command": "/path/to/your/java",
      "args": [
        "-jar",
        "/path/to/your/.m2/repository/com/steadybit/mcp/1.0.0-SNAPSHOT/mcp-1.0.0-SNAPSHOT.jar"
      ],
      "env": {
        "API_URL": "https://platform.steadybit.com/api",
        "API_TOKEN": "",
        "LOGGING_FILE_NAME": "/path/to/Library/Logs/Claude/steadybit-mcp-server.log"
      }
    }
  }
}

• MCP-client logs: `~/Library/Logs/Claude/mcp-server-steadybit.log`
• MCP-server logs: the path configured via `LOGGING_FILE_NAME` (defaults to `steadybit-mcp.log` next to the launcher)

Run tests

mvn test

Build the Docker image

docker build -t steadybit/mcp -f Dockerfile .

Then create a `config.json` and run the inspector against the image:

{
  "mcpServers": {
    "steadybit": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "API_TOKEN",
        "-e",
        "API_URL",
        "steadybit/mcp"
      ],
      "env": {
        "API_TOKEN": "",
        "API_URL": "https://platform.steadybit.com/api"
      }
    }
  }
}

npx @modelcontextprotocol/inspector --config config.json --server steadybit

Build a native image

Install GraalVM 24.0.1 via sdkman:

sdk install java 24.0.1-graalce
sdk use java 24.0.1-graalce

Then build with the `native` profile:

mvn -Pnative native:compile

Example Usage

Example prompts are in `examples/examples.md`.

License

MIT — see LICENSE for details.