Autopilot MCP Server

MCP server that exposes Autopilot to Claude Code via stdio. Claude Code gets 6 tools: navigate, screenshot, accessibility inspection, JS execution, page text, and wait helpers.

Quick install (local, before npm publish)

cd /path/to/autopilot/mcp-server
npm install

Once published: npm install -g @memjar/autopilot-mcp

Claude Code config

Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "autopilot": {
      "command": "node",
      "args": ["/path/to/autopilot/mcp-server/index.js"]
    }
  }
}

Replace /path/to/autopilot with your actual path (e.g. /Users/mike/Desktop/autopilot).

With autostart (browser launches automatically on first tool call)

{
  "mcpServers": {
    "autopilot": {
      "command": "node",
      "args": ["/path/to/autopilot/mcp-server/index.js"],
      "env": {
        "AXE_BROWSER_AUTOSTART": "1"
      }
    }
  }
}

Start Autopilot manually (recommended)

cd /path/to/autopilot
AXE_HEADLESS=1 npm start

The browser API listens on http://127.0.0.1:9333. Custom port: set AXE_BROWSER_PORT.

Available tools

| Tool | What it does | |------|-------------| | ax_navigate | Navigate to a URL | | ax_screenshot | Capture a PNG of the current page | | ax_accessibility | Get interactive elements (role, name, rect) | | ax_execute | Run JavaScript in the active tab | | ax_wait | Sleep N milliseconds (for page settle) | | ax_text | Read visible page text (or a CSS selector) |

Example prompts for Claude Code

Use ax_navigate to open https://crown.axe.observer, wait 2 seconds, then screenshot it.

Navigate to https://atlas.axe.observer, use ax_accessibility to list all buttons, then ax_text to read the main heading.

Use ax_navigate to go to http://localhost:3000, ax_execute with js="document.querySelector('h1')?.innerText" to check the heading, then ax_screenshot to save a visual record.

Test the MCP server

# Check tool list
echo '{"jsonrpc":"2.0","method":"tools/list","id":1}' | node index.js

# Navigate (Autopilot must be running)
echo '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"ax_navigate","arguments":{"url":"https://example.com"}},"id":2}' | node index.js

Environment variables

| Variable | Default | Purpose | |----------|---------|---------| | AXE_BROWSER_PORT | 9333 | Port Autopilot is listening on | | AXE_BROWSER_AUTOSTART | 0 | Set to 1 to auto-spawn Autopilot on first call |