What is Perplexity Mcp

Perplexity-MCP is an enhanced MCP server designed for Perplexity AI, enabling Claude Desktop and other MCP clients to perform web searches using Perplexity’s powerful API. It allows for detailed control over search behavior and response generation through a comprehensive set of API parameters.

Use cases

Use cases for Perplexity-MCP include academic research where up-to-date information is crucial, content generation for blogs or articles that require sourcing, and data analysis tasks that benefit from precise search results and filtering options.

How to use

To use Perplexity-MCP, install it via npm/npx or from source. After installation, configure it in your Claude Desktop’s configuration file by adding the required API key and model settings. Once configured, you can utilize the perplexity_search_web tool to perform searches with various parameters.

Key features

Key features include full support for the Perplexity API, recency filtering for search results, advanced parameters for fine-tuning responses, options for citations and images, streaming support for incremental responses, and the ability to select different Perplexity models.

Where to use

Perplexity-MCP can be used in various fields including research, content creation, data analysis, and any application requiring advanced web search capabilities powered by AI.

Perplexity MCP Server

An enhanced MCP server for Perplexity AI that allows Claude Desktop and other MCP clients to search the web using Perplexity’s powerful API. This server implements the full range of Perplexity API parameters, providing fine-grained control over search behavior and response generation.

Features

• Full Perplexity API support: All parameters from the Perplexity API are exposed
• Recency filtering: Focus on results from the last day, week, month, or year
• Advanced parameters: Control temperature, top_k, top_p, frequency penalties, and more
• Citations and images: Option to include source citations and relevant images
• Streaming support: Enable incremental response streaming
• Model selection: Choose between different Perplexity models

Installation

You can install this MCP server directly via npm/npx or from source:

Option 1: Using npx (Recommended)

npx @jschuller/perplexity-mcp

Option 2: Global Installation

npm install -g @jschuller/perplexity-mcp

Option 3: From Source

git clone https://github.com/jschuller/perplexity-mcp.git
cd perplexity-mcp
npm install
npm run build

Configuration

Claude Desktop

Add this configuration to your Claude Desktop claude_desktop_config.json:

{
  "mcpServers": {
    "perplexity-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@jschuller/perplexity-mcp"
      ],
      "env": {
        "PERPLEXITY_API_KEY": "your_perplexity_api_key_here",
        "PERPLEXITY_MODEL": "sonar-large-online"
      }
    }
  }
}

For macOS, the config file is located at:

~/Library/Application Support/Claude/claude_desktop_config.json

Usage

Once configured, the MCP server provides a perplexity_search_web tool with the following parameters:

Required Parameters

• query (string): The search query

Optional Parameters

• recency (string): Filter results by time period - ‘day’, ‘week’, ‘month’, ‘year’ (default: ‘month’)
• model (string): The Perplexity model to use (default: ‘sonar-large-online’)
• frequency_penalty (number): Penalty for token frequency to avoid repetition
• presence_penalty (number): Penalty for token presence to encourage topic variety
• max_tokens (integer): Maximum number of tokens to generate
• temperature (number): Controls randomness (0 = deterministic, 2 = more random)
• top_k (integer): Limits high-probability tokens to consider
• top_p (number): Nucleus sampling threshold
• return_citations (boolean): Include source citations (default: true)
• return_images (boolean): Include relevant images (default: false)
• stream (boolean): Enable streaming responses (default: false)

Environment Variables

• PERPLEXITY_API_KEY (required): Your Perplexity API key
• PERPLEXITY_MODEL (optional): Default model to use (default: ‘sonar’)

Example Usage

In Claude Desktop, you can use commands like:

Search the web for the latest developments in quantum computing from the last week

The MCP server will automatically use the appropriate parameters to focus on recent results.

Security Considerations

• Your Perplexity API key is kept secure in your local environment
• The MCP server only communicates with the official Perplexity API
• No data is stored or logged beyond what’s necessary for the API calls

Available Models

• sonar: The standard Perplexity model (default)
• sonar-pro: Enhanced model with better capabilities
• Other models as listed at: https://docs.perplexity.ai/guides/model-cards

Troubleshooting

1. API Key Issues: Ensure your PERPLEXITY_API_KEY is correctly set in the configuration
2. Connection Errors: Check your internet connection and Perplexity API status
3. MCP Server Not Found: Make sure the package is properly installed and the command path is correct

License

MIT

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Support

For issues or questions, please file an issue on GitHub.