Perplexity

A Perplexity MCP server based on https://github.com/jaacob/perplexity-mcp which includes additional tools supporting domain filtering, search recency and model routing

typescript

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "rossh121-perplexity-mcp": {
      "command": "node",
      "args": [
        "/absolute/path/to/perplexity-mcp/build/index.js"
      ],
      "env": {
        "PERPLEXITY_MODEL": "sonar",
        "PERPLEXITY_API_KEY": "your-api-key-here"
      }
    }
  }
}

You run a Perplexity-powered MCP Server that lets Claude perform web search queries with automatic model selection based on your intent. It wires Perplexity’s search capabilities into your MCP workflow, so you can get fast, relevant results inside your client with configurable domain and recency controls.

How to use

Ask Claude to search for information using natural queries. The MCP server automatically picks the best Perplexity model based on what you’re asking and returns relevant results along with model context. You can still influence behavior by adding explicit prompts like requesting deep research or fast summaries. If needed, you can force web search by starting your prompt with the phrase “Search the web”.

How to install

Prerequisites you need before installing:

Node.js (v14 or higher)
A Perplexity API key (get one at the Perplexity API settings page)
Claude Desktop App

Installation steps you should follow in order:

Install dependencies by cloning the project and installing npm packages

Configuration snippet

{
  "mcpServers": {
    "perplexity-server": {
      "command": "node",
      "args": [
        "/absolute/path/to/perplexity-mcp/build/index.js"
      ],
      "env": {
        "PERPLEXITY_API_KEY": "your-api-key-here",
        "PERPLEXITY_MODEL": "sonar"
      }
    }
  }
}

What to run and how to start

After configuring the server, start Claude and ensure the server is reachable by Claude. The server uses the Perplexity API key and model setting to determine the best search model for each query.

Notes on models and usage

The server can automatically select the optimal Perplexity model for your query. You can override behavior by setting a specific model or by adjusting keywords in your prompts to trigger different models.

Security and environment

Keep your Perplexity API key secure. Do not expose it in client-side code. Use environment variables as shown to keep keys out of source control.

Available tools

domain_filter

Filter search results to allowed or blocked domains using domain_filter commands within the MCP tooling

list_filters

View current domain and recency filters applied to searches with list_filters

clear_filters

Clear all domain and recency filters using clear_filters

recency_filter

Set or clear recency window for results with recency_filter

model_info

Query model information or force a specific Perplexity model using model_info

Built by

VeilStrat

AI signals for GTM teams