{
  "mcpServers": {
    "comet-bridge": {
      "command": "npx",
      "args": ["-y", "comet-mcp"]
    }
  }
}

2. Install Comet Browser

Download and install Perplexity Comet.

That's it! The MCP server automatically launches Comet with remote debugging when needed.

3. Use in Claude Code

You: "Use Comet to research the top AI frameworks in 2025"
Claude: [delegates to Comet, monitors progress, returns results]

You: "Log into my GitHub and check my notifications"
Claude: [Comet handles the login flow and navigation]

Tools

| Tool | Description | |------|-------------| | comet_connect | Connect to Comet (auto-starts if needed) | | comet_ask | Send a task and wait for response | | comet_poll | Check progress on long-running tasks | | comet_stop | Stop current task | | comet_screenshot | Capture current page | | comet_mode | Switch modes: search, research, labs, learn |

How It Works

Claude Code  →  MCP Server  →  CDP  →  Comet Browser  →  Perplexity AI
   (reasoning)     (bridge)                              (web browsing)

Claude sends high-level goals ("research X", "log into Y"). Comet figures out the clicks, scrolls, and searches. Results flow back to Claude.

Requirements

• Node.js 18+
• Perplexity Comet Browser
• Claude Code (or any MCP client)
• Supported platforms: macOS, Windows, WSL2

Windows & WSL Support

Native Windows

Works out of the box. Comet MCP auto-detects Windows and launches Comet from its default install location.

WSL2 (Windows Subsystem for Linux)

WSL2 requires mirrored networking to connect to Comet running on Windows:

1. Enable mirrored networking (one-time setup):

   # Create/edit %USERPROFILE%\.wslconfig (Windows side)
   [wsl2]
   networkingMode=mirrored
   

2. Restart WSL:

   wsl --shutdown
   # Then reopen your WSL terminal
   

3. That's it! Comet MCP auto-detects WSL and uses PowerShell to communicate with Windows.

If mirrored networking isn't available, you'll see a helpful error message with setup instructions.

Custom Comet Path

If Comet is installed in a non-standard location:

{
  "mcpServers": {
    "comet-bridge": {
      "command": "npx",
      "args": ["-y", "comet-mcp"],
      "env": {
        "COMET_PATH": "/path/to/your/Comet"
      }
    }
  }
}

Troubleshooting

"Cannot connect to Comet"

• macOS: Ensure Comet is installed at /Applications/Comet.app
• Windows: Comet should be in %LOCALAPPDATA%\Perplexity\Comet\Application\
• Check if port 9222 is available

"WSL cannot connect to Windows localhost"

• Enable mirrored networking (see WSL section above)
• Or run Claude Code from Windows PowerShell instead of WSL

"Tools not showing in Claude"

• Restart Claude Code after config changes

License

MIT

Report Issues · Contribute