Advertise
MCP.so
Sign In

perplexity-mcp MCP server

@jsonallen

Repository

Basic information

Category

Search

License

MIT

Transports

stdio

Author

jsonallen

About perplexity-mcp MCP server

A Model Context Protocol (MCP) server that provides web search functionality using Perplexity AI's API.

perplexity-mcp MCP server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "perplexity-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "perplexity-mcp",
        "--client",
        "claude"
      ]
    }
  }
}

perplexity-mcp MCP server tools

1

Search the web using Perplexity AI

Overview

What is perplexity-mcp?

perplexity-mcp is a Model Context Protocol (MCP) server that provides web search functionality using the Perplexity AI API. It is designed to work with the Anthropic Claude desktop client.

How to use perplexity-mcp?

Install via Smithery with npx -y @smithery/cli install perplexity-mcp --client claude or manually using uvx with the required PERPLEXITY_API_KEY environment variable and optional PERPLEXITY_MODEL. Add the tool to your Cursor or Claude Desktop configuration file to invoke search prompts and tools.

Key features of perplexity-mcp

  • 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.

Use cases of perplexity-mcp

  • Search the web for recent news or topics using natural language.
  • Filter results by recency (last day, week, month, or year).
  • Integrate web search capabilities into Claude-powered workflows.
  • Automate research queries by calling the tool programmatically.

Frequently asked questions

1

What runtime does perplexity-mcp require?

It requires UV, a fast Python package and project manager. Install via `brew install uv` on macOS or the installer script for Linux/Windows.

2

How do I get a Perplexity API key?

Obtain an API key from [Perplexity](https://perplexity.ai) and set it as the `PERPLEXITY_API_KEY` environment variable.

3

What model does perplexity-mcp use by default?

The default model is `sonar`. You can override it by setting the `PERPLEXITY_MODEL` environment variable to any supported model like `sonar-pro` or `sonar-deep-research`.

4

How do I verify the server is working?

Use a prompt like “search the web for news about OpenAI in the past week” in Claude Desktop. An alert box will appear to confirm tool usage—click “Allow for this chat”.

5

Where is the configuration file for Claude Desktop?

On macOS it is at `~/Library/Application Support/Claude/claude_desktop_config.json`. On Windows it is at `%APPDATA%/Claude/claude_desktop_config.json`.

Comments

More Search MCP servers

Free SEO Audit for Claude

houtini.com

Free SEO Audit MCP server for Claude - captures and stores all the raw data you need for a complete technical SEO audit. Google Search Console + a first-party crawl + DataForSEO + Majestic SEO merged into one prioritised

86

Aguasto Research

Aguasto

Official read-only MCP access to Aguasto's public GPU, model and infrastructure research. Search published descriptions and retrieve canonical source links. Anonymous Streamable HTTP; GPU rental and token-based inference

FlatHunt

FlatHunt

Search and compare furnished apartments, studios and rooms in Berlin across multiple housing providers. FlatHunt supports filtering by budget, location, move-in date, rental duration, property type, size, amenities and r

CUQU找搭子 MCP（粗趣）

cuqu-net

CUQU找搭子官方 Agent Skill：让任意 AI Agent（Claude Code/Codex/Cursor/WorkBuddy）代用户找同城线下局、报名、支付、发局。MCP Streamable HTTP + 个人 API Key 网关 agent.cuqu.net

Theyond

theyond

If it's here, it's on their board. Search live verified jobs from employer career pages.

Advertise