MCP Server

The RunWhen Platform MCP Server connects AI coding agents to the RunWhen platform over the Model Context Protocol (MCP). It works with Cursor, VS Code (GitHub Copilot), Claude Desktop, Continue, and any other MCP-compatible client.

What it does

The MCP server gives your coding agent direct access to three categories of RunWhen functionality:

Category	What you can do
Workspace intelligence	Ask the RunWhen AI assistant about infrastructure, search issues, browse SLXs, review run sessions, and explore resource relationships.
Chat rules and commands	Create and manage chat rules and slash-commands that customize how your Engineering Assistants behave.
Task authoring (Tool Builder)	Write bash or Python scripts, validate them against the RunWhen contract, test against live infrastructure, and commit them as SLXs — all from your IDE.

Why use it

Without the MCP server, interacting with RunWhen means switching between your IDE and the RunWhen web UI. With it, your coding agent can:

• Investigate infrastructure issues by asking the RunWhen AI assistant directly from your editor
• Build and test automation tasks without leaving your coding workflow
• Commit production-ready SLXs that run on a schedule or on-demand
• Search and triage across workspaces, issues, tasks, and run sessions using natural language

How it works

The MCP server is a lightweight Python process that runs locally alongside your IDE. It translates MCP tool calls into RunWhen API requests:

IDE (Cursor, VS Code, Claude Desktop)
  │
  ├── MCP protocol (stdio) ──▶ runwhen-platform-mcp (local)
  │                                │
  │                                ├── RunWhen API (PAPI) — issues, SLXs, run scripts
  │                                └── RunWhen Agent (AgentFarm) — workspace chat
  │
  └── You see results inline in your editor

The server uses the same API token and permissions as your RunWhen account. All actions respect workspace RBAC — the agent can only do what your role allows.

Supported clients

The MCP server works with any client that supports MCP over stdio:

• Cursor — MCP Settings or .cursor/mcp.json
• VS Code (GitHub Copilot) — .vscode/mcp.json or user settings
• Claude Desktop — claude_desktop_config.json
• Continue, Codex, Gemini CLI, and others

See Installation & Setup for client-specific configuration.

Requirements

• Python 3.10+
• RunWhen account with an API token (how to get a token)
• An MCP-compatible client

Next steps

Page	Description
Installation & Setup	Install the server and configure your MCP client
Tool Reference	Complete list of available tools and what they do
Tool Builder	End-to-end workflow for building and committing automation tasks