Provides a Python interface to the Perplexity API for querying responses and managing conversations.
Perplexity Chat MCP server exists for a simple reason — assistants are far more useful when they can act on Perplexity Chat directly instead of describing what you should do. Provides a Python interface to the Perplexity API for querying responses and managing conversations.
The Perplexity MCP Server provides a Python-based interface to the Perplexity API, offering tools for querying responses, maintaining chat history, and managing conversations. It supports model configuration via environment variables and stores chat data locally. Built with Python and setuptools, it's designed for integration with development environments.
Once Perplexity Chat is connected, these are the calls the assistant has available:
ask_perplexity — Request expert programming assistance through Perplexity. Focuses on coding solutions, error debugging, and technical explanations. Returns responseschat_perplexity — Maintains ongoing conversations with Perplexity AI. Creates new chats or continues existing ones with full history context. Returns chat ID forlist_chats_perplexity — Lists all available chat conversations with Perplexity AI. Returns chat IDs, titles, and creation dates (displayed in relative time format, e.g., "5read_chat_perplexity — Retrieves the complete conversation history for a specific chat. Returns the full chat history with all messages and their timestamps. No API callsTools — The Tools tool exposed by this serverPrerequisites — Note: Installation instructions for uvx are available hereFeatures — The Features tool exposed by this serverScreenshots — The Screenshots tool exposed by this serverThe server ships on npm as @smithery/cli, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.
You will need 4 environment variables: PERPLEXITY_API_KEY, PERPLEXITY_MODEL, DB_PATH, WEB_UI_HOST. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.
Before using this MCP server, ensure you have: - Python 3.10 or higher - uvx package manager installed Note: Installation instructions for uvx are available here.
This sits in the file and storage access group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Perplexity Chat's toolset — ask_perplexity, chat_perplexity, list_chats_perplexity and 5 more — is a fair guide to whether it matches your workflow. It is maintained by daniel-lxs; worth a glance at recent repository activity before you build anything load-bearing on it.
This entry was verified against Perplexity Chat's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.
| Tool | What it does |
|---|---|
| ask_perplexity | Request expert programming assistance through Perplexity. Focuses on coding solutions, error debugging, and technical explanations. Returns responses with source citations and alternative suggestions. |
| chat_perplexity | Maintains ongoing conversations with Perplexity AI. Creates new chats or continues existing ones with full history context. Returns chat ID for future continuation. |
| list_chats_perplexity | Lists all available chat conversations with Perplexity AI. Returns chat IDs, titles, and creation dates (displayed in relative time format, e.g., "5 minutes ago", "2 days ago"). Results are paginated with 50 chats per pa |
| read_chat_perplexity | 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. |
| Tools | The Tools tool exposed by this server. |
| Prerequisites | Note: Installation instructions for uvx are available [here](https://docs.astral.sh/uv/#installation). |
| Features | The Features tool exposed by this server. |
| Screenshots | The Screenshots tool exposed by this server. |
"mcpServers": {
"mcp-perplexity": {
"command": "uvx",
"args": ["mcp-perplexity"],
"env": {
"PERPLEXITY_API_KEY": "your-api-key",
"PERPLEXITY_MODEL": "sonar-pro",
"DB_PATH": "chats.db"
}
}
}Configuration as documented by the project. Restart the client after saving.
Before using this MCP server, ensure you have: - Python 3.10 or higher - uvx package manager installed Note: Installation instructions for uvx are available here.
| Variable | Description | Required |
|---|---|---|
| PERPLEXITY_API_KEY | Credential the server authenticates with. | Yes |
| PERPLEXITY_MODEL | Configuration value read at startup. | Optional |
| DB_PATH | Filesystem location the server is allowed to use. | Optional |
| WEB_UI_HOST | Endpoint or connection string the server talks to. | Optional |
Scoped local file access — read, write, search and reorganise files in directories you explicitly allow.
Search and read your Drive — Docs, Sheets and files become context your assistant can actually use.
Query, modify and analyse local SQLite databases in conversation — the fastest way to chat with a data file.
Build a programmable telecommunications stack for connecting telephony services with the Internet via a cloud-based utility.
Chat with your second brain — search, read and write vault notes through the Local REST API.
Connects AI models to an Obsidian knowledge base for direct access and manipulation of notes and folders.