MCP.so
Sign In

Mcp Perplexity

@daniel-lxs

Repository

About Mcp Perplexity

MCP Server for the Perplexity API.

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

Basic information

Category

AI & Agents

License

MIT

Runtime

python

Transports

stdio

Publisher

daniel-lxs

Submitted by

Yunkun Han

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

4

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

Just Prompt - A lightweight MCP server for LLM providers

disler

just-prompt is an MCP server that provides a unified interface to top LLM providers (OpenAI, Anthropic, Google Gemini, Groq, DeepSeek, and Ollama)

733

mcp-hfspace MCP Server 🤗

evalstate

MCP Server to Use HuggingFace spaces, easy configuration and Claude Desktop mode.

387

🔎 GPT Researcher

assafelovic

An autonomous agent that conducts deep research on any data using any LLM providers

28.1K

LinkedIn MCP Server

stickerdaniel

Open-source MCP server for LinkedIn. Give Claude and any MCP-compatible AI agent access to profiles, companies, jobs, and messages.

2.7K

Model Context Protocol for Unreal Engine

chongdashu

Enable AI assistant clients like Cursor, Windsurf and Claude Desktop to control Unreal Engine through natural language using the Model Context Protocol (MCP).

2.0K