Perplexity

by jsonallen

252 stars

21.4k downloads

Not rated

GitHub Website

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

- 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 Perplexity

Command (node, npx, python, etc.) uvx
Arguments
- 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.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "perplexity": {
            "env": {
                "PERPLEXITY_MODEL": "sonar",
                "PERPLEXITY_API_KEY": "XXXXXXXXXXXXXXXXXXXX"
            },
            "args": [
                "perplexity-mcp"
            ],
            "command": "uvx"
        }
    }
}

JSON

{
    "mcpServers": {
        "perplexity": {
            "env": {
                "PERPLEXITY_MODEL": "sonar",
                "PERPLEXITY_API_KEY": "XXXXXXXXXXXXXXXXXXXX"
            },
            "args": [
                "perplexity-mcp"
            ],
            "command": "uvx"
        }
    }
}

JSON

{
    "mcpServers": {
        "perplexity": {
            "env": {
                "PERPLEXITY_MODEL": "sonar",
                "PERPLEXITY_API_KEY": "XXXXXXXXXXXXXXXXXXXX"
            },
            "args": [
                "perplexity-mcp"
            ],
            "command": "uvx"
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "perplexity": {
            "env": {
                "PERPLEXITY_MODEL": "sonar",
                "PERPLEXITY_API_KEY": "XXXXXXXXXXXXXXXXXXXX"
            },
            "args": [
                "perplexity-mcp"
            ],
            "command": "uvx"
        }
    }
}

JSON

{
    "mcpServers": {
        "perplexity": {
            "env": {
                "PERPLEXITY_MODEL": "sonar",
                "PERPLEXITY_API_KEY": "XXXXXXXXXXXXXXXXXXXX"
            },
            "args": [
                "perplexity-mcp"
            ],
            "command": "uvx"
        }
    }
}

JSON

{
    "mcpServers": {
        "perplexity": {
            "env": {
                "PERPLEXITY_MODEL": "sonar",
                "PERPLEXITY_API_KEY": "XXXXXXXXXXXXXXXXXXXX"
            },
            "args": [
                "perplexity-mcp"
            ],
            "command": "uvx"
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "perplexity": {
            "env": {
                "PERPLEXITY_MODEL": "sonar",
                "PERPLEXITY_API_KEY": "XXXXXXXXXXXXXXXXXXXX"
            },
            "args": [
                "perplexity-mcp"
            ],
            "command": "uvx"
        }
    }
}

JSON

{
    "mcpServers": {
        "perplexity": {
            "env": {
                "PERPLEXITY_MODEL": "sonar",
                "PERPLEXITY_API_KEY": "XXXXXXXXXXXXXXXXXXXX"
            },
            "args": [
                "perplexity-mcp"
            ],
            "command": "uvx"
        }
    }
}

JSON

{
    "mcpServers": {
        "perplexity": {
            "env": {
                "PERPLEXITY_MODEL": "sonar",
                "PERPLEXITY_API_KEY": "XXXXXXXXXXXXXXXXXXXX"
            },
            "args": [
                "perplexity-mcp"
            ],
            "command": "uvx"
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "perplexity": {
            "env": {
                "PERPLEXITY_MODEL": "sonar",
                "PERPLEXITY_API_KEY": "XXXXXXXXXXXXXXXXXXXX"
            },
            "args": [
                "perplexity-mcp"
            ],
            "command": "uvx"
        }
    }
}

JSON

{
    "mcpServers": {
        "perplexity": {
            "env": {
                "PERPLEXITY_MODEL": "sonar",
                "PERPLEXITY_API_KEY": "XXXXXXXXXXXXXXXXXXXX"
            },
            "args": [
                "perplexity-mcp"
            ],
            "command": "uvx"
        }
    }
}

JSON

{
    "mcpServers": {
        "perplexity": {
            "env": {
                "PERPLEXITY_MODEL": "sonar",
                "PERPLEXITY_API_KEY": "XXXXXXXXXXXXXXXXXXXX"
            },
            "args": [
                "perplexity-mcp"
            ],
            "command": "uvx"
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "perplexity": {
            "env": {
                "PERPLEXITY_MODEL": "sonar",
                "PERPLEXITY_API_KEY": "XXXXXXXXXXXXXXXXXXXX"
            },
            "args": [
                "perplexity-mcp"
            ],
            "command": "uvx"
        }
    }
}

JSON

{
    "mcpServers": {
        "perplexity": {
            "env": {
                "PERPLEXITY_MODEL": "sonar",
                "PERPLEXITY_API_KEY": "XXXXXXXXXXXXXXXXXXXX"
            },
            "args": [
                "perplexity-mcp"
            ],
            "command": "uvx"
        }
    }
}

JSON

{
    "mcpServers": {
        "perplexity": {
            "env": {
                "PERPLEXITY_MODEL": "sonar",
                "PERPLEXITY_API_KEY": "XXXXXXXXXXXXXXXXXXXX"
            },
            "args": [
                "perplexity-mcp"
            ],
            "command": "uvx"
        }
    }
}

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"
}

perplexity-mcp MCP server

A Model Context Protocol (MCP) server that provides web search functionality using Perplexity AI's API. Works with the Anthropic Claude desktop client.

Example

Let's you use prompts like, "Search the web to find out what's new at Anthropic in the past week."

Glama Scores

Components

Prompts

The server provides a single prompt:

- perplexity_search_web: Search the web using Perplexity AI
- Required "query" argument for the search query
- Optional "recency" argument to filter results by time period:
- 'day': last 24 hours
- 'week': last 7 days
- 'month': last 30 days (default)
- 'year': last 365 days
- Uses Perplexity's API to perform web searches

Tools

The server implements one tool:

Installation

Installing via Smithery

To install Perplexity MCP for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install perplexity-mcp --client claude

Requires UV (Fast Python package and project manager)

If uv isn't installed.

```bash

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

perplexity_search_web

Claude Desktop / Cursor

Linux

Macos

Windows

perplexity-mcp MCP server

Example

Glama Scores

Components

Prompts

Tools

Installation

Installing via Smithery

Requires UV (Fast Python package and project manager)

Install

More like this

Time

Sentry

Github

Git

GitLab

Context 7

`perplexity_search_web`