Snapshot of code-yeongyu/perplexity-advanced-mcp: 49★, Python, AI Tools. Advanced MCP tool for Perplexity and OpenRouter API integration.
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
Perplexity Advanced MCP is an advanced integration package that leverages the OpenRouter and Perplexity APIs to provide enhanced query processing capabilities. With an intuitive command-line interface and a robust API client, this package facilitates seamless interactions with AI models for both simple and complex queries.
Comparison with perplexity-mcp
While perplexity-mcp provides basic web search functionality using Perplexity AI's API, Perplexity Advanced MCP offers several additional features:
Multi-vendor Support: Supports both Perplexity and OpenRouter APIs, giving you flexibility in choosing your provider
Query Type Optimization: Distinguishes between simple and complex queries, optimizing for cost and performance
File Attachment Support: Allows including file contents as context in your queries, enabling more precise and contextual responses
Enhanced Retry Logic: Implements robust retry mechanisms for improved reliability
Overall, this is the most suitable MCP for handling codebases when integrated with editors like Cline or Cursor.
Features
Unified API Client: Supports both OpenRouter and Perplexity APIs with configurable models for handling simple and complex queries.
Command-Line Interface (CLI): Manage API key configuration and run the MCP server using Typer.
Advanced Query Processing: Incorporates file attachment processing, allowing you to include contextual data in your queries.
Robust Retry Mechanism: Utilizes Tenacity for retry logic to ensure consistent and reliable API communications.
Customizable Logging: Flexible logging configuration for detailed debugging and runtime monitoring.
Optimal AI Configuration
For the best experience with AI assistants (e.g., Cursor, Claude for Desktop), I recommend adding the following configuration to your project instructions or AI rules:
<perplexity-advanced-mcp>
<description>
Perplexity is an LLM that can search the internet, gather information, and answer users' queries.
For example, let's suppose we want to find out the latest version of Python.
1. You would search on Google.
2. Then read the top two or three results directly to verify.
Perplexity does that work for you.
To answer a user's query, Perplexity searches, opens the top search results, finds information on those websites, and then provides the answer.
Perplexity can be used with two types of queries: simple and complex. Choosing the right query type to fulfill the user's request is most important.
</description>
<simple-query>
<description>
It's cheap and fast. However, it's not suitable for complex queries. On average, it's more than 10 times cheaper and 3 times faster than complex queries.
Use it for simple questions such as "What is the latest version of Python?"
</description>
<pricing>
$1/M input tokens
$1/M output tokens
</pricing>
</simple-query>
<complex-query>
<description>
It's slower and more expensive. Compared to simple queries, it's on average more than 10 times more expensive and 3 times slower.
Use it for more complex requests like "Analyze the attached code to examine the current status of a specific library and create a migration plan."
</description>
<pricing>
$1/M input tokens
$5/M output tokens
</pricing>
</complex-query>
<instruction>
When reviewing the user's request, if you find anything unexpected, uncertain, or questionable, **and you think you can get answer from the internet**, do not hesitate to use the "ask_perplexity" tool to consult Perplexity. However, if the internet is not required to satisfy users' request, it's meaningless to ask to perplexity.
Since Perplexity is also an LLM, prompt engineering techniques are paramount.
Remember the basics of prompt engineering, such as providing clear instructions, sufficient context, and examples
Include as much context and relevant files as possible to smoothly fulfill the user's request. When adding files as attachments, make sure they are absolute paths.
</instruction>
</perplexity-advanced-mcp>
This configuration helps AI assistants better understand when and how to use the Perplexity search functionality, optimizing for both cost and performance.
Usage
Installing via Smithery
To install Perplexity Advanced MCP for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @code-yeongyu/perplexity-advanced-mcp --client claude
Quick Start with uvx
The easiest way to run the MCP server is using uvx:
uvx perplexity-advanced-mcp -o <openrouter_api_key> # or -p <perplexity_api_key>
You can also configure the API keys using environment variables:
export OPENROUTER_API_KEY="your_key_here"
# or
export PERPLEXITY_API_KEY="your_key_here"
uvx perplexity-advanced-mcp
Note:
Providing both OpenRouter and Perplexity API keys simultaneously will result in an error
When both CLI arguments and environment variables are provided, CLI arguments take precedence
The CLI is built with Typer, ensuring a user-friendly command-line experience.
MCP Search Tool
The package includes an MCP search tool integrated via the ask_perplexity function. It supports both simple and complex queries and processes file attachments to provide additional context.
Complex Queries: Engages in detailed reasoning and supports file attachments formatted as XML.
Configuration
API Keys: Configure either the OPENROUTER_API_KEY or PERPLEXITY_API_KEY through command-line options or environment variables.
Model Selection: The configuration (in src/perplexity_advanced_mcp/config.py) maps query types to specific models:
OpenRouter:
Simple Queries: perplexity/sonar
Complex Queries: perplexity/sonar-reasoning
Perplexity:
Simple Queries: sonar-pro
Complex Queries: sonar-reasoning-pro
Development Background & Philosophy
This project emerged from my personal curiosity and experimentation. Following the recent "vibe coding" trend, over 95% of the code was written through Cline + Cursor IDE. They say "talk is cheap, show me the code" - well, with Wispr Flow's speech-to-text magic, I literally just talked and the code showed up! Most of the development was done by me saying things like "Write me the code for x y z, fix the bug here x y z." and pressing enter. Remarkably, creating this fully functional project took less than a few hours.
From project scaffolding to file structure, everything was written and reviewed through LLM. Even the GitHub Actions workflow for PyPI publishing and the release approval process were handled through Cursor. As a human developer, my role was to:
Starting and stopping the MCP server to help AI conduct proper testing
Copying and providing error logs when issues occurred
Finding and providing Python MCP SDK documentation and examples from the internet
Requesting modifications for code that didn't seem correct
In today's world where many things can be automated and replaced, I hope this MCP can help developers like you who use it to discover value beyond just writing code. May this tool assist you in becoming a new era developer who can make higher-level decisions and considerations.
How active is development on code-yeongyu/perplexity-advanced-mcp?
The most recent commit recorded on code-yeongyu/perplexity-advanced-mcp was 1.5 years ago, based on the GitHub push timestamp. The repository has 11 forks — one of the better signals of community interest.
How many stars does code-yeongyu/perplexity-advanced-mcp have?
code-yeongyu/perplexity-advanced-mcp has 49 GitHub stars — refresh the page for the live number, or check github.com/code-yeongyu/perplexity-advanced-mcp. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
Is code-yeongyu/perplexity-advanced-mcp open source?
TopGit's metadata for code-yeongyu/perplexity-advanced-mcp does not record a license. Most public repositories on GitHub ARE open source, but the exact terms vary — verify by opening the LICENSE file directly.
What else is in the AI Tools space?
code-yeongyu/perplexity-advanced-mcp is tracked by TopGit under the AI Tools category, alongside 6 GitHub-tagged topics. Trending and Topics pages list peer repositories of comparable stars and language.
What is code-yeongyu/perplexity-advanced-mcp?
code-yeongyu/perplexity-advanced-mcp (code-yeongyu/perplexity-advanced-mcp) is a Python project on GitHub. From the project's own README: Advanced MCP tool for Perplexity and OpenRouter API integration.
What language is code-yeongyu/perplexity-advanced-mcp written in?
code-yeongyu/perplexity-advanced-mcp is written primarily in Python. GitHub's language field is based on the largest share of bytes in the default branch.
Where do I read more about code-yeongyu/perplexity-advanced-mcp?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/code-yeongyu/perplexity-advanced-mcp is the definitive source.
Read full README in the tab above.
Is perplexity-advanced-mcp worth your time?
ChatGPT, Claude and Perplexity can all read this page. Ask one of them what it makes of perplexity-advanced-mcp.