Mcp Perplexity

Name: Mcp Perplexity
Author: daniel-lxs

@daniel-lxs

Repository

About Mcp Perplexity

MCP Server for the Perplexity API.

#mcp-perplexity #perplexity-api #chat-server

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-perplexity": {
      "command": "uvx",
      "args": [
        "mcp-perplexity"
      ],
      "env": {
        "PERPLEXITY_API_KEY": "your-api-key",
        "PERPLEXITY_MODEL": "sonar-pro",
        "DB_PATH": "chats.db"
      }
    }
  }
}

Tools

Provides expert programming assistance through Perplexity. This tool only has access to the context you have provided. It cannot read any file unless you provide it with the file content. Focuses on coding solutions, error debugging, and technical explanations. Returns responses with source citations and alternative suggestions.

Maintains ongoing conversations with Perplexity AI. Creates new chats or continues existing ones with full history context. This tool only has access to the context you have provided. It cannot read any file unless you provide it with the file content. Returns chat ID for future continuation. For new chats: Provide 'message' and 'title' For existing chats: Provide 'chat_id' and 'message'

Lists all available chat conversations with Perplexity AI. Returns chat IDs, titles, and creation dates. Results are paginated with 50 chats per page.

Retrieves the complete conversation history for a specific chat. Returns the full chat history with all messages and their timestamps. No API calls are made to Perplexity - this only reads from local storage.

Overview

What is Mcp Perplexity?

Mcp Perplexity is a Python-based MCP server that provides a programmatic interface to the Perplexity API. It offers tools for querying responses, maintaining chat history, and managing conversations, mimicking the browser-based Perplexity Chat experience. Designed for developers, it integrates with MCP-compatible clients and stores chat data locally.

How to use Mcp Perplexity?

Configure your MCP client with the command uvx mcp-perplexity and set the required environment variable PERPLEXITY_API_KEY. Optionally set PERPLEXITY_MODEL, DB_PATH, and other variables. You can also use Smithery CLI: npx -y @smithery/cli@latest run @daniel-lxs/mcp-perplexity --config "{\"perplexityApiKey\":\"pplx-abc\",\"perplexityModel\":\"sonar-pro\"}".

Key features of Mcp Perplexity

Model selection via PERPLEXITY_MODEL environment variable.
Separate models for ask and chat tools.
Persistent chat history with local database storage.
Streaming responses with progress reporting to prevent timeouts.
Paginated chat listing (50 chats per page, relative timestamps).
Optional web UI for interactive chat management.

Use cases of Mcp Perplexity

Ask specific programming questions and receive source citations.
Maintain ongoing, context-aware conversations with Perplexity AI.
List and review all previous chat conversations.
Debug and research using full chat history retrieval.
Integrate Perplexity’s capabilities into development workflows.

FAQ from Mcp Perplexity

What Python version is required?

Python 3.10 or higher is required.

How do I set my Perplexity API key?

Set the environment variable PERPLEXITY_API_KEY in your MCP client configuration. It is required.

Can I use different models for ask and chat tools?

Yes, set PERPLEXITY_MODEL_ASK for ask_perplexity and PERPLEXITY_MODEL_CHAT for chat_perplexity. These override the default PERPLEXITY_MODEL.

Where is chat history stored?

Chat history is stored locally in a SQLite database at the path specified by DB_PATH (default: chats.db). The read_chat_perplexity tool reads from this local storage without making API calls.

Is there a web interface?

Yes, when WEB_UI_ENABLED is set to true, a web UI is available at http://WEB_UI_HOST:WEB_UI_PORT (default http://127.0.0.1:8050).

Comments

More AI & Agents MCP servers

Shell and Coding agent for Claude and other mcp clients

rusiaaman

Shell and coding agent on mcp clients

666

Perplexity Ask MCP Server

ppl-ai

The official MCP server implementation for the Perplexity API Platform

2.4K

MCP Client for Ollama (ollmcp)

jonigl

Harness the power of local LLMs with this TUI MCP Client for Ollama. Featuring all core MCP primitives (tools, prompts, resources), agent mode, multi-server, model switching, streaming responses, human-in-the-loop, thinking mode, model params config, system prompts, and saved pre

768