@relay-org/relay-mcp

List all projects and their environments known to the Relay agent.

List recent deploys. Filter by app, env, and/or branch. Returns build numbers, statuses, deployed_by, commit messages, and timestamps.

Get a single deploy record by ID including status, logs reference, image tag, and commit info.

Fetch the stored build and deploy logs for a given deploy ID.

Cancel an in-progress deploy by ID.

Roll back the most recent deploy to the previous image for an app/env/branch.

Start a stopped app container without triggering a new build.

Stop a running app container.

Restart a running app container in place without a new build.

Delete a lane and remove its container, workspace, and state from the agent.

Get the current lane configuration for an app including access_policy, public_host, engine, host_port, service_port, and rollout settings.

Update lane configuration for an app. Only supply the fields you want to change.

List secret key names (not values) for an app/env/branch.

Add or update a secret value for an app/env/branch. The value is encrypted at rest if RELAY_SECRET_KEY is configured on the agent.

Delete a secret by key for an app/env/branch.

List promotion requests. Shows source/target lane, image, approval state, and post-promote health status.

Approve a queued promotion request by ID. Requires owner role.

List all user accounts with their roles. Requires owner role.

Fetch recent audit log entries showing actor, action, target, and timestamp. Requires owner role.

Get server-level config: base_domain, dashboard_host, ACME settings, and active theme. Requires owner role.

Update server-level config. Supply only the fields to change. Requires owner role.

List installed buildpack plugins on the agent.

Remove an installed buildpack plugin by name. Requires RELAY_ENABLE_PLUGIN_MUTATIONS=true on the agent.

Get relayd build metadata and Station runtime version details.

Generate a time-bounded signed share URL for a lane that uses access_policy=signed-link.

List managed companion services (databases, caches, etc.) attached to an app lane.

Restart a named companion service in place.