Skip to main content
Glama

comet-mcp

npm version

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:

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:

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

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

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/hanzili/comet-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server