Can it browse authenticated websites?

Yes. It can access login-protected content through real browser sessions.

Does it support Windows?

Yes. The project supports Windows, macOS, and WSL.

What MCP tools are included?

The README documents tools for connecting, asking Comet to perform tasks, polling, stopping tasks, taking screenshots, and managing tabs.

What are the runtime prerequisites?

Node.js 18 or newer, Perplexity Comet, and Claude Code or another compatible MCP client.

Perplexity Comet MCP

browser-automationweb-researchperplexitymulti-tab

Connects Claude Code to Perplexity Comet for autonomous browsing, research, and multi-tab browser workflows.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

One-click editor setup isn’t available for this listing yet — we don’t have a confirmed install command, and we’d rather show nothing than point your editor at the wrong package or host. Follow the project’s own setup instructions, linked above.

Manual Client & Custom JSON ConfigExpand JSON ▾

No confirmed setup config for this listing yet. We only publish a config block when the install details come from the project itself — its README, its docs, or a verified owner. We haven’t found those for perplexity-comet-mcp, and we’d rather show nothing than a guess you’d paste into your client. Follow the project’s own setup instructions for the current steps.

Overview

Perplexity Comet MCP bridges an MCP client with the Perplexity Comet browser for web navigation, research, authenticated content, and JavaScript-driven pages. It supports tab management, task polling, screenshots, completion detection, and automatic reconnection. Use it when an agent needs browser-based research or actions through an existing Comet session.

Use cases

Research topics through Perplexity Comet

Navigate websites and extract data

Access authenticated web content through a browser session

Manage multiple browsing tabs

Capture the current browser view

Key features

Autonomous browsing with navigation, clicking, typing, and extraction

Deep research mode

Comet connection and auto-launch handling

Tab listing, switching, and closing

Progress polling and task cancellation

Automatic reconnection with exponential backoff

Capabilities & Tool Schemas

Inspect callable tools, capabilities, and parameters exposed to AI agents by Perplexity Comet MCP.

Extracted Tool Capabilities

Autonomous browsing with navigation, clicking, typing, and extraction

Deep research mode

Comet connection and auto-launch handling

Tab listing, switching, and closing

Progress polling and task cancellation

Automatic reconnection with exponential backoff

Documentation Overview

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

Terminal

npm install -g perplexity-comet-mcp

Install from Source

bash

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

config.json

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

Windows Users: Use the full Windows path:

config.json

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

Code

Parameters: None
Returns: Connection status message

Example:

Code

> comet_connect
Comet started with debug port 9223
Connected to Perplexity (cleaned 2 old tabs)

comet_ask

Send a prompt to Comet and wait for the complete response. Automatically triggers agentic browsing for URLs and action-oriented requests.

Code

Parameters:
  - prompt (required): Question or task for Comet
  - newChat (optional): Start fresh conversation (default: false)
  - timeout (optional): Max wait time in ms (default: 120000)

Returns: Complete response text

Examples:

Code

# Simple research query
> comet_ask "What are the latest features in Python 3.12?"

# Agentic browsing (auto-triggered)
> comet_ask "Go to github.com/trending and list top Python repos"

# Site-specific data extraction
> comet_ask "Check the price of iPhone 15 on amazon.com"

comet_poll

Check status and progress of ongoing tasks. Returns the response if completed.

Code

Parameters: None
Returns: Status (IDLE/WORKING/COMPLETED), steps taken, or final response

Example:

Code

> comet_poll
Status: WORKING
Browsing: https://github.com/trending
Current: Scrolling page

Steps:
  - Preparing to assist you
  - Navigating to github.com
  - Clicking on Trending
  - Scrolling page

comet_stop

Halt the current agentic task if it goes off track.

Code

Parameters: None
Returns: Confirmation message

comet_screenshot

Capture a screenshot of the current browser view.

Code

Parameters: None
Returns: PNG image data

comet_tabs

View and manage browser tabs. Essential for multi-tab workflows.

Code

Parameters:
  - action (optional): "list" (default), "switch", or "close"
  - domain (optional): Domain to match (e.g., "github.com")
  - tabId (optional): Specific tab ID

