Which integrations are available for this server?

Connects to [Perplexity](/mcp/servers/integrations/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](https://glama.ai/blog/2025-07-08-how-to-install-and-use-mcp-servers).

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 Folders - Save and organize research into folders
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!

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' folder" Claude: [uses comet_folders to organize research]

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, learn
`comet_folders`	List, create, or save to research folders
`comet_library`	Search your existing Perplexity research

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

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

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

Try It

Tools

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