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

1. Open Firefox → perplexity.ai → log in
2. DevTools (F12) → Network tab
3. Send a message
4. Find perplexity_ask request → copy Cookie header
5. Edit settings.json directly

Credits

Inspired by perplexity-webui-scraper.

License

MIT

This is an unofficial project and is not affiliated with Perplexity AI.