Perplexity
Provides AI assistants with real-time web search, reasoning, and research capabilities through Perplexity's Sonar models and Search API. Supports quick searches, deep research, advanced reasoning, and direct web search with ranked results.
What is Perplexity?
Perplexity is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to provides ai assistants with real-time web search, reasoning, and research capabilities through perplexity's sonar models and search api. supports quick searches, deep research, advanced reasoning, and...
Provides AI assistants with real-time web search, reasoning, and research capabilities through Perplexity's Sonar models and Search API. Supports quick searches, deep research, advanced reasoning, and direct web search with ranked results.
This server falls under the Search & Data Extraction category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Provides AI assistants with real-time web search, reasoning,
Use Cases
Maintainer
Works with
Installation
NPM
npx -y @perplexity-ai/mcp-serverManual Installation
npx -y @perplexity-ai/mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Perplexity
The Perplexity MCP Server connects AI assistants to Perplexity's Sonar models and Search API, enabling real-time web search, deep research, and advanced reasoning directly inside your MCP client. It exposes four distinct tools — quick search, conversational ask, comprehensive research, and structured reasoning — so you can choose the right depth for each query. Developers and researchers use it to ground AI responses in current information without leaving their editor or chat interface.
Prerequisites
- Node.js 18 or later installed
- A Perplexity API key (sign up at perplexity.ai and generate a key in the API settings)
- An MCP client such as Claude Desktop, Cursor, VS Code, or Windsurf
- npx available in your PATH (comes with Node.js)
Obtain a Perplexity API key
Log in to perplexity.ai, navigate to Settings → API, and generate a new API key. Copy it and store it somewhere safe — you will need it in the next step.
Add the server to Claude Code
Run the following command to register the Perplexity MCP server. Replace 'your_key_here' with your actual API key. This stores the key as an environment variable scoped to this server.
claude mcp add perplexity --env PERPLEXITY_API_KEY="your_key_here" -- npx -y @perplexity-ai/mcp-serverConfigure in Claude Desktop (alternative)
If you use Claude Desktop instead of Claude Code CLI, add the server block to claude_desktop_config.json manually. The server launches on demand via npx.
{
"mcpServers": {
"perplexity": {
"command": "npx",
"args": ["-y", "@perplexity-ai/mcp-server"],
"env": {
"PERPLEXITY_API_KEY": "your_key_here"
}
}
}
}Verify the server starts
Restart your MCP client (or reload the window in VS Code/Cursor). The Perplexity tools — perplexity_search, perplexity_ask, perplexity_research, and perplexity_reason — should now appear in the tool list.
Optional: tune timeout and log level
For slow network environments or verbose debugging, set additional environment variables alongside PERPLEXITY_API_KEY. PERPLEXITY_TIMEOUT_MS controls the request timeout (default 5 minutes) and PERPLEXITY_LOG_LEVEL accepts DEBUG, INFO, WARN, or ERROR.
"env": {
"PERPLEXITY_API_KEY": "your_key_here",
"PERPLEXITY_TIMEOUT_MS": "120000",
"PERPLEXITY_LOG_LEVEL": "INFO"
}Perplexity Examples
Client configuration
Complete claude_desktop_config.json block for the Perplexity MCP server using npx.
{
"mcpServers": {
"perplexity": {
"command": "npx",
"args": ["-y", "@perplexity-ai/mcp-server"],
"env": {
"PERPLEXITY_API_KEY": "pplx-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
}
}
}Prompts to try
Example prompts that exercise each of the four Perplexity tools.
- "Search the web for the latest news on OpenAI's new model release."
- "Do deep research on the current state of quantum computing hardware and summarize the top breakthroughs from the past year."
- "Use advanced reasoning to compare the trade-offs between RAG and fine-tuning for a production chatbot."
- "Find the current price of Bitcoin and the main factors driving its movement today."Troubleshooting Perplexity
Tool calls return 401 Unauthorized
Double-check that PERPLEXITY_API_KEY is set correctly and has not expired. Generate a new key in the Perplexity API settings and update the config.
Server times out on long research queries
Increase PERPLEXITY_TIMEOUT_MS to a higher value (e.g., 300000 for 5 minutes) in the env block of your MCP client config.
npx hangs the first time it runs
The first invocation downloads the @perplexity-ai/mcp-server package. Ensure you have a stable internet connection. After the first run, subsequent starts are faster because the package is cached.
Frequently Asked Questions about Perplexity
What is Perplexity?
Perplexity is a Model Context Protocol (MCP) server that provides ai assistants with real-time web search, reasoning, and research capabilities through perplexity's sonar models and search api. supports quick searches, deep research, advanced reasoning, and direct web search with ranked results. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Perplexity?
Install via npm with the command: npx -y @perplexity-ai/mcp-server. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Perplexity?
Perplexity works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Perplexity free to use?
Yes, Perplexity is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Perplexity Alternatives — Similar Search & Data Extraction Servers
Looking for alternatives to 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 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 Perplexity?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.