# Automation

Polypane Automation lets AI agents control and get feedback from Polypane using its built-in MCP server. Connect Claude Code, Cursor, Codex, Copilot or any other supported AI tool to Polypane and let it interact with your projects.

With it, your agent gets access to all of Polypane's panes, emulation settings, and built-in checks, allowing it to interact with your projects in the same way you do, and getting the same feedback while it works so it can fix issues accurately and efficiently as they appear.

> **About Polypane and AI**: Polypane has no built-in AI features, and we don't plan to add any. But Polypane is for every developer, whatever their workflow, and for many developers that workflow now includes AI tools. Automation lets those tools work with Polypane in a controlled and transparent way. It doesn't replace your agent or add another one: the agent you already use keeps its context, instructions, skills and processes, and gets Polypane on top.

The MCP server is also available as a command line interface, so it can also be used to drive Polypane with deterministic tooling.

## What Automation does

The AI interacts with your project through Polypane's Automation API. It can read the state of your panes, check for accessibility issues, inspect elements, and make changes to the DOM and CSS. It performs actions like clicking, typing, and scrolling, and it receives feedback from the environment while it works, including visual changes, console messages, and panel results.

While your AI controls Polypane, Polypane keeps track of what happens to your pages, just like it already does in the UI. Things like horizontal overflows, console errors, network issues and more are sent along with the feedback the AI receives, ensuring it has a complete picture of the page's state.

## You stay in control

We think the developer should always remain in control of their workflow, even when using AI tools to automate tasks within Polypane, so our automation is centered around that.

The Agent drives the app through the Automation API. Anything it does is directly visible to you as well as in an action log. This gives you full control and ensures full transparency of the automation process. It shows directly which tools are driving it (which can be multiple at once) and what actions they are performing.

You can pause or stop access at any time. Sensitive info like password fields, auth headers and httpOnly cookies are kept from agents. Risky actions require your confirmation from inside Polypane.

## Turning Automation on

Automation is off by default.

Open the **Settings** menu in the top right of the application, go to the **Automation** tab and toggle **MCP server**. If the MCP is running, a star icon is visible on the settings icon.

![Polypane settings menu with Automation tab](/static/settings-e36f2106780c30d25bbd22c2a2292e20.png)

In the settings menu click **Connect an AI tool** to open the overview and install the MCP server for your chosen AI tool.

![Polypane connect an AI tool dialog](/static/connect-40f9c1ea9fd6cfa6e7b7b928284a5d42.png)

The connection dialog lists all the AI tools Polypane has direct support for. For the apps we can detect we check if they're installed on your device. Pick yours and follow the instructions to install the MCP server for it.

### Supported tools

Polypane has one-click installations or setup instructions for the following AI tools:

*   Antigravity
*   Claude Code
*   Claude Desktop
*   Cline / Roo Code
*   Codex
*   Cursor
*   Devin Desktop
*   Gemini CLI
*   JetBrains IDEs
*   Oh my pi/omp
*   OpenCode
*   VS Code (GitHub Copilot)
*   Zed

Here you can also find generic MCP server setup instructions for AI tools that are not listed above. If your tool is not listed, [reach out](/support/) so we can add automated support for it.

Depending on the specific tool it picks up the new configuration automatically or needs a restart. From there on, the AI tool can communicate with Polypane through the MCP server.

### The Polypane agent skill

Polypane also installs an agent skill: instructions that teach the agent how to work with Polypane well. All AI tools that support auto-installing will get this automatically installed, other tools have an 'add skill' option in the manual setup.

It covers a development loop to make sure you use Polypane effectively and token-efficiently, checking every pane, reading notices and working with checklists. Other AI tools get a shorter version of the same guidance when they connect.

## Things to ask

You can ask your agent to do single things in Polypane:

*   "Open localhost:3000 in Polypane"
*   "Add an iPhone 12 pane"
*   "Get a screenshot from the tab"
*   "What is the heading structure on this page?"

But the MCP also supports more complex tasks by having the Agent combine multiple actions and checks in Polypane:

*   "Open localhost:3000 in Polypane and fix any accessibility issues the report finds."
*   "Create a new project for my website and switch to it. The production url is \_\_\_ and the staging url is \_\_\_."
*   "The header overlaps the content on small screens. Find out why in Polypane and fix it."
*   "Compare the pricing page to production in Polypane."
*   "Check the social media previews of this page."

## Working alongside your agent

The core principle for Polypane's automation is that you and the AI agent both use Polypane together. Anything you do is visible to the agent, and anything the agent does is visible to you. The developer has full control over the actions taken within Polypane.

