perplexity-web-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| --timeout | No | CLI flag overriding the default search timeout in dist/index.js, in seconds. | 900 |
| PERPLEXITY_API_KEY | No | Optional official Perplexity API key; enables fast backend: "api" (/v1/agent) or automatic API routing in "auto" mode. | |
| PERPLEXITY_BACKEND | No | Default backend policy (auto, browser, or api). | auto |
| PERPLEXITY_HEADLESS | No | Set "true" for headless Chromium (note: Perplexity/Cloudflare may require headed login first). | false |
| PERPLEXITY_API_MODEL | No | Default model ID when using backend: "api". | sonar |
| PERPLEXITY_CACHE_DIR | No | Directory storing cached JSON search responses. | ./cache |
| PERPLEXITY_API_EFFORT | No | Effort level (fast, low, medium, high, xhigh) for the /v1/agent endpoint. | medium |
| PERPLEXITY_OUTPUT_DIR | No | Directory where long responses (>= 15000 chars), checkpoints, and relative output_file outputs are saved as .txt. | ./outputs |
| PERPLEXITY_MAX_SOURCES | No | Maximum cited links extracted per answer (0 extracts all unique links). | 50 |
| PERPLEXITY_PROFILE_DIR | No | Override directory used to store default Chromium profile & Perplexity cookies. | ./.playwright/profile |
| PERPLEXITY_PROFILE_DIRS | No | Semicolon/comma-separated list of profile directories for automatic concurrent multi-browser pooling. | |
| PERPLEXITY_PROFILES_ROOT | No | Base folder for named profile arguments (e.g. profile: "worker-2"). | ./.playwright/profiles |
| PERPLEXITY_VERIFY_CLAIMS | No | Set "1" / "true" to verify claims against cited pages by default (or pass per-call verify_claims). | false |
| PERPLEXITY_DIAGNOSTICS_DIR | No | Directory storing failure .html/.png/.json snapshots (max 30 groups). | ./diagnostics |
| PERPLEXITY_CACHE_TTL_SECONDS | No | TTL in seconds for repeated non-thread queries (0 disables caching; pass no_cache: true per call). | 3600 |
| PERPLEXITY_LONG_OUTPUT_CHARS | No | Character threshold for automatic .txt spooling (0 disables auto-spooling while still honoring output_file). | 15000 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_modelsA | List the AI models available on your Perplexity.ai account (excluding unavailable Max-tier models), active and saved default model, and configured browser profile pool status. |
| set_default_modelA | Set or clear your sticky default Perplexity model (persisted locally). Used automatically by search/search_advanced whenever no model argument is passed. |
| searchB | Search the web using Perplexity.ai with claim-level citation provenance ([1] markers, snippets, dates), optional live claim-source verification (supported/weak/unverified), local caching, cancellation-safe streaming, progress notifications, partial .txt checkpoints, typed error JSON, poolable browser profiles, and optional official Agent API backend. Supports model, thread_url, timeout_seconds (default 900s / max 1800s), profile, backend, verify_claims, no_cache, and output_file / auto .txt spooling (>= 15000 chars). |
| search_advancedA | Search Perplexity.ai with specific source selection (web, academic, social), claim-level citation provenance ([1] markers, snippets, dates), optional live claim-source verification, local caching, cancellation-safe streaming, progress notifications, partial .txt checkpoints, typed error JSON, poolable browser profiles, and optional official Agent API backend. |
| compare_modelsA | Ask one question across 2–5 Perplexity models (running concurrently when multiple PERPLEXITY_PROFILE_DIRS profiles or backend='api' are configured), compare shared citations and agreed/divergent key facts, and return a consolidated Markdown report (spooled to .txt if >= 15000 chars or output_file is set). |
| health_checkA | Quick (~5s) diagnostic check verifying Perplexity authentication, absence of Cloudflare blocks, composer search input, add/sources trigger, model selector hydration, and writable local directories. Saves a diagnostic HTML+PNG snapshot automatically if any check fails. |
| loginA | Check if you are authenticated on Perplexity.ai for the default or specified browser profile. If not, opens a visible browser window so you can log in once. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 7 tools
Most tools have clearly distinct purposes: search, compare_models, health_check, login, list_models, and set_default_model are all separable. The only real overlap is search vs search_advanced, which differ mainly by source selection (web/academic/social), a distinction an agent could plausibly miss. Descriptions help but the boundary is not sharp.
Nearly all names follow a snake_case verb_noun pattern (list_models, set_default_model, search_advanced, health_check, compare_models). The bare verbs 'search' and 'login' are the only deviations, but they remain readable and predictable.
Seven tools is well-scoped for a Perplexity search integration: search paths, model management, diagnostics, auth, and comparison. Each tool maps to a distinct operational need with no filler.
The surface covers search, model management, auth, diagnostics, and cross-model comparison, which is solid for the domain. Minor gaps exist: no tool to list/inspect or resume saved threads despite thread_url being accepted, and no cache-clear or logout counterpart to login.