perplexity-web-mcp

<p align="center"> </p>

<p align="center"> <a href="https://youtu.be/ffyibtyk-LQ"> </a> <br> _{▶️ <strong>Watch the Demo Overview</strong>} </p>

MCP server, CLI, and API-compatible interface for Perplexity AI's web interface.

Use your Perplexity Pro/Max subscription to access premium models (GPT-5.4, Claude 4.6 Opus, Claude 4.6 Sonnet, Gemini 3.1 Pro, Nemotron 3 Super) from the terminal, through MCP tools, or as an API endpoint.

• CLI: Query Perplexity models directly from the terminal (pwm ask, pwm council, pwm research)
• MCP Server: 17 MCP tools for AI agents with citations and rate limit checking
• API Server: Drop-in Anthropic Messages API and OpenAI Chat Completions API
• 6 Models: GPT-5.4, Claude 4.6 Opus, Claude 4.6 Sonnet, Gemini 3.1 Pro, Nemotron 3 Super, Sonar
• Thinking Mode: Extended thinking support for all compatible models
• Deep Research: Full support for Perplexity's Deep Research mode
• Model Council: Query multiple models in parallel and get a synthesized consensus
• Setup & Skill Management: Auto-configure MCP for Claude Code, Cursor, Windsurf, Gemini CLI, Codex, Cline, Antigravity; install Agent Skills across 9 platforms
• Doctor: Diagnose installation, auth, config, rate limits, and skill status

Full transparency: this project was built by a non-developer using AI coding assistants. If you're an experienced Python developer, you might look at this codebase and wince. That's okay.

The goal here was to learn — both about building CLI tools in Python and about how modern web applications work under the hood. The code works, but it's very much a learning project released solely for the purpose of research and education, not a polished product.

> [!WARNI