Perplexity Web Search
MCP web search using perplexity without any API KEYS
What is Perplexity Web Search?
Perplexity Web Search is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp web search using perplexity without any api keys
MCP web search using perplexity without any API KEYS
This server falls under the Search & Data Extraction category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- MCP web search using perplexity without any API KEYS
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx perplexity-mcp-zerverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Perplexity Web Search
Perplexity MCP Zerver is a TypeScript-based MCP server that gives AI assistants access to Perplexity's web search engine without requiring a Perplexity API key, using browser automation via Puppeteer to interact with the Perplexity web interface directly. It exposes six tools including web search, documentation retrieval, API discovery, deprecated code checking, URL content extraction, and a persistent chat mode backed by local SQLite storage. Developers and researchers use it to augment AI reasoning with real-time internet search results when they lack access to paid search APIs.
Prerequisites
- Bun JavaScript runtime installed (https://bun.sh)
- Node.js 18+ (for Puppeteer's Chromium browser automation)
- Git for cloning the repository
- An MCP-compatible client such as Claude Desktop
Install Bun runtime
The server is built with Bun. Install it if you do not already have it — Bun is a fast all-in-one JavaScript runtime and package manager.
curl -fsSL https://bun.sh/install | bashClone the repository and install dependencies
Clone the perplexity-mcp-zerver repository and install all required packages including Puppeteer, which will download a compatible Chromium browser automatically.
git clone https://github.com/wysh3/perplexity-mcp-zerver.git
cd perplexity-mcp-zerver
bun installBuild the server
Compile the TypeScript source to a single JavaScript bundle that can be run by Bun at runtime.
bun run buildConfigure Claude Desktop
Add the server to your Claude Desktop configuration, using the absolute path to the built main.js file. A timeout of 300 seconds is recommended because Puppeteer browser startup and page rendering can be slow.
{
"mcpServers": {
"perplexity-server": {
"command": "bun",
"args": ["/absolute/path/to/perplexity-mcp-zerver/build/main.js"],
"timeout": 300
}
}
}Restart Claude Desktop and verify
Restart Claude Desktop and ask it to search for something using Perplexity. The first run will launch a Puppeteer browser session which may take 10-20 seconds. A persistent browser profile is stored at ~/.perplexity-mcp by default.
Perplexity Web Search Examples
Client configuration
Claude Desktop configuration for the Perplexity MCP Zerver. No API key required — the server uses browser automation. Set PERPLEXITY_PERSISTENT_PROFILE to false for ephemeral/anonymous sessions.
{
"mcpServers": {
"perplexity-server": {
"command": "bun",
"args": ["/absolute/path/to/perplexity-mcp-zerver/build/main.js"],
"timeout": 300,
"env": {
"PERPLEXITY_BROWSER_DATA_DIR": "~/.perplexity-mcp",
"PERPLEXITY_PERSISTENT_PROFILE": "true"
}
}
}
}Prompts to try
These prompts exercise the search, documentation lookup, API discovery, and URL extraction tools.
- "Use perplexity to research the latest developments in quantum computing"
- "Ask perplexity for the React 18 useTransition documentation with examples"
- "Find relevant REST APIs for sending SMS messages"
- "Check if this Python code uses any deprecated libraries: import optparse"
- "Extract the content from this URL: https://example.com/article"
- "Start a conversation with perplexity about transformer architecture"Troubleshooting Perplexity Web Search
Puppeteer fails to launch the browser
Ensure Chromium was downloaded during 'bun install'. On Linux, you may need additional system dependencies: run 'npx puppeteer browsers install chrome'. Also check that DISPLAY is set correctly on Linux headless environments — you may need Xvfb.
Searches time out or return empty results
Perplexity's web interface may occasionally require a login or CAPTCHA. Try setting PERPLEXITY_PERSISTENT_PROFILE=false for a clean session, or manually open the Chromium profile stored at PERPLEXITY_BROWSER_DATA_DIR and log into perplexity.ai. Increase the MCP client timeout to 300 seconds.
bun command not found or build fails
After installing Bun, ensure it is on your PATH by running 'source ~/.bashrc' or opening a new terminal. Verify with 'bun --version'. If the build fails, check that you are in the project root directory containing package.json before running 'bun run build'.
Frequently Asked Questions about Perplexity Web Search
What is Perplexity Web Search?
Perplexity Web Search is a Model Context Protocol (MCP) server that mcp web search using perplexity without any api keys It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Perplexity Web Search?
Follow the installation instructions on the Perplexity Web Search GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Perplexity Web Search?
Perplexity Web Search works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Perplexity Web Search free to use?
Yes, Perplexity Web Search is open source and available under the GPL-3.0 license. You can use it freely in both personal and commercial projects.
Perplexity Web Search Alternatives — Similar Search & Data Extraction Servers
Looking for alternatives to Perplexity Web Search? 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 Web Search 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 Web Search?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.