MCP Catalogs
Home

perplexity-mcp-server

by cyanheads·22·Score 40

A TypeScript MCP server that provides tools for Perplexity API search and deep research capabilities.

ai-llmsearchdeveloper-tools
13
Forks
1
Open issues
10 mo ago
Last commit
2d ago
Indexed

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:

you:Automate research tasks for AI agents by providing them with Perplexity's search capabilities
you:Enhance LLM responses with up-to-date, verifiable information from the web
you:Integrate search-augmented generation into custom AI workflows and applications
you:What transport methods does this server support?
you:How do I handle timeouts for deep research?

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 README
  • perplexity_search

    Performs a fast, search-augmented query using the Perplexity API.

  • perplexity_deep_research

    Conducts an exhaustive, multi-source investigation for complex topics.

Comparable tools

brave-search-mcpduckduckgo-mcpserper-mcp

Installation

Installation

  1. Clone the repository:
git clone https://github.com/cyanheads/perplexity-mcp-server.git
cd perplexity-mcp-server
  1. Install dependencies:
npm install
  1. Build the project:
npm run build
  1. 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

GitHub →

Last updated · Auto-generated from public README + GitHub signals.