Greenrun MCP Server

Browser test management for Claude Code. Write tests in plain English, and Claude generates and runs Playwright scripts automatically.

Local serverstdioMIT

What is the Greenrun MCP Server?

Greenrun is an MCP project maintained in the add-item-to/greenrun-cli repository. The maintainer describes its purpose as “Browser test management for Claude Code. Write tests in plain English, and Claude generates and runs Playwright scripts automatically”. Read the project documentation for the complete scope.

Installation

The documented npm package is greenrun-cli. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares GREENRUN_API_TOKEN. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
list_projectsList all projects
create_projectCreate a project (with credentials, auth config)
get_projectGet project details
update_projectUpdate project settings
list_pagesList pages in a project
create_pageRegister a page URL
list_testsList tests with latest run status
get_testGet full test details and instructions
create_testCreate a test (with credential_name, tags, pages)
update_testUpdate test (auto-invalidates script on content change)
prepare_test_batchFetch, filter, and start runs for a batch of tests
export_test_scriptWrite a test's cached Playwright script to a local file (keeps scripts out of context)
export_test_instructionsWrite a test's instructions to a local file (keeps instructions out of context)
sweepFind tests affected by specific pages
start_runStart a test run
complete_runRecord a single test result
batch_complete_runsRecord results for multiple test runs in one call
get_runGet run details
list_runsList run history

How to install the Greenrun MCP Server

{
  "mcpServers": {
    "greenrun": {
      "command": "npx",
      "args": [
        "-y",
        "greenrun-cli@latest"
      ],
      "env": {
        "GREENRUN_API_TOKEN": "YOUR_GREENRUN_API_TOKEN"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
GREENRUN_API_TOKENDeclared in the maintainer’s client configuration.Check documentation