perplexity-mcp-server
by cyanheads·★ 22·Score 40
A TypeScript MCP server that provides tools for Perplexity API search and deep research capabilities.
Overview
The Perplexity MCP Server is a well-structured implementation built on cyanheads/mcp-ts-template. It provides two primary tools: perplexity_search for quick search-augmented queries and perplexity_deep_research for comprehensive investigations. The server includes robust error handling, input validation, and supports both stdio and HTTP transports with authentication options. It follows MCP best practices with proper TypeScript typing and modular architecture.
Try asking AI
After installing, here are 5 things you can ask your AI assistant:
When to choose this
Choose this when you need your AI agents to access real-time web search and comprehensive research capabilities through a standardized MCP interface, especially for tasks requiring recent information or multi-source validation.
When NOT to choose this
Avoid if you require offline capabilities, need support for search providers other than Perplexity, or prefer self-hosted solutions without third-party API dependencies.
Tools this server exposes
2 tools extracted from the READMEperplexity_searchPerforms a fast, search-augmented query using the Perplexity API.
perplexity_deep_researchConducts an exhaustive, multi-source investigation for complex topics.
Comparable tools
Installation
Installation
- Clone the repository:
git clone https://github.com/cyanheads/perplexity-mcp-server.git
cd perplexity-mcp-server- Install dependencies:
npm install- Build the project:
npm run build- Configure your MCP client (e.g., Claude Desktop):
{
"mcpServers": {
"perplexity-mcp-server": {
"command": "node",
"args": ["/path/to/your/perplexity-mcp-server/dist/index.js"],
"env": {
"PERPLEXITY_API_KEY": "YOUR_PERPLEXITY_API_KEY_HERE"
}
}
}
}FAQ
- What transport methods does this server support?
- The server supports both stdio (default) and HTTP transports. The HTTP transport can be configured with port, host, and authentication options.
- How do I handle timeouts for deep research?
- For the deep research tool, it's recommended to allow a longer timeout (e.g., 180 seconds) through your MCP client. Some clients may time out after 60 seconds which isn't sufficient for deep research.
Compare perplexity-mcp-server with
Last updated · Auto-generated from public README + GitHub signals.