Perplexity MCP Server

A Perplexity API MCP server that unlocks Perplexity's search-augmented AI capabilities for LLM agents. Features robust error handling, secure input

Local serverstdioTypeScript

What is the Perplexity MCP server?

A Perplexity API MCP server that unlocks Perplexity's search-augmented AI capabilities for LLM agents. Features robust error handling, secure input validation, and transparent reasoning with the showThinking parameter. That is what the perplexity mcp server brings to an AI assistant: the same capability, reachable through the Model Context Protocol rather than a separate app or dashboard.

The short version

An MCP (Model Context Protocol) server providing comprehensive access to the Perplexity AI API. It enables LLMs and AI agents to perform fast, search-augmented queries and conduct exhaustive, multi-source deep research, all through a standardized, secure, and easy-to-integrate protocol.

The Perplexity MCP Server acts as a bridge, allowing applications (MCP Clients) that understand the Model Context Protocol (MCP)—like advanced AI assistants (LLMs), IDE extensions, or custom research tools—to interact directly and efficiently with the Perplexity AI API.

The tools it exposes

The server publishes 4 tools. What each one is for:

  • perplexity_search — Performs a fast, search-augmented query
  • perplexity_deep_research — Conducts an exhaustive, multi-source research query
  • Prerequisites — The Prerequisites tool exposed by this server
  • Setup — 3. Build the project: bash npm run build

What it needs from you

Configuration is passed through the environment: PERPLEXITY_API_KEY, MCP_HTTP_HOST, MCP_AUTH_SECRET_KEY. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

Getting it running

Setup follows the usual MCP pattern — install or clone the server, register it in your client's configuration file, restart the client. The configuration blocks on this page cover the common clients.

How it compares

This sits in the AI and media services group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Perplexity's toolset — perplexity_search, perplexity_deep_research, Prerequisites and 1 more — is a fair guide to whether it matches your workflow. It is maintained by cyanheads; worth a glance at recent repository activity before you build anything load-bearing on it.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

Things to watch

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Available tools

ToolWhat it does
perplexity_searchPerforms a fast, search-augmented query.
perplexity_deep_researchConducts an exhaustive, multi-source research query.
PrerequisitesThe Prerequisites tool exposed by this server.
Setup3. Build the project: bash npm run build

How to install the Perplexity MCP server

{
  "mcpServers": {
    "perplexity-mcp-server": {
      "command": "node",
      "args": ["/path/to/your/perplexity-mcp-server/dist/index.js"],
      "env": {
        "PERPLEXITY_API_KEY": "YOUR_PERPLEXITY_API_KEY_HERE"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
PERPLEXITY_API_KEYCredential the server authenticates with.Yes
MCP_HTTP_HOSTEndpoint or connection string the server talks to.Optional
MCP_AUTH_SECRET_KEYCredential the server authenticates with.Yes

Example prompts to try

  • Use Perplexity to perplexity search.
  • Use Perplexity to perplexity deep research.
  • Use Perplexity to Prerequisites.

Frequently asked questions

Node.js version 18 or higher, npm, and a Perplexity API key (available at perplexity.ai/settings/api).