Greenrun MCP Server

@Add-Item-To

Repository Homepage

Basic information

About Greenrun MCP Server

Browser test management for Claude Code. Write tests in plain English, run them with /greenrun.

#browser-testing#claude-code #playwright#e2e-testing#natural-language #mcp #testing

Greenrun MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "greenrun": {
      "command": "npx",
      "args": [
        "greenrun-cli"
      ]
    }
  }
}

Greenrun MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is Greenrun?

Greenrun is an MCP server that connects Claude Code to the Greenrun API for browser test management. You describe tests in plain English, and Claude generates and runs Playwright scripts automatically, handling script generation, parallel execution, result tracking, and re-running only what's needed.

How to use Greenrun?

Run npx greenrun-cli init to launch an interactive setup wizard that validates your API token, configures the Greenrun and Playwright MCP servers, installs slash commands, and adds project instructions. Tests are defined in the Greenrun dashboard or via MCP tools, then executed by running /greenrun in Claude Code. Manual setup is also supported via claude mcp add or .mcp.json.

Key features of Greenrun

Write tests in plain English, no Playwright code needed
Claude generates Playwright scripts on first run
Cached scripts skip generation on subsequent runs
Parallel test execution with result tracking
Impact analysis via /greenrun-sweep for changed pages
Named credential sets for authentication per test
Test filtering by tag, URL path, or name

Use cases of Greenrun

Define and run end-to-end browser tests without writing code
Quickly re-run only the tests affected by recent code changes
Manage test suites across multiple projects with credential management
Integrate browser testing directly into Claude Code workflows

Frequently asked questions

What are the prerequisites for using Greenrun?

Node.js 18+, Claude Code, and the Playwright MCP server (configured automatically by the init wizard).

How does Greenrun generate test scripts?

On the first run, Claude walks through each test's instructions in the browser, observes UI states, and generates a `.spec.ts` script with real selectors. The script is cached and reused on future runs.

How does Greenrun handle test failures due to stale scripts?

If a cached script fails, an AI agent re-executes the test manually to determine whether the script is stale or there is a real bug. Stale scripts are automatically cleared for regeneration.

How does Greenrun handle authentication?

Projects support named credential sets (name, email, password). Each test can reference a credential by name via `credential_name`, and during execution the matching credentials are used to authenticate.

How can I run only tests affected by recent code changes?

Run the `/greenrun-sweep` slash command. It detects which tests are impacted by the pages you changed (based on git changes) and offers to run only those tests.

Comments

More Developer Tools MCP servers

Modelglass

Modelglass turns "which model should I use?" into a lookup instead of a guess. Seven tools give your agent live pricing across image, language, video, and audio models. Sourced and versioned, not scraped once and forgott

Codex Pets

astandrik

Public read-only MCP server for discovering, inspecting, installing, and sharing approved Codex-compatible animated pet packs.

Moxie Docs

Jackalope-Dev

Automated codebase documentation for GitHub: searchable docs, MCP context for AI agents, doc drift detection, and Friday Cleanup PRs.

Eased

easedui

Eased is a library of motion-first React components for shadcn, installed with the shadcn CLI.

Mcp-Warden

ermoluk

Local-first credential broker for MCP. AI coding agents (Claude Code, Cursor, Codex…) call APIs, SSH and databases through scoped presets; secrets stay in your OS keychain and never enter the agent's context.