What it does

This is an unofficial Python wrapper for Perplexity.ai that talks to the service through its web interface rather than any official API. It can run queries in sync or async mode, stream responses, upload files, and even automate browser sessions via Patchright. The project also bundles an MCP server so Claude Code and other MCP clients can treat Perplexity search as a native tool — no API key required.

The interesting bit

The account-generation angle: it leans on Emailnator to create fresh Gmail accounts, effectively resetting Perplexity’s 5-query “pro” limit each time. There’s also a blunt honesty section comparing this unofficial MCP server against Perplexity’s official one, explicitly listing everything that’s missing (structured citations, image results, filter controls, etc.).

Key highlights

• Reverse-engineered web interface; no Perplexity API key needed
• Optional account generation via Emailnator to bypass query limits
• Sync, async, and streaming APIs with type hints and retry logic
• Browser automation via Patchright using Chrome’s user data directory
• MCP server with stdio and HTTP transports for Claude Code integration
• Supports auto, pro, reasoning, and deep research query modes

Caveats

• The official MCP features are explicitly unsupported: no messages arrays, no search filters, no structured citations, and plain-text answers only
• Browser automation may hit Cloudflare dead loops when using remote debugging
• README contains a truncated code block (import asynci) suggesting the docs aren’t fully polished

Verdict

Worth a look if you want Perplexity inside Claude Code or need to automate queries without paying for API access. Skip it if you need reliable, supported infrastructure or the richer output formatting of the official MCP server.