RelayRunner docs: MCP server Page: https://relayrunner.dev/docs/reference/mcp Markdown: https://relayrunner.dev/docs/reference/mcp.md All pages: https://relayrunner.dev/docs/llms.txt Other pages (Markdown): - Route GitHub Actions jobs to any runner: https://relayrunner.dev/docs/get-started/overview.md - How it works with GitHub Actions: https://relayrunner.dev/docs/get-started/github-actions.md - Quickstart: https://relayrunner.dev/docs/get-started/quickstart.md - Install the CLI: https://relayrunner.dev/docs/get-started/install.md - RelayRunner for Mac: https://relayrunner.dev/docs/get-started/mac-app.md - Set up with an agent: https://relayrunner.dev/docs/get-started/agents.md - Move your workflows over: https://relayrunner.dev/docs/get-started/move-over.md - Principles: https://relayrunner.dev/docs/concepts/principles.md - Routing: https://relayrunner.dev/docs/concepts/routing.md - Runner order: https://relayrunner.dev/docs/concepts/runner-order.md - Optimized checks: https://relayrunner.dev/docs/concepts/optimized-checks.md - Spend controls: https://relayrunner.dev/docs/guides/spend-controls.md - Providers: https://relayrunner.dev/docs/runners/providers.md - Your machines: https://relayrunner.dev/docs/runners/self-hosted.md - GitHub-hosted: https://relayrunner.dev/docs/runners/github.md - Hosted providers: https://relayrunner.dev/docs/runners/hosted.md - Runner labels: https://relayrunner.dev/docs/reference/labels.md - Add a provider: https://relayrunner.dev/docs/contribute/add-provider.md - Run CI on your laptop while you work: https://relayrunner.dev/docs/guides/laptop-ci.md - macOS and iOS builds on your Mac: https://relayrunner.dev/docs/guides/mac-builds.md - Share your team's machines: https://relayrunner.dev/docs/guides/team-machines.md - Keep up with coding agents: https://relayrunner.dev/docs/guides/agent-surge.md - Activity and history: https://relayrunner.dev/docs/dashboard/activity.md - Signals: https://relayrunner.dev/docs/dashboard/signals.md - Performance: https://relayrunner.dev/docs/dashboard/performance.md - Usage and savings: https://relayrunner.dev/docs/dashboard/usage.md - Telemetry: https://relayrunner.dev/docs/dashboard/telemetry.md - AI: https://relayrunner.dev/docs/dashboard/ai.md - CLI: https://relayrunner.dev/docs/reference/cli.md - relay.yml inputs: https://relayrunner.dev/docs/reference/relay-inputs.md - Repo config: https://relayrunner.dev/docs/reference/repo-config.md - MCP server: https://relayrunner.dev/docs/reference/mcp.md (this page) - RelayRunner API: https://relayrunner.dev/docs/reference/api.md - Workspaces and members: https://relayrunner.dev/docs/dashboard/workspaces.md - GitHub App: https://relayrunner.dev/docs/reference/github-app.md - Security: https://relayrunner.dev/docs/reference/security.md - Data and privacy: https://relayrunner.dev/docs/reference/privacy.md - Remove RelayRunner: https://relayrunner.dev/docs/dashboard/remove.md - Troubleshooting: https://relayrunner.dev/docs/reference/troubleshooting.md - Errors: https://relayrunner.dev/docs/reference/errors.md - FAQ: https://relayrunner.dev/docs/reference/faq.md - Feedback: https://relayrunner.dev/docs/contribute/feedback.md - Changelog: https://relayrunner.dev/docs/changelog.md - Agents can change your routing: https://relayrunner.dev/docs/changelog/agent-changes.md - Pick runner sizes on the dashboard: https://relayrunner.dev/docs/changelog/auto-runner-sizes.md - CLI changelog: https://relayrunner.dev/docs/changelog/cli.md - Send job logs to your tools or your own bucket: https://relayrunner.dev/docs/changelog/job-log-export.md - Mac app changelog: https://relayrunner.dev/docs/changelog/mac.md - RelayRunner for Mac: https://relayrunner.dev/docs/changelog/mac-app.md - CI traces in your observability tool: https://relayrunner.dev/docs/changelog/opentelemetry-traces.md - Platform changelog: https://relayrunner.dev/docs/changelog/platform.md - Retries, queueing and provider usage: https://relayrunner.dev/docs/changelog/retries-queueing-and-provider-usage.md - Route a repo from the dashboard: https://relayrunner.dev/docs/changelog/route-a-repo.md - Clearer run times and job sizes for members: https://relayrunner.dev/docs/changelog/run-times.md - Usual times, job history and the Mac queue: https://relayrunner.dev/docs/changelog/usual-times-and-mac-queue.md --- # MCP server > Let AI agents read your workspace's runners, runs and usage, and change its routing. The MCP server lets your agent answer questions about your CI without you opening the dashboard. Where you allow it, the agent can also change your routing, such as the runner order or a job's size. ```text https://agents.relayrunner.app/mcp ``` ## Connect an agent ### Claude Code Add the server, then run `/mcp` in Claude Code to sign in. ```sh claude mcp add --transport http relayrunner https://agents.relayrunner.app/mcp ``` ### Claude In Claude, open **Settings → Connectors** and choose **Add custom connector**. Name it RelayRunner, paste the URL above, then choose **Connect**. ### Cursor Add this to `~/.cursor/mcp.json`, then choose **Connect** next to RelayRunner in Cursor's MCP settings. ```json { "mcpServers": { "relayrunner": { "url": "https://agents.relayrunner.app/mcp" } } } ``` ### VS Code Add the server, then start it from the **MCP Servers** list to sign in. ```sh code --add-mcp '{"name":"relayrunner","type":"http","url":"https://agents.relayrunner.app/mcp"}' ``` ### Other agents Add the URL as a remote MCP server (streamable HTTP). The agent signs in with OAuth, so there's no key to paste. ### Signing in The first time the agent uses it, your browser opens. Sign in with GitHub, pick which workspaces the agent may read, and approve it. The same steps are in the dashboard under **Settings → Agents**, where you can also see and disconnect agents. Disconnecting, or leaving a workspace, cuts the agent off at once. For better answers, install the `relayrunner-ci-insights` skill with `npx skills add relayrunner/relayrunner`. It tells your agent which tool answers which question. See [Set up with an agent](/docs/get-started/agents#install-the-skills). ## Allow changes An agent can only read until you turn on **Allow changes** for it under **Settings → Agents**, in each workspace. Then it can change the runner order, job sizes, automatic retries and AI, and pause or resume runners. It still acts as you: it can't change what you can't change in the dashboard. Every change shows in **Activity** with your name and the agent's, such as "Ada set the default size for auto jobs to 4 vCPU through Claude". Agents ask before they change something, and each change answers the previous value, so you can ask the agent to undo it. Turning Allow changes off takes effect at once. Agents can't delete anything or touch members, installs or billing. ## Skills The server also serves the RelayRunner skills, so agents that support skills over MCP can load them without installing anything. Each one is a resource at `skill:///SKILL.md`: | Skill | What it covers | | ------------------------- | --------------------------------------------------------------------- | | `relayrunner` | Setting up machines with the CLI and running them day to day | | `relayrunner-route-jobs` | Routing a repo's jobs, and why a job was skipped | | `relayrunner-ci-insights` | Which tool answers which question, such as why a job ran where it did | ## Things to ask - "Are my runners online, and what are they running right now?" - "Why did my last push run on GitHub instead of my Mac?" - "Which jobs cost the most this month?" - "How long does the test job usually take on each runner?" - "What's making our CI slow?" - "Which workflows aren't routed yet?" - "Run the e2e job on 8 vCPU." (needs Allow changes) - "Pause my Mac until tomorrow's demo is over." (needs Allow changes) ## Tools | Tool | What it reads | | --------------------- | ----------------------------------------------------------------------- | | `list_workspaces` | The workspaces this connection can read | | `get_workspace` | One workspace, your role and its GitHub installation | | `list_runners` | Runners, their status, labels, pause state and current job | | `get_runner_order` | The providers jobs are tried on, in order | | `list_workflows` | Recent workflows and which ones are routed | | `list_runs` | Recent workflow runs, by repo, status or result | | `get_run_jobs` | One run's jobs and where each ran | | `get_run_failures` | Why a run's jobs failed, with the end of each log (read from GitHub) | | `list_activity` | The activity log, including where each job was routed and why | | `get_usage` | Short jobs and round-up cost, optimized check savings, Actions minutes | | `get_job_times` | Typical job durations per runner | | `get_signals` | What's making CI slow, costly or busier than it needs to be | | `get_router_settings` | Auto jobs' sizes, the default size, automatic retries and AI | | `send_feedback` | Reports a bug, confusing result or missing tool to the RelayRunner team | These change settings, with Allow changes on: | Tool | What it changes | | ------------------------------- | --------------------------------------------------- | | `set_runner_order` | The providers jobs are tried on, and their limits | | `set_default_size` | The size auto jobs get unless they have their own | | `set_job_size` | One auto job's size and the provider it tries first | | `set_retries` | Automatic retries, on or off | | `set_ai` | AI features, on or off | | `pause_runner`, `resume_runner` | Whether jobs route to a runner | Every tool takes an optional `workspace`, needed only when the agent can read more than one.