Perplexity

🚀 Perplexity MCP Server

A Model Context Protocol (MCP) server for the Perplexity API, written in Go. This server enables AI assistants such as Claude (Code and Desktop versions) and Cursor to seamlessly access Perplexity's powerful search and reasoning capabilities directly from their interfaces.

🚀 Quick Start

The Perplexity MCP server acts as a bridge between AI assistants and the Perplexity API, allowing them to:

1. Search the web and retrieve up - to - date information using Perplexity's Sonar Pro model via the perplexity_ask tool.
2. Perform complex reasoning tasks using Perplexity's Sonar Reasoning Pro model via the perplexity_reason tool.

This integration enables AI assistants like Claude to access real - time information and professional reasoning capabilities directly from their interfaces, providing users with a seamless experience.

✨ Features

Key Advantages

• Access to real - time information: Retrieve the latest data, news, and information from the web.
• Enhanced reasoning capabilities: Leverage professional models for complex task - solving.
• Seamless integration: Natively compatible with Claude Code, Claude Desktop, and Cursor.
• Simple installation: Quickly install using Homebrew, Go, or pre - built binaries.
• Customizable: Configure the Perplexity models used to handle different tasks.

📦 Installation

Using Homebrew (macOS and Linux)

brew tap alcova-ai/tap
brew install perplexity-mcp

From Source Code

Clone the repository and build manually:

git clone https://github.com/Alcova-AI/perplexity-mcp.git
cd perplexity-mcp
go build -o perplexity-mcp-server .

Binary Distribution (Other Platforms)

Download pre - built binaries from the Releases page.

💻 Usage Examples

This server only supports the stdio protocol for MCP communication.

Configuration with Claude Code

Add it to Claude Code:

claude mcp add-json --scope user perplexity-mcp '{"type":"stdio","command":"perplexity-mcp","env":{"PERPLEXITY_API_KEY":"pplx-YOUR-API-KEY-HERE"}}'

Done! You can now use Perplexity in Claude Code.

Configuration with Claude Desktop

Add it to Claude Desktop:

1. Exit the Claude Desktop MCP configuration:

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

2. Add the Perplexity MCP server:

{
    "mcpServers": {
+        "perplexity-mcp": {
+            "command": "perplexity-mcp",
+            "args": [
+                "--model",
+                "sonar-pro",
+                "--reasoning-model",
+                "sonar-reasoning-pro"
+            ],
+            "env": {
+                "PERPLEXITY_API_KEY": "pplx-YOUR-API-KEY-HERE"
+            }
+        }
    }
}

Command - Line Options

• --model, -m: Specify the Perplexity model for searching (default: "sonar-pro").
  • Can be set via the environment variable PERPLEXITY_MODEL.
• --reasoning-model, -r: Specify the Perplexity model for reasoning (default: "sonar-reasoning-pro").
  • Can be set via the environment variable PERPLEXITY_REASONING_MODEL.

Example Command

perplexity-mcp --model sonar-pro --reasoning-model sonar-reasoning-pro

📄 License

This project is licensed under the MIT License.