Perplexity
About
Integrates with Perplexity AI API to enable web search capabilities for retrieving up-to-date information across domains.
Details
- Author
- jsonallen
- Repository
- jsonallen/perplexity-mcp
- GitHub stars
- 252
- Downloads
- 21,384
- License
- MIT License
- Categories
- Productivity, Developer Tools, Design, AI, Search, API, Infrastructure, Frontend
Jump to
- Single prompt perplexity_search_web with required query argument.
- Optional recency parameter to filter results by day, week, month, or year.
- Single tool perplexity_search_web returning search results from Perplexity.
- Multiple model choices configurable via PERPLEXITY_MODEL environment variable.
- Works with Cursor and Claude Desktop clients via MCP protocol.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
PerplexityCommand (node, npx, python, etc.)uvxArguments-
Argument 1
perplexity-mcp
Environment-
PERPLEXITY_MODEL
sonar -
PERPLEXITY_API_KEY
XXXXXXXXXXXXXXXXXXXX
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
-
Argument 1
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
To install Perplexity MCP for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install perplexity-mcp --client claude
The following environment variable is required in your claude_desktop_config.json. You can obtain an API key from Perplexity
- PERPLEXITY_API_KEY: Your Perplexity AI API key
Optional environment variables:
- PERPLEXITY_MODEL: The Perplexity model to use (defaults to "sonar" if not specified)
Available models:
- sonar-deep-research: 128k context - Enhanced research capabilities
- sonar-reasoning-pro: 128k context - Advanced reasoning with professional focus
- sonar-reasoning: 128k context - Enhanced reasoning capabilities
- sonar-pro: 200k context - Professional grade model
- sonar: 128k context - Default model
- r1-1776: 128k context - Alternative architecture
And updated list of models is avaiable (here)[https://docs.perplexity.ai/guides/model-cards]
Add this tool as a mcp server by editing the Cursor/Claude config file.
"perplexity-mcp": {
"env": {
"PERPLEXITY_API_KEY": "XXXXXXXXXXXXXXXXXXXX",
"PERPLEXITY_MODEL": "sonar"
},
"command": "uvx",
"args": [
"perplexity-mcp"
]
}
perplexity_search_web
Search the web using Perplexity AI. Parameters: 'query' (required string) for the search query, 'recency' (optional string) to filter results by time period (options: day/week/month/year).
The server implements one tool:
- perplexity_search_web: Search the web using Perplexity AI
- Takes "query" as a required string argument
- Optional "recency" parameter to filter results (day/week/month/year)
- Returns search results from Perplexity's API
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"perplexity": {
"env": {
"PERPLEXITY_MODEL": "sonar",
"PERPLEXITY_API_KEY": "XXXXXXXXXXXXXXXXXXXX"
},
"args": [
"perplexity-mcp"
],
"command": "uvx"
}
}
}Linux
{
"env": {
"PERPLEXITY_MODEL": "sonar",
"PERPLEXITY_API_KEY": "XXXXXXXXXXXXXXXXXXXX"
},
"args": [
"perplexity-mcp"
],
"command": "uvx"
}Macos
{
"env": {
"PERPLEXITY_MODEL": "sonar",
"PERPLEXITY_API_KEY": "XXXXXXXXXXXXXXXXXXXX"
},
"args": [
"perplexity-mcp"
],
"command": "uvx"
}Windows
{
"env": {
"PERPLEXITY_MODEL": "sonar",
"PERPLEXITY_API_KEY": "XXXXXXXXXXXXXXXXXXXX"
},
"args": [
"perplexity-mcp"
],
"command": "uvx"
}Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
