home / mcp / comet mcp bridge server

Comet MCP Bridge Server

Connect Claude Code to Perplexity Comet for agentic web browsing and deep research via an MCP bridge.

Installation

Add the following to your MCP client configuration file.

Configuration

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

You connect Claude Code to Perplexity Comet through a dedicated MCP server, enabling agentic web browsing, deep research, and real-time task monitoring. This bridge lets Claude Code delegate research tasks to Comet while you oversee progress and gather results.

How to use

Use an MCP client to connect to the Comet MCP bridge. Configure a server in your client with the provided MCP command, then start Perplexity Comet and initiate tasks from Claude Code. You can request research tasks, monitor progress, and retrieve results once they’re complete.

How to install

Prerequisites you need before starting:

- Node.js 18+ installed on your machine

- Perplexity Comet Browser installed and ready for remote debugging if you plan to use it with Claude Code

Configuration and example setup

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

Notes on usage patterns

With the bridge configured, you can trigger research tasks from Claude Code and let Comet handle the web browsing, dynamic content retrieval, and progress monitoring. Claude Code will delegate the research work to Comet, which returns structured results you can use directly in your project.

Troubleshooting

Cannot connect to Comet - Ensure Comet is running with the remote debugging port enabled (e.g., --remote-debugging-port=9222). - Check that port 9222 is not in use by another process.

Security and notes

Only run the MCP bridge on trusted machines and avoid exposing the MCP endpoint to untrusted networks. Manage access to Claude Code and Comet carefully to prevent unauthorized task control.

License

MIT

Available tools

comet_connect

Connect to Comet (auto-starts if needed)

comet_ask

Send a task and wait for response

comet_poll

Check task progress

comet_stop

Stop current task

comet_screenshot

Capture current page

comet_mode

Switch modes: search, research, labs, learn