MCP Researcher
A powerful research assistant that integrates with Cline and Claude Desktop to leverage Perplexity AI for intelligent search, documentation retrieval, API discovery, and code modernization assistance while coding.
What is MCP Researcher?
MCP Researcher is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to powerful research assistant that integrates with cline and claude desktop to leverage perplexity ai for intelligent search, documentation retrieval, api discovery, and code modernization assistance wh...
A powerful research assistant that integrates with Cline and Claude Desktop to leverage Perplexity AI for intelligent search, documentation retrieval, API discovery, and code modernization assistance while coding.
This server falls under the Search & Data Extraction category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A powerful research assistant that integrates with Cline and
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx mcp-researcher-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use MCP Researcher
The MCP Researcher Server integrates Perplexity AI's search capabilities into MCP-compatible coding environments like Cline and Claude Desktop, providing three distinct research modes: quick search for factual lookups, deep reasoning for complex multi-step analysis, and comprehensive deep research for generating detailed reports with citations. It is purpose-built for developer workflows — finding API documentation, discovering library alternatives, researching code modernization approaches, and getting real-time information while coding. The server requires a Perplexity API key and runs via npx, making setup fast and requiring no separate package installation.
Prerequisites
- Node.js installed with npx available on your PATH
- A Perplexity AI API key — obtain one at https://www.perplexity.ai/settings/api
- An MCP-compatible client such as Claude Desktop, Cline (VS Code extension), or Claude Code
- Internet access for Perplexity API calls during research
Obtain a Perplexity API key
Sign up or log in at perplexity.ai, navigate to Settings > API, and generate an API key. Copy it — you will use it as PERPLEXITY_API_KEY in your MCP configuration.
Add the server to your MCP client configuration
Edit your MCP client config file and add the perplexity-mcp server block. The server runs via npx so no global installation is required.
{
"mcpServers": {
"perplexity-researcher": {
"command": "npx",
"args": ["-y", "perplexity-mcp"],
"env": {
"PERPLEXITY_API_KEY": "your_perplexity_api_key_here"
}
}
}
}Restart your MCP client
Restart Claude Desktop or Cline so the new server configuration is loaded. The perplexity-mcp package will be downloaded automatically by npx on first use.
Verify the tools are available
In your MCP client, check that the search, reason, and deep_research tools are listed as available. You can ask Claude to 'list available tools' to confirm.
MCP Researcher Examples
Client configuration
Add this block to claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json) to enable Perplexity research tools in Claude Desktop.
{
"mcpServers": {
"perplexity-researcher": {
"command": "npx",
"args": ["-y", "perplexity-mcp"],
"env": {
"PERPLEXITY_API_KEY": "your_perplexity_api_key_here"
},
"disabled": false,
"autoApprove": ["search", "reason", "deep_research"]
}
}
}Prompts to try
Use these prompts to leverage the three research modes — search for quick answers, reason for analysis, and deep research for comprehensive reports.
- "Search for the current stable version of React and its release notes"
- "Find the official documentation for the Stripe Payment Intents API"
- "Reason through the tradeoffs between using Redis vs Memcached for session storage"
- "Do deep research on the best practices for database connection pooling in Node.js"
- "Search for alternatives to Lodash that work natively in modern JavaScript"Troubleshooting MCP Researcher
API calls fail with 401 Unauthorized
Verify PERPLEXITY_API_KEY is correctly set in your MCP config's env block. Go to perplexity.ai/settings/api to confirm your key is active and has remaining credits. Keys begin with `pplx-`.
npx fails to download or run perplexity-mcp
Check that Node.js and npx are installed and on your system PATH with `node --version` and `npx --version`. If behind a corporate proxy, configure npm proxy settings with `npm config set proxy http://your-proxy:port`. You can also pre-install the package with `npm install -g perplexity-mcp` and change the command to use the installed binary path.
Deep research tool is slow or times out
The deep_research tool performs comprehensive multi-step research which can take 30-120 seconds. This is expected behavior. Increase the timeout setting in your MCP client if it has one, or use the search tool for quicker queries. Ensure your internet connection is stable during research sessions.
Frequently Asked Questions about MCP Researcher
What is MCP Researcher?
MCP Researcher is a Model Context Protocol (MCP) server that powerful research assistant that integrates with cline and claude desktop to leverage perplexity ai for intelligent search, documentation retrieval, api discovery, and code modernization assistance while coding. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install MCP Researcher?
Follow the installation instructions on the MCP Researcher GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with MCP Researcher?
MCP Researcher works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is MCP Researcher free to use?
Yes, MCP Researcher is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
MCP Researcher Alternatives — Similar Search & Data Extraction Servers
Looking for alternatives to MCP Researcher? 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 MCP Researcher 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 MCP Researcher?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.