hanzili/comet-mcp

**Give Claude Code a browser that thinks.**
An MCP server that connects Claude Code to Perplexity Comet - enabling agentic web browsing, deep research, and real-time task monitoring.
Why?
Existing web tools for Claude Code fall into two categories, both with limitations:
1. Search APIs (Tavily, Perplexity API, WebFetch)
Return static text. No interaction, no login, no dynamic content. Great for quick lookups, but can't navigate complex sites or fill forms.
2. Browser Automation (browser-use, Puppeteer MCP, Playwright MCP)
Can interact with pages, but use a **one-agent-do-all** approach: the same reasoning model that's writing your code is also deciding where to click, what to type, and how to navigate. This overwhelms the context window and fragments focus.
3. Comet MCP: Multi-Agent Delegation
**Comet MCP takes a different approach.** Instead of Claude controlling a browser directly, it delegates to Perplexity Comet - an AI purpose-built for web research and browsing.
- **Claude** stays focused on your coding task
- **Comet** handles the browsing: navigation, login walls, dynamic content, deep research
- **Result**: Claude's coding intelligence + Perplexity's web intelligence, working together
Quick Start
1. Configure Claude Code
Add to ~/.claude.json or .mcp.json:
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
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 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):
2. **Restart WSL**:
3. **That's it!** Comet MCP auto-detects WSL and uses PowerShell to communicate with Windows.