Skip to main content
Glama

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.

-
security - not tested
F
license - not found
-
quality - not tested

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Mahii1972/ppx-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server