perplexity-pro-mcp
Search the web via Perplexity AI Pro from Claude or Cursor, using your existing Pro session cookie — no API key needed.
perplexity_search— deep web search returning a detailed answer with citations and sources; tunable viamode(copilot/concise),model(pplx_pro/pplx_alpha), andfocus(internet, academic, writing, youtube, reddit).perplexity_follow_up— continue a conversation inside an existing thread using athread_uuidfrom a prior search, with the same mode/model/focus options.perplexity_threads— list your recent search threads (optionallimit, default 10).perplexity_export— export an answer entry as markdown or PDF using itsentry_uuid.perplexity_collections— list your saved Perplexity collections.
Provides deep web search via Perplexity Pro, thread management, and export capabilities using a browser session cookie.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@perplexity-pro-mcp search for latest breakthroughs in quantum computing"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
perplexity-pro-mcp
Search the web from Claude or Cursor — MCP server for Perplexity AI Pro. Deep search, follow-up questions and conversation export. Uses your existing Pro session — no extra API key needed.
MCP server for Perplexity AI Pro — deep web search, thread management, and export. Uses your browser session cookie, so it works with your existing Perplexity Pro subscription (no API key needed).
⚠️ This server uses Perplexity's unofficial internal API and a browser session cookie. It may break if Perplexity changes their API, and heavy automated use may violate Perplexity's Terms of Service. Use at your own risk.
Tools
Tool | Description |
| Deep web search via Perplexity Pro (answer + sources + related queries) |
| Continue conversation in an existing thread |
| List recent search threads |
| Export an answer as markdown or PDF |
| List saved collections |
Related MCP server: PPX-MCP
Setup
1. Get your cookie
Open https://www.perplexity.ai (logged in) → DevTools (F12) → Network tab → click any request to perplexity.ai → Headers → copy the full Cookie header value.
2. Configure your MCP client
Claude Code:
claude mcp add perplexity -e PERPLEXITY_COOKIE="<full cookie string>" -- npx -y perplexity-pro-mcpClaude Desktop / other clients (claude_desktop_config.json or equivalent):
{
"mcpServers": {
"perplexity": {
"command": "npx",
"args": ["-y", "perplexity-pro-mcp"],
"env": {
"PERPLEXITY_COOKIE": "<full cookie string>"
}
}
}
}Parameters
perplexity_search
query— search querymode—copilot(deep multi-step) orconcise(quick)model—pplx_proorpplx_alphafocus—internet,academic,writing,youtube,reddit
perplexity_follow_up
query— follow-up questionthread_uuid— UUID from a previous search result
perplexity_export
entry_uuid— entry UUID (from threads list)format—mdorpdf
Cookie refresh
Cookies expire in ~30 days. If you get 403 errors, copy fresh cookies from the browser.
Note: perplexity_search works with just the session token. Other tools require full cookies (including cf_clearance).
Development
npm install
npm run build # compile TypeScript → dist/
npm start # run locally (requires PERPLEXITY_COOKIE)License
MIT
Available Tools
5 toolsperplexity_collectionsB
List user's Perplexity collections (saved threads).
Inputs: no named parameters.
perplexity_exportB
Export a Perplexity answer entry as markdown or PDF.
Inputs: entry_uuid (required), format.
perplexity_follow_upA
Continue a conversation in an existing Perplexity thread. Use thread_uuid from a previous search result.
Inputs: query (required), thread_uuid (required), mode, focus, +1 more.
perplexity_searchB
Search the web using Perplexity AI Pro. Returns a detailed answer with citations and sources.
Inputs: query (required), mode, focus, model.
perplexity_threadsB
List recent Perplexity search threads.
Inputs: limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool serves a unique purpose: searching, listing threads/collections, following up, and exporting. No overlapping functionality.
All tools follow the 'perplexity_' prefix with snake_case, mixing verb and noun patterns consistently (e.g., search, threads, export). Predictable and clear.
Five tools is well-scoped for a search assistant: core search, thread management, follow-up, export, and collections. Not excessive nor sparse.
Covers essential operations: search, view threads, follow-up, export, and list collections. Minor gap: no tool to delete or modify threads/collections, but core workflow is complete.
Maintenance
Related MCP Connectors
One MCP server for all web data. Scrape, search, crawl, and AI research in one install.
Hosted Web Crawler MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Web search API and MCP server for developers building AI agents.
Related MCP Servers
- AlicenseAqualityBmaintenanceA comprehensive MCP server that provides intelligent access to Perplexity AI's search and reasoning models with automatic model selection, conversation management, and project-aware storage. Supports real-time search, deep research, chat sessions, and async operations for complex queries.1132 npm22 PyPI3MIT
- AlicenseAqualityDmaintenanceAn unofficial MCP server for Perplexity AI that leverages Pro subscriptions and browser cookies to enable real-time web searches and model selection without an API key. It provides tools for performing queries, listing available models, and automating the login process to manage authentication.430 npmMIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that enables AI agents to perform search-augmented queries and deep multi-source research using the Perplexity API.69 npm26Apache 2.0
- AlicenseNot gradedqualityCmaintenanceMCP server that queries Perplexity Pro via WebUI session token, providing model-specific tools for search and deep research.170 npm5MIT