# MCP

> MCP is an open-source MCP server for browser automation. Give coding agents ranked, graded locators from a live page for browser tests. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/kushshah12/cor-mcp
- **MCP Registry name:** dev.corlabs/mcp
- **Categories:** [browser automation](https://ai-powered.com/categories/browser-automation), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

COR drives a real browser so an agent can look at a page before it writes a test. It opens the page, lists the controls with references, and then returns locators for the elements you name, ranked and graded, in the syntax of the framework it infers from your repo: Playwright, Cypress or WebdriverIO. Each recommendation comes as an entry to paste into your locator file, carrying a short id comment that later checks rely on.

Two tools keep locators honest over time. cor_check fails any locator in your files that did not come from COR, and cor_heal proposes a repair when a locator stops matching. The README advises using COR instead of Playwright MCP for test authoring, since a second browser server tempts an agent to type its own selectors.

COR writes small records to .cor/records in your project so repairs work on a teammate's machine or in CI; input values, cookies and storage are never stored, and emails, long digit runs and tokens are masked. The server sends anonymous usage metrics (tool name, duration, outcome, versions), which it describes in the README, and records can be turned off with --no-records.

## Features

- **Ranked, graded locators:** Returns several locators per element with a quality grade.
- **Framework-aware output:** Infers Playwright, Cypress or WebdriverIO and your locator store style.
- **Locator check:** cor_check fails locators in your files that did not come from COR.
- **Self-grading:** cor_grade scores a locator you wrote yourself.
- **Locator repair:** cor_heal proposes a fix for a locator that stopped matching.
- **Browser actions:** Click, fill and press, reporting what changed on the page.

## Good for

- Author Playwright tests with stable locators
- Repair broken selectors after a UI change
- Enforce that all locators in a repo are generated and graded
- Write page-object locators for a login form

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp -- npx -y @corlabsdev/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@corlabsdev/mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@corlabsdev/mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@corlabsdev/mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@corlabsdev/mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@corlabsdev/mcp"
      ]
    }
  }
}
```

## Tools

- `cor_open`: Open a page and list its controls with refs
- `cor_snapshot`: Text, controls and entries within one region of a large page
- `cor_inspect`: Ranked, graded locators for the elements you name
- `cor_click`: Click on the page and report what changed
- `cor_fill`: Fill a field and report what changed
- `cor_press`: Press a key and report what changed
- `cor_check`: Fail any locator in your files that did not come from COR
- `cor_grade`: Score a locator you wrote yourself
- `cor_heal`: Propose a repair for a locator that stopped matching
- `cor_close`: Close the browser

## FAQ

### What does it need?

Node 18+ and Google Chrome, Microsoft Edge or Playwright's Chromium.

### Which test frameworks are supported?

Playwright, Cypress and WebdriverIO, set through cor.config.js or inferred.

### Does it edit my files?

No. The agent places each entry; COR only writes records under .cor/records.

### Can I turn off the records?

Yes, use --no-records or set COR_RECORDS=off.

### Is MCP free?

Yes. MCP is open source, so you can use and self-host it for free.

### How do I add MCP to Claude Code?

Run this command in your terminal: claude mcp add mcp -- npx -y @corlabsdev/mcp

### What are the best alternatives to MCP?

The closest alternatives to MCP are REA, Browser Use, Scrapling MCP Server, Context7 and Chrome DevTools MCP.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Browser Use](https://ai-powered.com/mcp/browser-use): Browser Use is a freemium MCP server for browser automation.
- [Scrapling MCP Server](https://ai-powered.com/mcp/scrapling-mcp-server): Scrapling MCP Server is an open-source MCP server for web search and scraping.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/mcp-mwenjepj
