Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
--timeoutNoCLI flag overriding the default search timeout in dist/index.js, in seconds.900
PERPLEXITY_API_KEYNoOptional official Perplexity API key; enables fast backend: "api" (/v1/agent) or automatic API routing in "auto" mode.
PERPLEXITY_BACKENDNoDefault backend policy (auto, browser, or api).auto
PERPLEXITY_HEADLESSNoSet "true" for headless Chromium (note: Perplexity/Cloudflare may require headed login first).false
PERPLEXITY_API_MODELNoDefault model ID when using backend: "api".sonar
PERPLEXITY_CACHE_DIRNoDirectory storing cached JSON search responses../cache
PERPLEXITY_API_EFFORTNoEffort level (fast, low, medium, high, xhigh) for the /v1/agent endpoint.medium
PERPLEXITY_OUTPUT_DIRNoDirectory where long responses (>= 15000 chars), checkpoints, and relative output_file outputs are saved as .txt../outputs
PERPLEXITY_MAX_SOURCESNoMaximum cited links extracted per answer (0 extracts all unique links).50
PERPLEXITY_PROFILE_DIRNoOverride directory used to store default Chromium profile & Perplexity cookies../.playwright/profile
PERPLEXITY_PROFILE_DIRSNoSemicolon/comma-separated list of profile directories for automatic concurrent multi-browser pooling.
PERPLEXITY_PROFILES_ROOTNoBase folder for named profile arguments (e.g. profile: "worker-2")../.playwright/profiles
PERPLEXITY_VERIFY_CLAIMSNoSet "1" / "true" to verify claims against cited pages by default (or pass per-call verify_claims).false
PERPLEXITY_DIAGNOSTICS_DIRNoDirectory storing failure .html/.png/.json snapshots (max 30 groups)../diagnostics
PERPLEXITY_CACHE_TTL_SECONDSNoTTL in seconds for repeated non-thread queries (0 disables caching; pass no_cache: true per call).3600
PERPLEXITY_LONG_OUTPUT_CHARSNoCharacter 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

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A3.7/5.0

Scored across 7 tools

Disambiguation4/5

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.

Naming Consistency4/5

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.

Tool Count5/5

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.

Completeness4/5

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.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues