Log inSubmit server
Selenium AI Agent logo

Selenium AI Agent

Selenium-based MCP server for parallel browser automation, accessibility discovery, test generation, self-healing, and cross-browser execution.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Selenium AI Agent

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "selenium-ai-agent": {
      "command": "npx",
      "args": [
        "-y",
        "selenium-ai-agent"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Automated check passed— started and listed 61 tools correctly (2d ago).

Overview

selenium-ai-agent connects AI agents to Selenium-managed browser sessions, including Selenium Grid for parallel execution across Chrome, Firefox, and Edge. It provides browser interaction, screenshots, accessibility-tree discovery, exploration and test-plan generation, recorded test generation, and self-healing workflows. Use it for cross-browser testing, large application exploration, or generating WebdriverIO, Playwright, Selenium Python, and Robot Framework tests. The server runs through npx as a standard stdio MCP server and can be configured in several MCP clients.

Use cases

  • Explore multi-page application flows and save test plans
  • Generate WebdriverIO tests from recorded browser interactions
  • Create Playwright tests for browser-based features
  • Generate Selenium Python pytest tests for forms and workflows
  • Run isolated cross-browser sessions through Selenium Grid

Key features

  • Selenium browser control through MCP
  • Accessibility-tree page discovery
  • Screenshot capture and interactive element actions
  • Planner workflow for exploration and test plans
  • Test recording and code generation
  • Parallel Selenium Grid execution

Tools61

What Selenium AI Agent lets your agent do. Expand a tool for its parameters.

Verified live~14.2k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

What it can do

From the 61 tools this server returned when we ran it; 61 declare their own safety hints.

Runs commands · 4Can delete or modify data · 4Handles credentials · 1Makes network requests · 48Read-only tools · 53
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceSigned build
Package age347 days
Maintainers1

Observed 2026-11-07 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 2d ago via OSV.dev · selenium-ai-agent (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars3Stargazers on the source repository.
npm downloads213Package downloads in the last 30 days.
Last commit2mo agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed61Callable tools this server registers over MCP.

How Selenium AI Agent works

What selenium-ai-agent does

selenium-ai-agent exposes Selenium browser automation through MCP tools for AI agents. Its browser controls support actions such as navigating to a URL, entering text, clicking elements, verifying visible text, and capturing screenshots. Accessibility-tree discovery helps agents inspect page structure and identify interactive content during exploration.

The server also supports an agent workflow for planning and test creation. An agent can explore an application, save a test plan as Markdown, record browser interactions, and generate test files. Supported generation targets shown in the project examples include WebdriverIO with TypeScript, Playwright with JavaScript, and Selenium with Python and pytest. Robot Framework is also listed as a supported test-generation target.

How it works

The basic setup starts the MCP process with npx selenium-ai-agent. An MCP client sends browser commands to the server, which opens and controls Selenium browser sessions. A simple interaction can navigate to a page and take a screenshot.

For exploratory testing, the planner workflow initializes a page, captures a snapshot, follows relevant links and flows, records discovered fields and validation behavior, and saves a Markdown test plan. The generator workflow initializes a page for a selected framework, records navigation and interaction steps, then writes the resulting test file.

Selenium Grid provides the parallel execution path. Instead of limiting work to one shared browser context, the server can use separate sessions and distribute activity across Grid nodes. This supports simultaneous exploration and running Chrome, Firefox, and Edge sessions together when the Grid is configured for those browsers.

Setup and configuration

Install the package globally with:

Terminal
npm install -g selenium-ai-agent

Alternatively, run it without a global installation:

Terminal
npx selenium-ai-agent

Configure the MCP client to launch npx selenium-ai-agent over stdio. The project provides installation commands for Claude Desktop, Cursor, and Windsurf:

Terminal
npx selenium-ai-agent install claude-desktop
npx selenium-ai-agent install cursor
npx selenium-ai-agent install windsurf

Claude Code can register it with:

Terminal
claude mcp add selenium-mcp -- npx selenium-ai-agent

Manual JSON examples use the selenium-mcp server name, npx as the command, and selenium-ai-agent as its argument. VS Code MCP configuration uses the same command with a stdio transport type. Generated projects may install their own framework dependencies, such as WebdriverIO, Playwright, Selenium, pytest, or a Python virtual environment.

Tools and capabilities

  • Navigate to web pages and capture screenshots.
  • Interact with forms and page elements using text input, clicks, and visibility checks.
  • Inspect pages through accessibility-tree snapshots.
  • Explore application flows and save Markdown test plans.
  • Record browser sessions and generate WebdriverIO, Playwright, or Selenium Python tests.
  • Run isolated browser sessions in parallel through Selenium Grid.
  • Support cross-browser execution with Chrome, Firefox, and Edge when available in the Grid.

Limitations and notes

Parallel execution depends on a configured Selenium Grid and available browser nodes; the basic local setup launches the MCP process but does not by itself describe a Grid deployment. Generated tests can initialize project files and install framework dependencies, so those operations may modify the working directory and require the relevant package managers. Test plans should be reviewed before generating test code, especially when exploration covers application-specific flows and validation behavior.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Selenium AI Agent

selenium-ai-agent is an MCP server that connects AI agents to Selenium browser sessions and Selenium Grid. Its main tools support navigation, screenshots, page interaction, accessibility discovery, application exploration, test-plan creation, session recording, and test generation for WebdriverIO, Playwright, and Selenium Python workflows.

Install it globally with `npm install -g selenium-ai-agent`, or run it directly with `npx selenium-ai-agent`. Then configure your MCP client to launch `npx` with `selenium-ai-agent` as its argument.

Yes, selenium-ai-agent works with Cursor. Run `npx selenium-ai-agent install cursor` for automatic setup, or add a stdio MCP server that runs `npx selenium-ai-agent` to Cursor's MCP configuration.

Yes, parallel execution is supported through Selenium Grid. The server can use separate sessions across Grid nodes and run Chrome, Firefox, and Edge simultaneously when those browser nodes are available.

selenium-ai-agent can generate WebdriverIO TypeScript, Playwright JavaScript, and Selenium Python pytest tests. The project also lists Robot Framework as a supported generation target.

Related MCP servers

All in Browser Automation All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewSelenium AI Agent AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/selenium-ai-agent?style=directory)](https://allmcps.com/mcp/selenium-ai-agent)
HTML Embed
<a href="https://allmcps.com/mcp/selenium-ai-agent"><img src="https://allmcps.com/api/badge/selenium-ai-agent?style=directory" alt="Selenium AI Agent on AllMCPs" /></a>