Connects to Perplexity Comet browser to enable agentic web browsing, deep research, and real-time task monitoring. Provides tools for sending tasks, polling progress, switching modes (search, research, labs, learn), capturing screenshots, and stopping tasks.
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?
Claude Code is powerful, but it can't browse the web autonomously. Comet can browse, research, and execute multi-step web tasks - but it's isolated in a browser.
comet-mcp bridges them. Now Claude can:
Delegate web research to Comet's agentic browser
Monitor browsing progress in real-time
Intervene if tasks go off track
Get comprehensive research reports
Quick Start
1. Configure Claude Code
Add to ~/.claude.json (scope: user) or .mcp.json (scope: project):
Or install globally first:
Then use:
2. Start Comet Browser
Download Perplexity Comet and launch with remote debugging:
3. Use in Claude Code
Tools (6)
Tool | Description |
| Connect to Comet (auto-starts if needed) |
| Send a task to Comet (non-blocking) |
| Check task progress and get results |
| Stop current task if off-track |
| Capture current page |
| Switch modes: search, research, labs, learn |
Modes
Mode | Best For |
| Quick web searches |
| Deep, comprehensive analysis |
| Data visualization & analytics |
| Educational explanations |
Prompting Tips
When sending tasks to Comet via comet_ask, focus on context and goals rather than step-by-step instructions:
Good prompts:
Less effective prompts:
Claude understands the task context; Comet handles the browsing. Let them collaborate - Comet will figure out the best way to navigate and gather information.
Example Workflow
Architecture
Requirements
Node.js 18+
Claude Code (or any MCP-compatible client)
Troubleshooting
"Cannot connect to Comet"
Make sure Comet is running with
--remote-debugging-port=9222Check if port 9222 is available
"Tools not showing in Claude"
Restart Claude Code after config changes
Verify
~/.mcp.jsonsyntax
License
MIT
Built for the Claude Code community.