Skip to main content
Glama

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

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

Or install globally first:

npm install -g comet-mcp

Then use:

{ "mcpServers": { "comet-bridge": { "command": "comet-mcp" } } }

2. Start Comet Browser

Download Perplexity Comet and launch with remote debugging:

# macOS /Applications/Comet.app/Contents/MacOS/Comet --remote-debugging-port=9222

3. Use in Claude Code

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

Tools (6)

Tool

Description

comet_connect

Connect to Comet (auto-starts if needed)

comet_ask

Send a task to Comet (non-blocking)

comet_poll

Check task progress and get results

comet_stop

Stop current task if off-track

comet_screenshot

Capture current page

comet_mode

Switch modes: search, research, labs, learn

Modes

Mode

Best For

search

Quick web searches

research

Deep, comprehensive analysis

labs

Data visualization & analytics

learn

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:

"I need to find the best React state management libraries for a large-scale app. Compare their bundle sizes, learning curves, and community support." "Help me understand how Stripe's pricing API works. I'm building a SaaS and need to implement usage-based billing."

Less effective prompts:

"Go to google.com, search for React state management, click the first result..."

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

# Claude Code conversation You: Find the top 3 trending Python repos on GitHub Claude: I'll use Comet to browse GitHub directly. [comet_connect] → Connected to Perplexity [comet_mode research] → Switched to research mode [comet_ask "Find top 3 trending Python repos on GitHub today with their star counts"] → Task sent [comet_poll] → Status: WORKING, Navigating to github.com/trending... [comet_poll] → Status: WORKING, Filtering by Python... [comet_poll] → Status: COMPLETED Results: 1. project-a - 2.3k stars today 2. project-b - 1.8k stars today 3. project-c - 1.2k stars today

Architecture

Claude Code ←→ MCP Protocol ←→ comet-mcp ←→ Chrome DevTools Protocol ←→ Comet Browser ↓ Perplexity AI (agentic browsing)

Requirements

Troubleshooting

"Cannot connect to Comet"

  • Make sure Comet is running with --remote-debugging-port=9222

  • Check if port 9222 is available

"Tools not showing in Claude"

  • Restart Claude Code after config changes

  • Verify ~/.mcp.json syntax

License

MIT


Built for the Claude Code community.

Report Issues · Contribute

-
security - not tested
A
license - permissive license
-
quality - not tested

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