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
P
Perplexity MCP
Community
Long-lived Perplexity browser session, auto-config for 20+ IDEs, and a VS Code extension – all in one monorepo.
GitHub source repository ↗
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.
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.
Tools
perplexity_search
Performs a quick web search.
perplexity_ask
Asks for a synthesized answer with citations.
perplexity_reason
Performs step-by-step reasoning and analysis.
perplexity_research
Generates a longer research report.
perplexity_compute
Runs compute tasks in ASI or computer mode (requires account access).
Setup
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.
Fit and risk
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.
Troubleshooting
- If encountering 'Vault locked' errors, read `docs/troubleshooting/external-mcp-clients.md`.
- If cookies become invalid, delete `~/.perplexity-mcp` and re-login.
- If browser automation fails, ensure Chrome is installed or set `PERPLEXITY_BROWSER_CHANNEL`.
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
Visual Studio CodeFull support
CursorFull support
Claude DesktopFull support
Claude CodeFull support
WindsurfFull support
ClineFull support
AmpFull support
Codex CLIFull support