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.

!Demo

Why?

Existing web tools for Claude Code fall into two categories, both with limitations:

$3

Return static text. No interaction, no login, no dynamic content. Great for quick lookups, but can't navigate complex sites or fill forms.

$3

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 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

$3

Add to ~/.claude.json or .mcp.json:

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

$3

Download and install Perplexity Comet.

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

$3

`
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

$3

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

$3

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:
`bash
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.

$3


If Comet is installed in a non-standard location:
`json
{
"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