Perplexity Comet MCP

A production-grade MCP (Model Context Protocol) server that bridges Claude Code with Perplexity's Comet browser for autonomous web browsing, research, and multi-tab workflow management.

---

Why Perplexity Comet MCP?

Approach	Limitation
Search APIs	Static text, no interaction, no login support
Browser Automation	Single-agent model overwhelms context, fragments focus
Perplexity Comet MCP	Claude codes while Comet handles browsing autonomously

This is a significantly enhanced fork of hanzili/comet-mcp with Windows support, smart completion detection, robust connection handling, and full tab management.

---

Features

Core Capabilities

• Autonomous Web Browsing - Comet navigates, clicks, types, and extracts data while Claude focuses on coding
• Deep Research Mode - Leverage Perplexity's research capabilities for comprehensive analysis
• Login Wall Handling - Access authenticated content through real browser sessions
• Dynamic Content - Full JavaScript rendering and interaction support

Enhanced Features (New in This Fork)

Feature	Description
Windows/WSL Support	Full compatibility with Windows and WSL environments
Tab Management	Track, switch, and close browser tabs with protection
Smart Completion	Detect response completion without fixed timeouts
Auto-Reconnect	Exponential backoff recovery from connection drops
One-Shot Reliability	Pre-operation health checks for consistent execution
Agentic Auto-Trigger	Automatically triggers browser actions from natural prompts

---

Comparison with Original

Capability	Original	Enhanced
Platform Support	macOS	Windows, WSL, macOS
Available Tools	6	8 (+comet_tabs, +comet_upload)
Completion Detection	Fixed timeout	Stability-based
Connection Recovery	None	Auto-reconnect with backoff
Tab Management	None	Full registry and control
Health Monitoring	None	Cached health checks
Last Tab Protection	None	Prevents browser crash

---

Installation

Prerequisites

• Node.js 18 or higher
• Perplexity Comet Browser installed
• Claude Code or compatible MCP client

Install via npm

npm install -g perplexity-comet-mcp

Install from Source

git clone https://github.com/RapierCraft/perplexity-comet-mcp.git
cd perplexity-comet-mcp
npm install
npm run build

Configure Claude Code

Add to your Claude Code MCP settings (~/.claude/settings.json or VS Code settings):

{
  "mcpServers": {
    "comet-bridge": {
      "command": "node",
      "args": ["/path/to/perplexity-comet-mcp/dist/index.js"]
    }
  }
}

Windows Users: Use the full Windows path:

{
  "mcpServers": {
    "comet-bridge": {
      "command": "node",
      "args": ["C:\\Users\\YourName\\perplexity-comet-mcp\\dist\\index.js"]
    }
  }
}

---

Tools Reference

comet_connect

Establish connection to Comet browser. Auto-launches if not running.

Parameters: None
Returns: Connection status message

Example:

> comet_connect
Comet started with debug por

... [View full README on GitHub](https://github.com/RapierCraft/Perplexity-Comet-MCP#readme)