M
MCP Directory CURATED DIRECTORY
911 MCP servers indexed
中文
← Back to directory
P

Perplexity MCP

Community
Long-lived Perplexity browser session, auto-config for 20+ IDEs, and a VS Code extension – all in one monorepo.
How to install ↓ Compare GitHub source repository ↗
Category
Other
Stars
★ 77 Popular
Transport
stdio (local process)
Runtime
Node.js 20+ · Prebuilt binary
Credentials
API key / credential required
License
MIT
Last commit
Tools
5
64FMRS · C

Perplexity MCP offers powerful functionality for developers wanting to bring Perplexity AI into their coding environment, but it comes with legal considerations and risks. The server is feature-rich and highly automated, but is unofficial and may not comply with Perplexity's policies.

Strongest · Documentation 15/20 Weakest · Reliability 10/20

Reliability
10/20
Security and permissions
12/20
Maintenance
15/20
Documentation
15/20
Setup experience
12/20
Why each score
Reliability 10/20
The repository presents a well-structured monorepo with mcp-server, extension, webview, and shared packages. CI workflows and tests (vitest) suggest coverage of critical paths like redact and vault, but since the server is not executed locally, behavior is unverified and depends on a private Perplexity endpoint that may change without notice. The manual maintenance of auto-config rules hints at potential mismatches between tool names and summaries. Thus, a score of 10 reflects a plausible happy path but potentially thin tests and error handling.
Security and permissions 12/20
The project is explicitly non-official and warns about potential ToS violations, which is transparent. Credentials are encrypted in a vault using keytar or passphrase, and cookies are encrypted. The persistent browser session and vault decryption logic appear reasonable, but we cannot confirm data flow or exfiltration risks without execution. No obvious malicious behavior or embedded tokens were found. However, automated browser operations and reliance on external services introduce unknown risks, and there is no explicit confirmation for sensitive actions. Score: 12.
Maintenance 15/20
The repository appears actively maintained with recent commits and releases, and it has an MIT license. CI workflow provides evidence of continuous integration. Dependency updates and versioning policy are mentioned in contributing guidelines (version together and update CHANGELOG). However, no clear security response channel is documented, and the experimental status may affect stability. Score: 15.
Documentation 15/20
The README is highly detailed, covering installation, authentication, config file generation, troubleshooting (e.g., for external clients with vault lock), browser support matrix, architecture notes, and limitations (e.g., reliance on private endpoints). It includes many examples and default values. However, installation steps lack full details on environment variable setup or daemon mode usage, and some concepts (like .reinit sentinel) assume familiarity with specific contexts. Score: 15.
Setup experience 12/20
The README provides clear install steps, including clone, npm install, build, and package commands. It supports multiple IDEs and explains how to use through VS Code or npm. However, setup requires Node.js 20+ and specific npm workspace configuration, and may need extra steps for non-chrome environments (e.g., patchright install chromium). Since not executed, we cannot verify viability. Score: 12.

Static review · not runListed 2026-08-07

Read the FMRS scoring method →

Fit and risk

What it can accessUses the networkControls a browser

Best for

  • Individual developers who want Perplexity search/reasoning in their coding environment
  • VS Code users who benefit from auto-configuration
  • Users who want to integrate Perplexity features across multiple IDEs

Not for

  • Enterprise users who need official support or reliable APIs
  • Users without a Perplexity account to login
  • Users who prefer the official API key approach

Required permissions

  • Access to your local browser profiles (e.g., Chrome profiles)
  • Automate browser sessions, including login and cookie management
  • Read and write local files (config, vault)
  • Network access to Perplexity endpoints

Risks and side effects

  • Violates Perplexity's Terms of Service, potentially leading to account rate-limiting, suspension, or termination.
  • Browser automation may be flagged as abusive by Perplexity.
  • Experimental project: APIs and behavior may change without notice.
  • Vault encryption may cause lockouts due to OS keychain issues.

Setup

Before you start

