Perplexity Web Wrapper

Perplexity Subscription MCP

Unofficial Python wrapper for Perplexity AI's web interface, providing an MCP (Model Context Protocol) server and Python client for integration with coding agents.

**Use your existing Perplexity subscription** — no API costs. This wrapper uses your Perplexity web session cookies, so all queries use your existing Pro subscription instead of the paid Perplexity API.

Why This Wrapper?

Approach	Cost	Rate Limits
This wrapper (web session)	$0 (uses your existing subscription)	Your subscription limits
Perplexity API	$5/1000 requests (sonar), $200/month (pro tier)	API tier limits

If you already have a Perplexity Pro subscription ($20/month), this wrapper lets you integrate Perplexity into your coding workflow without additional API costs.

Quick Start

No install needed — your MCP config runs the server via `uvx` automatically.

**Prerequisites:** [uv](https://docs.astral.sh/uv/getting-started/installation/) and Python 3.10+

1. Get Your Perplexity Cookies

The MCP server authenticates using your browser's Perplexity session cookies. You need to export them once (and re-export when they expire).

Option A: Cookie-Editor Extension (Recommended)

1. Install the Cookie-Editor browser extension (Chrome, Firefox)
2. Go to perplexity.ai and log in to your account
3. Click the Cookie-Editor extension icon
4. Click Export (bottom-left) → copies JSON to clipboard
5. Save the clipboard content to a file:

   # Create the config directory
   mkdir -p ~/.config/perplexity
   
   # Paste your clipboard into this file
   # macOS:
   pbpaste > ~/.config/perplexity/cookies.json
   
   # Linux:
   xclip -selection clipboard -o > ~/.config/perplexity/cookie