Skip to content
Back to search

comet-mcp

MCP Server connecting to Perplexity Comet browser

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/hanzili--comet-mcp/badge.svg)](/listings/hanzili--comet-mcp)

HTML

<a href="/listings/hanzili--comet-mcp"><img src="/api/listings/hanzili--comet-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. Configure Claude Code

Add to `~/.claude.json` or `.mcp.json`:

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

2. Install Comet Browser

Download and install [Perplexity Comet](https://www.perplexity.ai/comet).

That's it! The MCP server automatically launches Comet with remote debugging when needed.

3. Use in Claude Code

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]

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 153 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # comet-mcp
  2. [![npm version](https://img.shields.io/npm/v/comet-mcp.svg)](https://www.npmjs.com/package/comet-mcp)
  3. <a href="https://glama.ai/mcp/servers/@hanzili/comet-mcp">
  4. <img width="380" height="200" src="https://glama.ai/mcp/servers/@hanzili/comet-mcp/badge" />
  5. </a>
  6. **Give Claude Code a browser that thinks.**
  7. An MCP server that connects Claude Code to [Perplexity Comet](https://www.perplexity.ai/comet) - enabling agentic web browsing, deep research, and real-time task monitoring.
  8. ![Demo](demo.gif)
  9. ## Why?
  10. Existing web tools for Claude Code fall into two categories, both with limitations:
  11. ### 1. Search APIs (Tavily, Perplexity API, WebFetch)
  12. Return static text. No interaction, no login, no dynamic content. Great for quick lookups, but can't navigate complex sites or fill forms.
  13. ### 2. Browser Automation (browser-use, Puppeteer MCP, Playwright MCP)
  14. 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.
  15. ### 3. Comet MCP: Multi-Agent Delegation
  16. **Comet MCP takes a different approach.** Instead of Claude controlling a browser directly, it delegates to [Perplexity Comet](https://www.perplexity.ai/comet) - an AI purpose-built for web research and browsing.
  17. - **Claude** stays focused on your coding task
  18. - **Comet** handles the browsing: navigation, login walls, dynamic content, deep research
  19. - **Result**: Claude's coding intelligence + Perplexity's web intelligence, working together
  20. ## Quick Start
  21. ### 1. Configure Claude Code
  22. Add to `~/.claude.json` or `.mcp.json`:
  23. ```json
  24. {
  25. "mcpServers": {
  26. "comet-bridge": {
  27. "command": "npx",
  28. "args": ["-y", "comet-mcp"]
  29. }
  30. }
  31. }
  32. ```
  33. ### 2. Install Comet Browser
  34. Download and install [Perplexity Comet](https://www.perplexity.ai/comet).
  35. That's it! The MCP server automatically launches Comet with remote debugging when needed.
  36. ### 3. Use in Claude Code
  37. ```
  38. You: "Use Comet to research the top AI frameworks in 2025"
  39. Claude: [delegates to Comet, monitors progress, returns results]
  40. You: "Log into my GitHub and check my notifications"
  41. Claude: [Comet handles the login flow and navigation]
  42. ```
  43. ## Tools
  44. | Tool | Description |
  45. |------|-------------|
  46. | `comet_connect` | Connect to Comet (auto-starts if needed) |
  47. | `comet_ask` | Send a task and wait for response |
  48. | `comet_poll` | Check progress on long-running tasks |
  49. | `comet_stop` | Stop current task |
  50. | `comet_screenshot` | Capture current page |
  51. | `comet_mode` | Switch modes: search, research, labs, learn |
  52. ## How It Works
  53. ```
  54. Claude Code → MCP Server → CDP → Comet Browser → Perplexity AI
  55. (reasoning) (bridge) (web browsing)
  56. ```
  57. Claude sends high-level goals ("research X", "log into Y"). Comet figures out the clicks, scrolls, and searches. Results flow back to Claude.
  58. ## Requirements
  59. - Node.js 18+
  60. - [Perplexity Comet Browser](https://www.perplexity.ai/comet)
  61. - Claude Code (or any MCP client)
  62. - **Supported platforms**: macOS, Windows, WSL2
  63. ## Windows & WSL Support
  64. ### Native Windows
  65. Works out of the box. Comet MCP auto-detects Windows and launches Comet from its default install location.
  66. ### WSL2 (Windows Subsystem for Linux)
  67. WSL2 requires **mirrored networking** to connect to Comet running on Windows:
  68. 1. **Enable mirrored networking** (one-time setup):
  69. ```
  70. # Create/edit %USERPROFILE%\.wslconfig (Windows side)
  71. [wsl2]
  72. networkingMode=mirrored
  73. ```
  74. 2. **Restart WSL**:
  75. ```bash
  76. wsl --shutdown
  77. # Then reopen your WSL terminal
  78. ```
  79. 3. **That's it!** Comet MCP auto-detects WSL and uses PowerShell to communicate with Windows.
  80. If mirrored networking isn't available, you'll see a helpful error message with setup instructions.
  81. ### Custom Comet Path
  82. If Comet is installed in a non-standard location:
  83. ```json
  84. {
  85. "mcpServers": {
  86. "comet-bridge": {
  87. "command": "npx",
  88. "args": ["-y", "comet-mcp"],
  89. "env": {
  90. "COMET_PATH": "/path/to/your/Comet"
  91. }
  92. }
  93. }
  94. }
  95. ```
  96. ## Troubleshooting
  97. **"Cannot connect to Comet"**
  98. - **macOS**: Ensure Comet is installed at `/Applications/Comet.app`
  99. - **Windows**: Comet should be in `%LOCALAPPDATA%\Perplexity\Comet\Application\`
  100. - Check if port 9222 is available
  101. **"WSL cannot connect to Windows localhost"**
  102. - Enable mirrored networking (see WSL section above)
  103. - Or run Claude Code from Windows PowerShell instead of WSL
  104. **"Tools not showing in Claude"**
  105. - Restart Claude Code after config changes
  106. ## License
  107. MIT
  108. ---
  109. [Report Issues](https://github.com/hanzili/comet-mcp/issues) · [Contribute](https://github.com/hanzili/comet-mcp)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.