# 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
```bash
npm install -g ppx-sub-mcp
```
Or run directly with npx:
```bash
npx ppx-sub-mcp
```
## Usage with Kiro / Claude Desktop
Add to your MCP config:
```json
{
"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](https://github.com/henrique-coder/perplexity-webui-scraper).
## License
MIT
This is an unofficial project and is not affiliated with Perplexity AI.
