What can you do with this server?

Comet MCP connects Claude to Perplexity Comet for agentic web browsing and deep research, enabling intelligent task delegation in an isolated environment. * Agentic Web Research - Delegate complex web tasks like navigation, login flows, form filling, and dynamic content interaction to Perplexity AI, while Claude stays focused on coding * Browser Connection - Connects to a dedicated, isolated Comet browser instance (port 9223) that auto-starts and runs separately from your personal browser * Task Management - Initiate tasks with comet_ask, monitor progress with comet_poll, and stop running tasks with comet_stop if they deviate from goals * Mode Switching - Change Perplexity's operational mode using comet_mode: 'search' (basic), 'research' (deep), 'labs' (analytics/visualization), or 'learn' (educational) * Research Organization - List, create, and save current research to organized folders/spaces within Perplexity using comet_folders * Library Search - Query your Perplexity research history with comet_library to find and reference past research threads * Visual Context - Capture screenshots of the current web page with comet_screenshot for visual verification * Complete Results - Retrieve full research responses without truncation, with first-time login guidance for Perplexity sign-in

Which integrations are available for this server?

Connects to Perplexity Comet to enable agentic web browsing, deep research, and real-time task monitoring. The server allows agents to delegate complex browsing tasks, navigate dynamic websites, manage research folders, and search through Perplexity research history.

How do I use comet-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@comet-mcp research the top AI frameworks in 2025 and summarize the findings" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

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

What's New in v3.0

Isolated MCP Instance - Uses a dedicated Comet browser (port 9223) - your personal tabs are never touched
Full Research Text - Fixed truncation issue, now returns complete research responses
Reliable Startup - Auto-retry logic, kills stale processes, extended timeouts
Login Detection - First-time setup prompts for Perplexity sign-in
Visual Indicator - MCP Comet shows "[MCP]" badge so you know which browser is which
Research Spaces - Save and organize research into spaces
Library Search - Search your existing Perplexity research history

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

Installation (3 Steps)

Step 1: Install Comet Browser

Download: https://www.perplexity.ai/comet

Step 2: Add to Claude Code

Add to ~/.claude.json:

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

Step 3: macOS Setup (One-time)

Run the setup script to create an isolated MCP browser:

curl -sL https://raw.githubusercontent.com/hanzili/comet-mcp/main/scripts/setup-macos.sh | bash

MCP_APP="$HOME/.comet-mcp/Comet-MCP.app" mkdir -p "$HOME/.comet-mcp" cp -R "/Applications/Comet.app" "$MCP_APP" /usr/libexec/PlistBuddy -c "Set :CFBundleIdentifier ai.perplexity.comet.mcp" "$MCP_APP/Contents/Info.plist" codesign --force --deep --sign - "$MCP_APP"

First Use

Restart Claude Code
Say: "Connect to Comet"
Login to Perplexity in the MCP window (first time only)
Done!

Verify Installation

To verify the MCP server is working:

npx comet-mcp --help

Or check Claude Code recognizes the tools:

You: "What Comet tools do you have?" Claude: [lists comet_connect, comet_ask, comet_poll, etc.]

Try It

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] You: "Save this research to my 'AI Projects' space" Claude: [uses comet_folders to organize research into spaces]

Tools

Tool	Description
`comet_connect`	Connect to MCP-dedicated Comet (auto-starts, isolated from personal browser)
`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
`comet_folders`	List, create, or save to research spaces
`comet_library`	Search your existing Perplexity research

Skills (Claude Code)

Comet MCP includes a bundled Skill that teaches Claude how to use the tools effectively.

Install Skill (Optional)

Download and install the skill to your personal skills directory:

mkdir -p ~/.claude/skills curl -sL https://raw.githubusercontent.com/hanzili/comet-mcp/main/skills/comet-research/SKILL.md \ -o ~/.claude/skills/comet-research.md

Or if you cloned the repo:

mkdir -p ~/.claude/skills cp -r skills/comet-research ~/.claude/skills/

What the Skill Does

The comet-research skill:

Teaches Claude when to use each tool
Provides mode selection guidance (search vs research vs labs)
Includes best practices and error handling
Formats research output with citations

Trigger Phrases

The skill activates when you say things like:

"Research the latest..."
"Look up information about..."
"Find out what..."
"What's the current news on..."

Manual Invocation

You can also invoke directly:

/comet-research [your research topic]

How It Works

Claude Code → MCP Server → CDP (port 9223) → MCP Comet → Perplexity AI (reasoning) (bridge) (isolated) (web browsing)

Port 9223: MCP uses its own port, never touches your personal Comet (9222)
Separate Profile: Data stored in ~/.comet-mcp, completely isolated
Visual Badge: MCP Comet shows "[MCP]" indicator so you know which is which

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+ (LTS recommended)
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:

Enable mirrored networking (one-time setup):
# Create/edit %USERPROFILE%\.wslconfig (Windows side) [wsl2] networkingMode=mirrored
Restart WSL:
wsl --shutdown # Then reopen your WSL terminal
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 and you've run the one-time setup to create ~/.comet-mcp/Comet-MCP.app
Windows: Comet should be in %LOCALAPPDATA%\Perplexity\Comet\Application\
MCP uses port 9223 (not 9222) - check if available

"MCP Comet closes my personal Comet" (macOS)

You need to create the separate app bundle first (see "macOS: Create Isolated App Bundle" above)
Without this, Electron's single-instance lock will replace your personal browser

"Not logged in" message

Log into Perplexity in the MCP Comet browser window (the one with [MCP] badge)
Then call comet_connect again

"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

"Research text is truncated"

Upgrade to v3.0.0 - this issue is fixed
Use comet_poll for long research to get full results

License

MIT

Report Issues · Contribute

Install Server

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

How are these scores calculated?

Resources

Need Help?

Report Issue

Related Servers

comet-mcp

comet-mcp

What's New in v3.0

Why?

1. Search APIs (Tavily, Perplexity API, WebFetch)

2. Browser Automation (browser-use, Puppeteer MCP, Playwright MCP)

3. Comet MCP: Multi-Agent Delegation

Installation (3 Steps)

Step 1: Install Comet Browser

Step 2: Add to Claude Code

Step 3: macOS Setup (One-time)

First Use

Verify Installation

Try It

Tools

Skills (Claude Code)

Install Skill (Optional)

What the Skill Does

Trigger Phrases

Manual Invocation

How It Works

Requirements

Windows & WSL Support

Native Windows

WSL2 (Windows Subsystem for Linux)

Custom Comet Path

Troubleshooting

License

Resources

Tools

New MCP Servers

Latest Blog Posts

MCP directory API