Returns: Tab listing or action confirmation

Examples:

Code

# List all external tabs
> comet_tabs
2 browsing tab(s) open:
  - AGENT-BROWSING: github.com [ACTIVE]
    URL: https://github.com/trending
  - AGENT-BROWSING: stackoverflow.com
    URL: https://stackoverflow.com/questions

# Switch to a tab
> comet_tabs action="switch" domain="stackoverflow.com"
Switched to stackoverflow.com (https://stackoverflow.com/questions)

# Close a tab (protected if last tab)
> comet_tabs action="close" domain="github.com"
Closed github.com

Tab Protection:

Cannot close the last external browsing tab (prevents Comet crash)
Internal tabs (chrome://, Perplexity UI) are automatically filtered

comet_mode

Switch Perplexity search modes for different use cases.

Code

Parameters:
  - mode (optional): "search", "research", "labs", or "learn"

Returns: Current mode or confirmation of switch

Mode	Use Case
search	Quick web searches
research	Deep, comprehensive analysis
labs	Data analytics and visualization
learn	Educational explanations

comet_upload

Upload files to file input elements on web pages. Essential for posting images to social media, attaching files to forms, or uploading documents.

Code

Parameters:
  - filePath (required): Absolute path to the file to upload
  - selector (optional): CSS selector for specific file input
  - checkOnly (optional): If true, only checks what file inputs exist

Returns: Success message or error with available inputs

Examples:

Code

# Upload an image to the first file input found
> comet_upload filePath="/home/user/screenshot.png"
File uploaded successfully: /home/user/screenshot.png

# Check what file inputs exist on the page
> comet_upload filePath="dummy" checkOnly=true
Found 2 file input(s) on the page:
  1. #image-upload
  2. input[name="attachment"]

# Upload to a specific input
> comet_upload filePath="/home/user/doc.pdf" selector="#attachment-input"
File uploaded successfully: /home/user/doc.pdf

Workflow for posting images:

Navigate to the post creation page (e.g., Reddit, Twitter)
Use comet_upload checkOnly=true to find file inputs
Use comet_upload filePath="..." selector="..." to attach the file
Continue with form submission

Architecture

Code

┌─────────────────┐     MCP Protocol      ┌──────────────────┐
│   Claude Code   │ ◄──────────────────► │  Perplexity      │
│   (Your IDE)    │                       │  Comet MCP       │
└─────────────────┘                       └────────┬─────────┘
                                                   │
                                          Chrome DevTools
                                            Protocol
                                                   │
                                          ┌────────▼─────────┐
                                          │  Comet Browser   │
                                          │  (Perplexity)    │
                                          └──────────────────┘
                                                   │
                                          ┌────────▼─────────┐
                                          │   External       │
                                          │   Websites       │
                                          └──────────────────┘

Key Components

Component	Purpose
`index.ts`	MCP server and tool handlers
`cdp-client.ts`	Chrome DevTools Protocol client with reconnection logic
`comet-ai.ts`	Perplexity interaction, prompt submission, response extraction
`types.ts`	TypeScript interfaces for tabs, state, and CDP types

Configuration

Environment Variables

Variable	Description	Default
`COMET_PATH`	Custom path to Comet executable	Auto-detected
`COMET_PORT`	CDP debugging port	9223

Custom Comet Path

server.ts

# Windows
set COMET_PATH=C:\Custom\Path\comet.exe

# macOS/Linux
export COMET_PATH=/custom/path/to/Comet.app/Contents/MacOS/Comet

Troubleshooting

Connection Issues

Problem: Error: Failed to list targets: ECONNREFUSED

Read the full README →View source on GitHub →

Related MCP Servers

View all in Browser Automation View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

Last commit

3mo ago

Most recent push to the default branch.

Directory activity

2 views

Config copies, upvotes, and views on AllMCPs.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Perplexity Comet MCP

It connects to Perplexity's Comet browser, which must be installed locally.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Perplexity Comet MCP AllMCPs Directory Badge

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/perplexity-comet-mcp?style=directory)](https://allmcps.com/mcp/perplexity-comet-mcp)

HTML Embed

<a href="https://allmcps.com/mcp/perplexity-comet-mcp"><img src="https://allmcps.com/api/badge/perplexity-comet-mcp?style=directory" alt="Perplexity Comet MCP on AllMCPs" /></a>

Technical Specs & Signals

CategoryBrowser Automation

PricingFree

6/9 checks healthy over the last 46d

36Quality signal: Fair · 36/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools13/30

Adoption & activity4/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 📂 Browser Automation →Best MCP servers for Browser Automation →Alternatives to Perplexity Comet MCP →Install in Claude Desktop Install in Cursor Install in VS Code Setup guides for all 13 MCP clients

Perplexity Comet MCP

browser-automationweb-researchperplexitymulti-tab

Connects Claude Code to Perplexity Comet for autonomous browsing, research, and multi-tab browser workflows.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Manual Client & Custom JSON ConfigExpand JSON ▾

Overview

Use cases

Research topics through Perplexity Comet

Navigate websites and extract data

Access authenticated web content through a browser session

Manage multiple browsing tabs

Capture the current browser view

Key features

Autonomous browsing with navigation, clicking, typing, and extraction

Deep research mode

Comet connection and auto-launch handling

Tab listing, switching, and closing

Progress polling and task cancellation

Automatic reconnection with exponential backoff

Capabilities & Tool Schemas

Inspect callable tools, capabilities, and parameters exposed to AI agents by Perplexity Comet MCP.

Extracted Tool Capabilities

Autonomous browsing with navigation, clicking, typing, and extraction

Deep research mode

Comet connection and auto-launch handling

Tab listing, switching, and closing

Progress polling and task cancellation

Automatic reconnection with exponential backoff

Documentation Overview

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

Terminal

npm install -g perplexity-comet-mcp

Install from Source

bash

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

config.json

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

Windows Users: Use the full Windows path:

config.json

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

Code

Parameters: None
Returns: Connection status message

Example:

Code

> comet_connect
Comet started with debug port 9223
Connected to Perplexity (cleaned 2 old tabs)

comet_ask

Send a prompt to Comet and wait for the complete response. Automatically triggers agentic browsing for URLs and action-oriented requests.

Code

Parameters:
  - prompt (required): Question or task for Comet
  - newChat (optional): Start fresh conversation (default: false)
  - timeout (optional): Max wait time in ms (default: 120000)

Returns: Complete response text

Examples:

Code

# Simple research query
> comet_ask "What are the latest features in Python 3.12?"

# Agentic browsing (auto-triggered)
> comet_ask "Go to github.com/trending and list top Python repos"

# Site-specific data extraction
> comet_ask "Check the price of iPhone 15 on amazon.com"

comet_poll

Check status and progress of ongoing tasks. Returns the response if completed.

Code

Parameters: None
Returns: Status (IDLE/WORKING/COMPLETED), steps taken, or final response

Example:

Code

> comet_poll
Status: WORKING
Browsing: https://github.com/trending
Current: Scrolling page

Steps:
  - Preparing to assist you
  - Navigating to github.com
  - Clicking on Trending
  - Scrolling page

comet_stop

Halt the current agentic task if it goes off track.

Code

Parameters: None
Returns: Confirmation message

comet_screenshot

Capture a screenshot of the current browser view.

Code

Parameters: None
Returns: PNG image data

comet_tabs

View and manage browser tabs. Essential for multi-tab workflows.

Code

Parameters:
  - action (optional): "list" (default), "switch", or "close"
  - domain (optional): Domain to match (e.g., "github.com")
  - tabId (optional): Specific tab ID

Returns: Tab listing or action confirmation

Examples:

Code

# List all external tabs
> comet_tabs
2 browsing tab(s) open:
  - AGENT-BROWSING: github.com [ACTIVE]
    URL: https://github.com/trending
  - AGENT-BROWSING: stackoverflow.com
    URL: https://stackoverflow.com/questions

# Switch to a tab
> comet_tabs action="switch" domain="stackoverflow.com"
Switched to stackoverflow.com (https://stackoverflow.com/questions)

# Close a tab (protected if last tab)
> comet_tabs action="close" domain="github.com"
Closed github.com

Tab Protection:

Cannot close the last external browsing tab (prevents Comet crash)
Internal tabs (chrome://, Perplexity UI) are automatically filtered

comet_mode

Switch Perplexity search modes for different use cases.

Code

Parameters:
  - mode (optional): "search", "research", "labs", or "learn"

Returns: Current mode or confirmation of switch

Mode	Use Case
search	Quick web searches
research	Deep, comprehensive analysis
labs	Data analytics and visualization
learn	Educational explanations

comet_upload

Upload files to file input elements on web pages. Essential for posting images to social media, attaching files to forms, or uploading documents.

Code

Parameters:
  - filePath (required): Absolute path to the file to upload
  - selector (optional): CSS selector for specific file input
  - checkOnly (optional): If true, only checks what file inputs exist

Returns: Success message or error with available inputs

Examples:

Code

# Upload an image to the first file input found
> comet_upload filePath="/home/user/screenshot.png"
File uploaded successfully: /home/user/screenshot.png

# Check what file inputs exist on the page
> comet_upload filePath="dummy" checkOnly=true
Found 2 file input(s) on the page:
  1. #image-upload
  2. input[name="attachment"]

# Upload to a specific input
> comet_upload filePath="/home/user/doc.pdf" selector="#attachment-input"
File uploaded successfully: /home/user/doc.pdf

Workflow for posting images:

Navigate to the post creation page (e.g., Reddit, Twitter)
Use comet_upload checkOnly=true to find file inputs
Use comet_upload filePath="..." selector="..." to attach the file
Continue with form submission

Architecture

Code

┌─────────────────┐     MCP Protocol      ┌──────────────────┐
│   Claude Code   │ ◄──────────────────► │  Perplexity      │
│   (Your IDE)    │                       │  Comet MCP       │
└─────────────────┘                       └────────┬─────────┘
                                                   │
                                          Chrome DevTools
                                            Protocol
                                                   │
                                          ┌────────▼─────────┐
                                          │  Comet Browser   │
                                          │  (Perplexity)    │
                                          └──────────────────┘
                                                   │
                                          ┌────────▼─────────┐
                                          │   External       │
                                          │   Websites       │
                                          └──────────────────┘

Key Components

Component	Purpose
`index.ts`	MCP server and tool handlers
`cdp-client.ts`	Chrome DevTools Protocol client with reconnection logic
`comet-ai.ts`	Perplexity interaction, prompt submission, response extraction
`types.ts`	TypeScript interfaces for tabs, state, and CDP types

Configuration

Environment Variables

Variable	Description	Default
`COMET_PATH`	Custom path to Comet executable	Auto-detected
`COMET_PORT`	CDP debugging port	9223

Custom Comet Path

server.ts

# Windows
set COMET_PATH=C:\Custom\Path\comet.exe

# macOS/Linux
export COMET_PATH=/custom/path/to/Comet.app/Contents/MacOS/Comet

Troubleshooting

Connection Issues

Problem: Error: Failed to list targets: ECONNREFUSED

Read the full README →View source on GitHub →

Related MCP Servers

View all in Browser Automation View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

Last commit

3mo ago

Most recent push to the default branch.

Directory activity

2 views

Config copies, upvotes, and views on AllMCPs.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Perplexity Comet MCP

It connects to Perplexity's Comet browser, which must be installed locally.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/perplexity-comet-mcp?style=directory)](https://allmcps.com/mcp/perplexity-comet-mcp)

HTML Embed

<a href="https://allmcps.com/mcp/perplexity-comet-mcp"><img src="https://allmcps.com/api/badge/perplexity-comet-mcp?style=directory" alt="Perplexity Comet MCP on AllMCPs" /></a>

Technical Specs & Signals

CategoryBrowser Automation

PricingFree

6/9 checks healthy over the last 46d

36Quality signal: Fair · 36/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools13/30

Adoption & activity4/15

Community engagement0/10

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.