Perplexity User
Perplexity AI search, reasoning, research, and compute - MCP server, dashboard, and multi-IDE auto-config for VS Code.
What is Perplexity User?
Perplexity User 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 perplexity-userConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Perplexity User
The Perplexity User MCP server gives AI assistants like Claude direct access to Perplexity AI's search, reasoning, research, and compute capabilities through browser automation — no Perplexity API key required. It exposes distinct tools for quick web searches, deep multi-source research reports, multi-step analytical reasoning, and compute/ASI-mode calculations, each backed by configurable Perplexity model tiers. By running through your browser session, it can access Perplexity's full feature set including scholar, social, and web source filters, making it ideal for anyone who wants AI-assisted research with up-to-date citations built directly into their coding or chat workflow.
Prerequisites
- Node.js 18+ installed on your machine
- A Perplexity account (free or paid) — the server uses your browser session, not an API key
- Chrome, Edge, or Chromium browser installed (used for browser automation via Patchright)
- Claude Desktop, VS Code with MCP support, Cursor, or another compatible MCP client
- npm or npx available in your terminal
Install the package globally
Install the perplexity-user-mcp package from npm so the server binary is available on your PATH.
npm install -g perplexity-user-mcpLog in to Perplexity via the setup command
The server uses browser automation to access Perplexity on your behalf. Run the built-in login command to authenticate and cache your session credentials.
npx perplexity-user-mcp setup-vaultConfigure your browser path (if needed)
If the server cannot auto-detect your browser, set the PERPLEXITY_BROWSER_CHANNEL or PERPLEXITY_BROWSER_PATH environment variable to point to your browser installation.
# Use system Chrome
export PERPLEXITY_BROWSER_CHANNEL=chrome
# Or provide an explicit path
export PERPLEXITY_BROWSER_PATH="/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"Add the server to Claude Desktop
Edit your claude_desktop_config.json to register the Perplexity MCP server. Adjust the env section to override default models or browser settings as needed.
{
"mcpServers": {
"perplexity-user": {
"command": "npx",
"args": ["perplexity-user-mcp"],
"env": {
"PERPLEXITY_BROWSER_CHANNEL": "chrome",
"PERPLEXITY_HEADLESS_ONLY": "1"
}
}
}
}Restart Claude Desktop
Fully quit and relaunch Claude Desktop to load the new server. The Perplexity tools (perplexity_search, perplexity_ask, perplexity_reason, perplexity_research, perplexity_compute) should now appear in the tools panel.
Try your first search
Open a conversation in Claude and ask it to search for something using Perplexity to verify the integration is working.
Perplexity User Examples
Client configuration
Complete claude_desktop_config.json block for the Perplexity User MCP server with Chrome automation.
{
"mcpServers": {
"perplexity-user": {
"command": "npx",
"args": ["perplexity-user-mcp"],
"env": {
"PERPLEXITY_BROWSER_CHANNEL": "chrome",
"PERPLEXITY_HEADLESS_ONLY": "1",
"PERPLEXITY_SEARCH_MODEL": "sonar",
"PERPLEXITY_RESEARCH_MODEL": "sonar-deep-research"
}
}
}
}Prompts to try
Example prompts that exercise different Perplexity tools — search, research, reasoning, and compute.
- "Use Perplexity to search for the latest news on MCP server adoption."
- "Run deep research using both scholar and web sources on the long-term effects of sleep deprivation, and cite every claim."
- "Use Perplexity scholar sources to find recent papers on agentic search evaluation — summarise the top 5."
- "Reason through the trade-offs between PostgreSQL and SQLite for a mobile-first app with 10k daily active users."
- "Compute the true cost of a 5 kW residential solar installation versus investing the same cash at 6% annually over 20 years."Troubleshooting Perplexity User
Browser not found or automation fails to start
Set PERPLEXITY_BROWSER_CHANNEL to 'chrome', 'msedge', or 'chromium' matching your installed browser. If the auto-detected path is wrong, set PERPLEXITY_BROWSER_PATH to the full absolute path of the browser executable.
Cloudflare challenge blocks the browser session
Run the initial setup in headed (non-headless) mode by removing or setting PERPLEXITY_HEADLESS_ONLY to '0'. Complete any CAPTCHA or Cloudflare challenge manually once; the server caches the clearance for future headless runs.
Tools appear in Claude but return empty results
Your Perplexity session may have expired. Re-run 'npx perplexity-user-mcp setup-vault' to refresh the cached credentials, then restart Claude Desktop.
Frequently Asked Questions about Perplexity User
What is Perplexity User?
Perplexity User 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 Perplexity User?
Follow the installation instructions on the Perplexity User GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Perplexity User?
Perplexity User works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Perplexity User free to use?
Yes, Perplexity User is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Perplexity User Alternatives — Similar Search & Data Extraction Servers
Looking for alternatives to Perplexity User? 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 Perplexity User 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 Perplexity User?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.