Provides tools to perform real-time web searches and query multiple AI models—including Sonar, GPT-5.1, Claude 4.5, and Gemini—via Perplexity AI using Perplexity Pro session cookies.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@PPX-MCPResearch the latest breakthroughs in room-temperature superconductors"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
PPX-MCP
Unofficial MCP server for Perplexity AI with real-time web search.
Uses your Perplexity Pro subscription instead of the Perplexity API — no API keys needed, just your browser cookies. Supports model selection including GPT-5.1, Claude 4.5, Gemini, Grok, and more.
⚠️ Disclaimer: This is an unofficial project and is not affiliated with, endorsed by, or associated with Perplexity AI in any way.
Platform Support
Platform | Status |
Windows + Chrome | ✅ Tested |
macOS / Linux | ⚠️ Untested — may need tweaks |
The login tool requires Chrome to be installed. On non-Windows platforms, you may need to manually set cookies or adjust the Chrome path in the code.
Installation
npm install -g ppx-sub-mcpOr run directly with npx:
npx ppx-sub-mcpUsage with Kiro / Claude Desktop
Add to your MCP config:
{
"mcpServers": {
"ppx": {
"command": "npx",
"args": ["ppx-sub-mcp"]
}
}
}Cookies are stored in ~/.ppx-mcp/settings.json (persists across updates).
Tools
Tool | Description |
| Ask Perplexity AI with web search |
| List available models |
| Open browser to log in and auto-save cookies |
| Check config and cookie status |
perplexity_ask
Parameter | Required | Description |
| Yes | Question to ask |
| No | See models below (default: |
Available Models
Model | Description |
| Sonar - Perplexity's fast model |
| Best - Auto-selects the best model |
| Research - Deep research |
| GPT-5.1 - OpenAI's latest |
| GPT-5.1 Thinking - With reasoning |
| Claude 4.5 - Anthropic's newest |
| Claude 4.5 Thinking - With reasoning |
| Gemini 3 Pro - Google's model |
| Grok 4.1 - xAI's model |
| Kimi K2 - Moonshot's model |
Getting Cookies
Option 1: Use the login tool
Call
perplexity_login— opens a browser windowLog in to Perplexity
Cookies are automatically saved
Option 2: Manual
Open Firefox → perplexity.ai → log in
DevTools (F12) → Network tab
Send a message
Find
perplexity_askrequest → copy Cookie headerEdit
settings.jsondirectly
Credits
Inspired by perplexity-webui-scraper.
License
MIT
This is an unofficial project and is not affiliated with Perplexity AI.
Resources
Looking for Admin?
Admins can modify the Dockerfile, update the server description, and track usage metrics. If you are the server author, to access the admin panel.