Runtime：Node.js 20+ · Prebuilt binary

Other optional settings (10)
PERPLEXITY_BROWSER_CHANNEL optional Selects the automated browser channel (chrome, msedge, chromium); Chrome has the best Cloudflare compatibility.
PERPLEXITY_BROWSER_PATH optional Absolute path to a browser executable; wins over auto-detection.
PERPLEXITY_CHROME_PATH optional Legacy alias for PERPLEXITY_BROWSER_PATH.
PERPLEXITY_CONFIG_DIR optional Overrides the default config directory ~/.perplexity-mcp (profiles, vault, daemon state).
PERPLEXITY_HEADLESS_ONLY optional Set to 1 to run headless-only once a valid cf_clearance is cached.
PERPLEXITY_SEARCH_MODEL optional Overrides the default model for perplexity_ask (default pplx_pro).
PERPLEXITY_REASON_MODEL optional Overrides the default model for perplexity_reason (default claude46sonnetthinking).
PERPLEXITY_RESEARCH_MODEL optional Overrides the default model for perplexity_research (default pplx_alpha).
PERPLEXITY_COMPUTE_MODEL optional Overrides the default ASI model for perplexity_compute.
PERPLEXITY_EXPERIMENTAL_IMPIT_SEARCH optional Set to 1 to enable experimental browser-free search (opt-in, default off).

For VS Code: Install the extension from the marketplace, then run the Perplexity: Login command. For other clients: Install the npm package globally: npm install -g perplexity-user-mcp, and point your MCP client to it.

Check that it works

After installing and running the Perplexity: Login command in VS Code to complete the browser login, check that tools like perplexity_search appear in your MCP client's tool list, then issue a simple search and confirm an answer with citations comes back.

Troubleshooting

  1. If encountering 'Vault locked' errors, read `docs/troubleshooting/external-mcp-clients.md`.
  2. If cookies become invalid, delete `~/.perplexity-mcp` and re-login.
  3. If browser automation fails, ensure Chrome is installed or set `PERPLEXITY_BROWSER_CHANNEL`.

Things to try

Once connected, you can ask your AI assistant things like:

  • Search Perplexity for recent papers on retrieval augmented generation evaluation using scholar sources
  • Use perplexity_ask with social sources to find what practitioners say about Cursor versus Windsurf for large TypeScript repos
  • Run deep research comparing academic evidence and practitioner discussion around code review automation, and cite every claim
  • Use perplexity_compute to model the true cost of a 5 kW residential solar installation in the Philippines versus investing the same cash at 6% annually over 10 and 20 years

Tools 5

perplexity_search read-only
Performs a quick web search.
perplexity_ask read-only
Asks for a synthesized answer with citations.
perplexity_reason read-only
Performs step-by-step reasoning and analysis.
perplexity_research read-only
Generates a longer research report.
perplexity_compute read-only
Runs compute tasks in ASI or computer mode (requires account access).

Use cases

Search the web within VS Code without switching context
Perform deep research using scholarly or social sources
Execute complex computation tasks within your local IDE
Automate Perplexity workflows across multiple IDEs

Supported clients

VS Code
Cursor
Claude Desktop
Claude Code
Windsurf
Cline
Amp
Codex

Listed from the project's documentation, not tested by this site.

Overview

Perplexity MCP is a community-maintained MCP server that brings Perplexity's search, reasoning, and research capabilities to various MCP clients by automating your Perplexity account browser session. It ships natively as a VS Code extension and as a standalone npm package for other IDEs. The server leverages your existing Perplexity plan (Free/Pro/Max) instead of an API key.

Similar servers

Telegram MCP Server 70 · B

Telegram MCP server powered by Telethon to let MCP clients read chats, manage groups, and send/modify messages, media, contacts, and settings.

★ 1.8k · Tools 76 Compare with this →
Compare with other MCP servers

Source revision b1366445d9ec Data synced 2026-10-12 Read the FMRS scoring method