This means that you as a developer remain firmly in control of the workflow, deciding when and how the AI agent can interact with your project. You can intervene at any point, pause or stop the agent, and make changes directly within Polypane without losing synchronization with the AI tool.

### The automation bar

While an AI tool is connected, a bar at the bottom of the window shows which tools control Polypane and what they're doing right now.

The icon on its left opens an activity log of recent actions so you can see what happened, as well as any errors that occurred.

![Polypane automation bar](/static/automationbar-619d25cdb23f3ca6f145508044942dc2.png)

The bar lets you _Pause_ to hold every new action until you click _Resume_. This lets you change Polypane before the agent continues with its tasks. The agent waits up to 2 minutes, after which the calls return as failed until you resume.

_Stop_ ends all sessions, and the AI tool has to restart its Polypane server before it can control Polypane again.

When the agent needs your help, for example by logging in, filling in a captcha or providing other input, the bar will turn orange and display a message asking you to take the required action.

You can perform the action and inform the agent by pressing the 'done' button on the bar, or press the 'skip' button to tell the agent you skipped the action.

### The working tab

Each AI tool works in a single tab: the one it opened or switched to, or the tab that was active when it started.

![Polypane tab with a star on its favicon](data:image/png;base64,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)

That tab shows a small star on its favicon, which animates while the agent is busy in it so you know that it is currently being used by the AI tool.

If you change the agent's tab while it works, like navigating, resizing a pane or changing emulation, the next MCP response will update the agent with the changes made to the tab so it is never out of date.

Anything the agent does is applied and stays applied in the application.

## Permissions

Most of the actions an agent takes in Polypane run without asking for permission, so you have a smooth experience while using the tool.

Risky actions require your explicit consent:

*   Running JavaScript in a page or in Polypane's own window (the script is shown for you to check).
*   Running a JavaScript snippet.
*   Clicking in Polypane's own interface.
*   Turning off CORS, CSP or web security.
*   Calling a site's WebMCP tool that the site marks as _consequential_.

These actions will prompt you for permission before they are executed. You can check "Remember my choice". For scripts and clicks in Polypane's interface that applies to every future script or click, not only the one shown. For a WebMCP tool it applies to that site only.

The Automation tab in the Settings menu lists your remembered answers and allows you to forget previously made choices.

When you decline, the agent is told not to retry without asking you.

## Security and privacy

