VS Code Perplexity
Perplexity AI search, reasoning, research, and compute - MCP server, dashboard, and multi-IDE auto-config for VS Code.
What is VS Code Perplexity?
VS Code Perplexity is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to perplexity ai search, reasoning, research, and compute - mcp server, dashboard, and multi-ide auto-config for vs code.
Perplexity AI search, reasoning, research, and compute - MCP server, dashboard, and multi-IDE auto-config for VS Code.
This server falls under the Search & Data Extraction category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Perplexity AI search, reasoning, research, and compute - MCP
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx vscode-perplexity-mcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use VS Code Perplexity
The VSCode Perplexity MCP project ships Perplexity AI search and reasoning as an MCP tool that works inside VS Code, Cursor, Windsurf, Claude Desktop, Claude Code, and 15+ other MCP-capable IDEs. Rather than requiring a Perplexity API key, it drives a long-lived Patchright browser session logged into your existing Perplexity account, so it uses your Free, Pro, or Max plan. It is distributed two ways: as a VS Code extension (perplexity-vscode) with an embedded dashboard and auto-configuration for other IDEs, and as a standalone npm package (perplexity-user-mcp) for clients that speak stdio MCP.
Prerequisites
- Node.js 20 or later
- A Perplexity account — Free, Pro, or Max (no separate API key required)
- An MCP-compatible client: VS Code, Cursor, Windsurf, Claude Desktop, Claude Code, or any stdio MCP client
- For the VS Code extension path: VS Code, Cursor, or a compatible fork installed
- npm 10+ (workspaces support required for building from source)
Choose your installation method
If you use VS Code or a compatible IDE, install the perplexity-vscode extension from the VS Code Marketplace and let it auto-configure everything. If you prefer the standalone npm package for Claude Desktop, Cursor, or other MCP clients, use npx or install globally.
Install the standalone npm package (non-VS-Code path)
Install the perplexity-user-mcp package globally or run it on demand with npx. This is the package to reference in your MCP client config.
npm install -g perplexity-user-mcp
# or run on demand:
npx perplexity-user-mcpAdd to your MCP client configuration
Edit your MCP client's config file to add the perplexity-user-mcp server. No API key env var is needed — authentication happens via your browser session.
{
"mcpServers": {
"perplexity": {
"command": "npx",
"args": ["perplexity-user-mcp"]
}
}
}Log in to Perplexity in the browser session
On first run the server opens a Patchright (Playwright-based) browser window. Log in to perplexity.ai with your account. The session is persisted so you will not need to log in again.
Restart your MCP client and verify the tools load
Restart Claude Desktop, Cursor, or your IDE. The Perplexity search and reasoning tools should now appear in the MCP tool list.
VS Code Perplexity Examples
Client configuration
Minimal stdio MCP config for Claude Desktop or Claude Code using npx. The server boots a background browser session on first use.
{
"mcpServers": {
"perplexity": {
"command": "npx",
"args": ["perplexity-user-mcp"]
}
}
}Prompts to try
Prompts that use Perplexity's search and reasoning capabilities from within your AI coding assistant.
- "Search Perplexity for the latest release notes for React 19"
- "Use Perplexity to research the differences between Bun and Node.js for server-side JavaScript"
- "Ask Perplexity: what are the current best practices for securing a Next.js API route?"
- "Search for recent security vulnerabilities in the lodash npm package"
- "Use Perplexity to find the current Stripe webhook signing secret documentation"Troubleshooting VS Code Perplexity
The browser window opens but closes immediately without completing login
The Patchright browser session needs to stay open long enough for you to log in. Make sure you are not blocking popups or running in a headless environment. Try running 'npx perplexity-user-mcp' directly in a terminal first to debug the login flow.
Tools are not visible in the MCP client after configuration
Ensure you are using the package name 'perplexity-user-mcp' (not 'vscode-perplexity-mcp') in your stdio config. Restart your MCP client after saving the config file.
The server exits with 'Cannot find module' errors
Run 'npm install -g perplexity-user-mcp' to ensure the package is installed, or use 'npx perplexity-user-mcp' which fetches it automatically. Node.js 20 or later is required.
Frequently Asked Questions about VS Code Perplexity
What is VS Code Perplexity?
VS Code Perplexity is a Model Context Protocol (MCP) server that perplexity ai search, reasoning, research, and compute - mcp server, dashboard, and multi-ide auto-config for vs code. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install VS Code Perplexity?
Follow the installation instructions on the VS Code Perplexity GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with VS Code Perplexity?
VS Code Perplexity works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is VS Code Perplexity free to use?
Yes, VS Code Perplexity is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
VS Code Perplexity Alternatives — Similar Search & Data Extraction Servers
Looking for alternatives to VS Code Perplexity? Here are other popular search & data extraction servers you can use with Claude, Cursor, and VS Code.
TrendRadar
★ 58.0kA real-time hotspot monitoring and news aggregation assistant that provides AI-powered analysis of trending topics across multiple platforms via the Model Context Protocol. It enables users to track news and receive automated notifications through va
Scrapling
★ 52.7k🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl!
PDF Math Translate
★ 33.9k[EMNLP 2025 Demo] PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译，支持 Google/DeepL/Ollama/OpenAI 等服务，提供 CLI/GUI/MCP/Docker/Zotero
GPT Researcher
★ 27.2kAn autonomous agent that conducts deep research on any data using any LLM providers
Agent Reach
★ 20.1kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
Xiaohongshu
★ 13.7kMCP for xiaohongshu.com
Browse More Search & Data Extraction MCP Servers
Explore all search & data extraction servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up VS Code Perplexity in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use VS Code Perplexity?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.