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-mcp
Or run directly with npx:
npx ppx-sub-mcp
Usage 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 |
|---|---|
perplexity_ask | Ask Perplexity AI with web search |
perplexity_list_models | List available models |
perplexity_login | Open browser to log in and auto-save cookies |
perplexity_status | Check config and cookie status |
perplexity_ask
| Parameter | Required | Description |
|---|---|---|
query | Yes | Question to ask |
model | No | See models below (default: sonar) |
Available Models
| Model | Description |
|---|---|
sonar | Sonar - Perplexity's fast model |
best | Best - Auto-selects the best model |
research | Research - Deep research |
gpt51 | GPT-5.1 - OpenAI's latest |
gpt51-thinking | GPT-5.1 Thinking - With reasoning |
claude | Claude 4.5 - Anthropic's newest |
claude-thinking | Claude 4.5 Thinking - With reasoning |
gemini | Gemini 3 Pro - Google's model |
grok | Grok 4.1 - xAI's model |
kimi | Kimi K2 - Moonshot's model |
Getting Cookies
Option 1: Use the login tool
- Call
perplexity_login— opens a browser window - Log 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 header - Edit
settings.jsondirectly
Credits
Inspired by perplexity-webui-scraper.
License
MIT
This is an unofficial project and is not affiliated with Perplexity AI.