Advertise
MCP.so
Sign In

Perplexity MCP Server

@RossH121

Repository

Basic information

Category

AI & Agents

License

MIT

Transports

stdio

Author

RossH121

About Perplexity MCP Server

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

Perplexity MCP Server config

No standard config provided

This server doesn't expose a parseable MCP config block in its README. See the repository for install instructions.

Repository

Perplexity MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Perplexity MCP Server?

An MCP server that provides Perplexity AI web search capabilities to Claude, with automatic model selection, stateful filters, and 10 purpose-built tools. It is designed for users of Claude Desktop or any MCP-compatible client who need AI-powered search, deep research, raw web results, agentic loops, and embeddings.

How to use Perplexity MCP Server?

Install Node.js v20 or higher, obtain a Perplexity API key, and ensure you have Claude Desktop (or any MCP-compatible client). Clone the repository, run npm install and npm run build. Add the server to Claude’s config file (claude_desktop_config.json) with the command, absolute path to the built index.js, and environment variables PERPLEXITY_API_KEY and PERPLEXITY_MODEL. After restarting Claude, you can invoke the search, raw_search, async_research, agent, embeddings, and filter tools.

Key features of Perplexity MCP Server

  • 10 purpose-built tools covering search, raw results, research, agent, and embeddings
  • Automatic model selection based on query keywords (sonar, sonar-pro, sonar-reasoning-pro, sonar-deep-research)
  • Stateful domain allowlist/blocklist and recency time-window filters
  • Asynchronous deep research jobs that can be polled, surviving 7 days
  • Agentic loop with built-in tools (web_search, fetch_url) and optional third-party models
  • Embeddings generation via pplx-embed models with Matryoshka dimensions

Use cases of Perplexity MCP Server

  • Time-sensitive research with domain filtering: set recency to week, allow only specific domains, then search for recent breakthroughs
  • Financial document research: use raw_search with SEC mode to find filings, then search for synthesized analysis
  • Academic literature review: search with academic mode and high context size for peer-reviewed sources
  • Deep research with reasoning control: run search with high reasoning effort and strip thinking blocks for clean output
  • Quick fact-checking: use raw_search to get ranked results without AI synthesis, cheaper and faster

Frequently asked questions

1

What are the prerequisites for Perplexity MCP Server?

Node.js v20 or higher, a Perplexity API key (get one at https://www.perplexity.ai/settings/api), and Claude Desktop or any MCP-compatible client.

2

How does automatic model selection work?

The server scores your query against keyword lists. Research keywords (e.g., "deep research", "comprehensive") trigger sonar-deep-research; reasoning keywords (e.g., "solve", "logic") trigger sonar-reasoning-pro; simple keywords (e.g., "quick", "brief") trigger sonar; everything else uses sonar-pro. A strong match (score ≥ 2) overrides a manually set model.

3

What models are available and how can I set a default?

Available models: sonar-deep-research, sonar-reasoning-pro, sonar-pro, sonar. Set a default via the `PERPLEXITY_MODEL` environment variable, or use the `model_info` tool to view and override the current selection.

4

Can I use streaming responses?

Yes, the `search` tool accepts a `stream` boolean parameter and a `stream_mode` parameter (`full` or `concise`) for Pro Search streaming events.

5

How do filters work and are they persistent?

Domain filters (allowlist/blocklist) and recency filters persist across all subsequent searches until cleared. Use `clear_filters` to reset all, `list_filters` to view active filters. Maximum 20 domains; cannot mix allow and block in the same filter set.

Comments

More AI & Agents MCP servers

AON — Agent Offer Network

AON

AON MCP connects AI agents to real, buyable products and services with live pricing and tracked links—enabling builders to earn developer revenue share from attributed clicks and conversions.

2

HeyLead: LinkedIn Outreach & Lead Generation MCP Server

D4umak

HeyLead: AI agent for LinkedIn outreach. Finds the right people, writes in your voice, follows up and handles replies, from Claude Code, Cursor, any MCP client or a web dashboard.

9

TruVerifAI Panel-review

TruVerifAI

TruVerifAI's Panel Review is the guardian agent for AI's highest-stakes coding decisions: four frontier models argue over an AI coding agent's riskiest designs, diffs, and commits before they execute, with local review g

1
F

Factanker

FACTANKER serves 1.18B+ evidence-backed facts about US companies, banks, nonprofits and federal spending, sourced from SEC EDGAR, FFIEC call reports, IRS 990 filings and USAspending. Every value carries its evidence: fil

AskOne: Live Q&A and Polls

phuryn

Run free live audience Q&A and polls from your agent: start an AskOne room, add and launch a poll, approve or hide questions and mark them answered, close the room, then read the questions as a FAQ draft and get the resu

Advertise