# Deputy

> Deputy is a freemium MCP server for browser automation. Turns any web page's forms into typed tool calls run in your own logged-in Chrome. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9.99 a month
- **Platforms:** Chrome extension, CLI, API, macOS, Windows, Linux
- **Website:** https://razin.ai/deputy
- **MCP Registry name:** io.github.zraisan/deputy
- **Categories:** browser automation
- **Listing updated:** 2026-11-15

## About

Deputy is a Chrome extension paired with an npm MCP server. Instead of having your agent drive a browser through screenshots, the agent asks Deputy, which returns a typed API for the current page and performs the call in your real, logged-in session. No cookies are copied, and on forms that change something it asks before submitting when the client supports that.

It builds on WebMCP, a standard shipping in Chromium that lets a page declare forms as tools. Deputy adds the needed attributes to the page's own form and lets the browser generate the schema. Where there is no form it derives tools from ARIA widgets. The maker's own benchmark, filtering 400 orders on an admin page, reports 72,632 Claude tokens with Deputy against 245,250 with Playwright MCP.

The free tier gives 10 tools with no key. Pro is $9.99 a month or $95.99 a year and adds 17 more tools plus hosted models. Known limits include synthetic clicks that heavy editors like Google Docs may ignore, and no reading of scanned PDFs. Node.js 20 or later is required.

## Features

- **Forms as typed tools:** One call fills a form in your own browser session.
- **ARIA fallback:** Builds tools from radio groups, listboxes and checkboxes when no form exists.
- **Asks before submitting:** Confirms changes if the client can ask; otherwise stops at submit.
- **Free and Pro tiers:** 10 tools free; 27 with Pro and hosted models.
- **Works with many clients:** Claude Code, Codex, Cursor, Gemini CLI, Copilot CLI, VS Code and more.

## Good for

- Fill a booking or order form with one agent call
- Filter and count rows on a busy admin page
- Read a page in your logged-in session without a separate browser
- Reduce token use compared with screenshot-driven browsing

## Install

### Claude Code (Terminal)

```sh
claude mcp add deputy -- npx -y deputy-mcp
```

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## Tools

- `browser_navigate`: Opens pages.
- `browser_invoke`: Calls a page's form or declared tool in one step.
- `browser_act`: Clicks and fills page elements.
- `browser_find`: Finds elements on a page.
- `browser_read`: Reads page content.
- `browser_ask`: Answers a question about a page.
- `browser_screenshot`: Captures a screenshot.

## FAQ

### How much does it cost?

Free to start with 10 tools and no key. Pro is $9.99 a month or $95.99 a year, with a full refund within 14 days.

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

Install the Chrome extension, then run claude mcp add deputy -- npx -y deputy-mcp.

### What licence is the open-source version?

PolyForm Shield License 1.0.0.

### What can't it do?

Heavy editors such as Google Docs may ignore its synthetic clicks, and scanned PDFs have no text layer to read.

### Is Deputy free?

Deputy has a free plan, with paid plans for more usage or features. Paid plans start at $9.99 a month.

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

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

### What are the best alternatives to Deputy?

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

## 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.
- [Mantis](https://ai-powered.com/mcp/mantis-2): Mantis is an open-source 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.

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