# Mantis

> Mantis is an open-source MCP server for browser automation. Browser MCP server that gives agents numbered text pages instead of screenshots. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Linux, macOS, Windows
- **Repository:** https://github.com/perzianhq/mantis
- **MCP Registry name:** io.github.perzianhq/mantis
- **Categories:** browser automation
- **Listing updated:** 2026-11-14

## About

Mantis is a lean browser interface built on Playwright that presents web pages to AI agents as short, numbered text rather than screenshots or full accessibility trees. It runs as an MCP server for Claude Code, Codex, Cursor or a custom agent.

The project reports benchmark comparisons against an accessibility-tree approach on public sites, with fewer input tokens, fewer tool calls and less time in its tests. It can also attach to your own Chrome profile, and an ask_human tool handles login and bot walls where a display is available.

It suits developers building agents that read, navigate and fill forms on websites. The project labels itself a small v0.1.x beta.

## Features

- **Numbered text view:** Pages are described as short numbered text that agents can act on.
- **Playwright based:** Built as a lean interface over Playwright.
- **Use your Chrome:** Can attach to a dedicated Chrome profile with your sign-ins.
- **Human handoff:** The ask_human tool covers logins and bot walls.
- **Quick install:** Installs with an npx command and a claude mcp add line.
- **Published benchmarks:** Results versus accessibility tree and screenshot approaches are documented.

## Good for

- Let an agent read and summarise web pages
- Fill web forms through an agent
- Reduce token use in browsing agents
- Work in signed-in tabs of your own Chrome
- Try page reading from the command line

## Install

### Claude Code (Terminal)

```sh
claude mcp add mantis -- npx -y mantis-browser
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mantis": {
      "command": "npx",
      "args": [
        "-y",
        "mantis-browser"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mantis": {
      "command": "npx",
      "args": [
        "-y",
        "mantis-browser"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "mantis": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mantis-browser"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mantis": {
      "command": "npx",
      "args": [
        "-y",
        "mantis-browser"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mantis": {
      "command": "npx",
      "args": [
        "-y",
        "mantis-browser"
      ]
    }
  }
}
```

## Tools

- `ask_human`: Hands a login or bot wall to a person.

## FAQ

### Which agents work with it?

Claude Code, Codex, Cursor or your own agent as an MCP server.

### What are its limits?

No canvas input, and login or bot walls need ask_human, which needs a display.

### What is the license?

MIT.

### Is it production ready?

The project calls itself a small v0.1.x beta.

### Is Mantis free?

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

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

Run this command in your terminal: claude mcp add mantis -- npx -y mantis-browser

### What are the best alternatives to Mantis?

The closest alternatives to Mantis are Browser Use, Scrapling MCP Server, Oya Browser, Auto-building agents and pour.

## Alternatives

- [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.
- [Oya Browser](https://ai-powered.com/mcp/oya-browser): Oya Browser is a freemium MCP server for browser automation.
- [Auto-building agents](https://ai-powered.com/mcp/auto-building-agents): Auto-building agents is a paid MCP server for browser automation.
- [pour](https://ai-powered.com/mcp/pour): pour is an open-source MCP server for developer tools.
- [AgentFarm](https://ai-powered.com/mcp/agentfarm): AgentFarm is a freemium MCP server for browser automation.
- [OpenAdapt: your agent decides, OpenAdapt enters it and checks it saved](https://ai-powered.com/mcp/openadapt-your-agent-decides-openadapt-enters-it-and-checks): OpenAdapt: your agent decides, OpenAdapt enters it and checks it saved is an open-source MCP server for browser automation.
- [Legato](https://ai-powered.com/mcp/legato): Legato is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/mantis-2