*   Automation is **off by default**, and only programs running as your user on your computer can connect. It's driven directly through stdio on your device, so we don't open a network port.
*   It **never types into password or one-time-code fields**, and won't fill or submit forms that contain them. Agents are told to ask you to log in yourself.
*   It **hides cookie and authorization headers** in network details, and password and token fields in request bodies. HttpOnly cookie values are hidden too. Other cookies, localStorage and sessionStorage are shown as stored, login tokens included, like the [Storage panel](/docs/storage-panel/) shows them.
*   It **leaves dialogs to you**: anything that asks for confirmation (like deleting a project or a page's confirm dialog) is not available to the agent and must be handled by you.

## Tools

Polypane Automation offers 30 tools that span the gamut of what Polypane offers. Your AI tool will automatically read them and use them as needed, so the tables below are here for reference.

### Where the agent is

| Tool | What it does |
| --- | --- |
| `get_state` | The projects, the tabs of the current project, which tab the agent works in, and the element you selected in the Elements panel. |
| `projects` | Lists, finds, creates, switches and updates [projects](/docs/projects/), and loads the same page on another environment (like production) to compare. |
| `tabs` | Lists, opens, duplicates, switches, moves and closes tabs, optionally in a specific layout and device. |
| `navigate` | Goes to a URL, back, forward, reloads, or reloads only the CSS. |
| `wait_for` | Waits for text, an element, a URL, the page to load or go idle, or for your dev server to change the page. |
| `panes` | Lists, adds (by device), removes and moves panes, and creates panes from the breakpoints in the page's CSS. |
| `pane_settings` | Reads and changes a pane's emulation: size, device, color scheme, reduced motion, network speed, locale, rulers, a reference image and more. |

### Reading the page

| Tool | What it does |
| --- | --- |
| `take_snapshot` | The page as an accessibility tree (with ids to interact with), as Markdown, as HTML (rendered or as the server sent it), or as one of the Outline panel's lists with its issues. |
| `element_info` | What the Elements panel shows for an element, or for the element you selected: box model, matching CSS rules with stylesheet and line, accessibility properties and contrast. |
| `find_elements` | Polypane's [Find HTML in page](/docs/find-elements/): which elements match a CSS selector, and in which panes they're visible. |
| `screenshot` | Screenshots of one pane, every pane, the full page, an element or a social preview. |
| `record` | A video [recording](/docs/recording/) of a pane. |
| `console_logs` | The Console panel's messages, per pane. |
| `network_requests` | The Network panel's requests and their details, and fetching other URLs of the same site (like `robots.txt`). |
| `storage` | Reads and changes localStorage, sessionStorage and cookies. |

### Checking the page

| Tool | What it does |
| --- | --- |
| `run_report` | Runs Polypane's checks on every pane and returns one list of findings, most severe first. |
| `a11y_audit` | The Accessibility panel's audit, per pane. |
| `overflow_check` | Which elements cause [horizontal overflow](/docs/horizontal-overflow/), per pane. |
| `webmcp` | Lists, checks and calls the page's WebMCP tools: what a site offers agents. |

### Changing the page

| Tool | What it does |
| --- | --- |
| `interact` | Clicks, types, fills fields, presses keys, hovers and scrolls, like a user. |
| `fill_form` | Fills a whole form with Polypane's [form autofill](/docs/form-autofill/) test data. |
| `edit_element` | Changes an element's styles, classes, attributes, text or HTML through the Elements panel. |
| `live_css` | Adds CSS to every pane as a snippet you can see and switch off. |
| `get_changes` | The agent's edits, as CSS per rule and HTML per element, to put in the source files. |
| `live_reload` | Sets up [live reloading](/docs/live-auto-reloading/) for a folder. |
| `evaluate` | Runs JavaScript in a pane (asks you first). |

### Polypane itself

| Tool | What it does |
| --- | --- |
| `list_commands` | Searches the [command bar](/docs/command-bar/)'s commands. |
| `run_command` | Runs a command bar command. |
| `polypane_ui` | Reads and, after asking you, clicks Polypane's own interface, for what the other tools don't cover. |
| `notices` | What Polypane noticed on its own in the agent's tab. |

## Automation outside of AI tooling

Because of the way we set up our automation, you can use the tools directly from scripts and the command line, without going through an AI tool. This allows for integration into your own workflows and automation pipelines.

### Command line

You can use the CLI to interact with Polypane Automation directly as well as get information on the available tools.

```bash
polypane --mcp help
polypane --mcp help run_report
polypane --mcp call get_state
polypane --mcp call run_report '{"checks": ["a11y", "headings"]}'
```

`help` lists the tools, and with a tool name gives its description and arguments. `call` prints the result as JSON and exits with 1 when the tool returns an error.

Calls from the same folder share a session for 24 hours, so the working tab and notices carry over. Use `--new-session` to start a fresh one.

See [command line options](/docs/command-line-options/) for the path to Polypane on your platform.

### From Node scripts

Using the MCP SDK you can call Polypane Automation tools directly from Node, TypeScript or other JS tooling.

```js
import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';

const client = new Client({ name: 'my-script', version: '1.0.0' });
await client.connect(new StdioClientTransport({ command: 'polypane', args: ['--mcp'] }));

const report = await client.callTool({ name: 'run_report', arguments: { checks: ['a11y'] } });
console.log(report.structuredContent.result.summary);

await client.close();
```

Every tool returns structured data, so scripts can use the results directly.

## Troubleshooting connection issues

While calling the MCP server from the command line or an AI tool, you might encounter errors or unexpected behavior. The following sections cover common problems and their solutions.

### The AI tool says the server failed or timed out

Check the Automation tab in the Settings menu. It says whether the MCP server is running, and shows the error if it can't be started. If it does not restart after toggling the switch, [contact us](/support/).

### New tools don't show up after updating Polypane

AI tools cache the list of tools. Restart the Polypane MCP connection in your AI tool, or start a new session.

### Every action fails with "Stopped from Polypane"

You pressed _Stop_. Restart the Polypane server in your AI tool to connect again.

### The agent calls tools that don't exist

LLMs are not _smart_, and especially in long sessions they might very well come up with tools that don't exist. If this happens, start a new AI chat session, ask it to load in the tools again and, if it's a particularly good tool that you would like to have, [tell us about it](/support/).

### Platform specifics

*   **WSL on Windows**: an agent running inside WSL can't reach Polypane on Windows. Run the agent on the Windows side.
*   **No output from the command line on Windows**: pipe it, like `polypane --mcp help | more`.

---

Polypane is the browser for web developers. Try it at https://polypane.app.
