Skip to main content
Glama
jujubytes-a11y

Perplexity MCP Server

by jujubytes-a11y
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

Perplexity MCP Server

Python MCP server that exposes Perplexity Sonar Chat Completions to any MCP client (Cursor, Claude Desktop, custom agents).

Tools

Tool

Default model

Purpose

perplexity_search

sonar-pro

General web search

perplexity_deep_research

sonar-deep-research

Comprehensive synthesis

Both tools accept optional Sonar parameters and return JSON:

{
  "answer": "...",
  "citations": ["https://..."],
  "search_results": [],
  "model": "sonar-pro",
  "usage": {}
}

Optional parameters

Parameter

Values / format

When to use

temperature

0–2 (default 0.2)

Lower = more focused; raise only for more varied phrasing

max_tokens

1–128000

Cap answer length; omit for API default

search_recency_filter

hour | day | week | month | year

News / “latest” questions; omit for evergreen topics

search_after_date_filter

MM/DD/YYYY

Absolute start of publication window

search_before_date_filter

MM/DD/YYYY

Absolute end of publication window

search_domain_filter

up to 20 domains; allowlist or -domain denylist (not mixed)

Trusted sources only, or exclude noisy sites

search_mode

web | academic | sec

Papers (academic), SEC filings (sec); omit for general web

model

sonar | sonar-pro | sonar-deep-research | sonar-reasoning-pro

Override tool default only when you need a different speed/depth tradeoff

Prefer date filters over search_recency_filter when the window is known exactly. Queries are capped at 4,000 characters. The API key is never logged or returned in tool output.

Related MCP server: Perplexity Web-Search MCP

Setup

  1. Copy env template and add your Perplexity API key:

cp .env.example .env

  1. Install with uv:

uv sync

Run locally (stdio)

uv run mcp-perplexity

Cursor / Claude Desktop

Add to your MCP config (adjust the project path):

{
  "mcpServers": {
    "perplexity": {
      "command": "uv",
      "args": ["--directory", "C:/Users/KozakJ/git/mcp_perplexity", "run", "mcp-perplexity"],
      "env": {
        "PERPLEXITY_API_KEY": "pplx-your-api-key-here"
      }
    }
  }
}

Or rely on a .env file in the project directory (PERPLEXITY_API_KEY=...).

Run with Podman (streamable HTTP)

podman compose needs a compose provider (podman-compose or Docker Compose). On a plain Podman install, use build + run:

podman build -t mcp-perplexity .
podman run --rm -p 8000:8000 --env-file .env ^
  -e MCP_TRANSPORT=streamable-http ^
  -e MCP_HOST=0.0.0.0 ^
  -e MCP_PORT=8000 ^
  --name mcp-perplexity mcp-perplexity

(On bash/zsh, replace ^ with \.)

If you have a compose provider installed (pip install podman-compose, or Docker Compose):

podman compose up --build

Endpoint: http://localhost:8000/mcp (Streamable HTTP). Bind to trusted networks only — this image does not add HTTP auth.

Configuration

Variable

Default

Description

PERPLEXITY_API_KEY

(required)

Perplexity API key

MCP_TRANSPORT

stdio

stdio or streamable-http

MCP_HOST

127.0.0.1

HTTP bind host

MCP_PORT

8000

HTTP bind port

PERPLEXITY_RPM

30

Soft client-side requests/minute limit

PERPLEXITY_MAX_CONCURRENCY

2

Max concurrent API calls

PERPLEXITY_SEARCH_TIMEOUT

60

Search timeout (seconds)

PERPLEXITY_DEEP_RESEARCH_TIMEOUT

180

Deep research timeout (seconds)

PERPLEXITY_MAX_RETRIES

3

Retries on 429/5xx and transport errors

Retries use exponential backoff (honors Retry-After when present). Logging goes to stderr only so stdio JSON-RPC stays clean.

This server cannot be installed

A
license - permissive license
-
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/jujubytes-a11y/mcp_perplexity'

If you have feedback or need assistance with the MCP directory API, please join our Discord server