Advertise
MCP.so
Sign In

MCP Perplexity

@daniel-lxs

Repository

Basic information

Category

AI & Agents

License

MIT

Transports

stdio

Author

daniel-lxs

Submitted by

Yunkun Han

About MCP Perplexity

MCP Server for the Perplexity API.

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

MCP Perplexity 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"
      }
    }
  }
}

MCP Perplexity 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.

Frequently asked questions

1

What Python version is required?

Python 3.10 or higher is required.

2

How do I set my Perplexity API key?

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

3

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`.

4

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.

5

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

XDC AI

XDC AI is a remote MCP server available at https://xdcai.tech.

AON — Agent Offer Network

AON

AON MCP connects AI agents to real, buyable products and services with live pricing and tracked links—enabling builders to earn developer revenue share from attributed clicks and conversions.

2

Hostinger

hostinger

Model Context Protocol (MCP) server for Hostinger API. If you don't want to install or run anything locally, connect directly to Hostinger's hosted MCP server: This opens a browser window to authorize via OAuth. Once app

148

AskOne: Live Q&A and Polls

phuryn

Run free live audience Q&A and polls from your agent: start an AskOne room, add and launch a poll, approve or hide questions and mark them answered, close the room, then read the questions as a FAQ draft and get the resu

HeyLead: LinkedIn Outreach & Lead Generation MCP Server

D4umak

HeyLead: AI agent for LinkedIn outreach. Finds the right people, writes in your voice, follows up and handles replies, from Claude Code, Cursor, any MCP client or a web dashboard.

9
Advertise