Perplexity Web MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
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 |
|---|---|
| tasks | {
"list": {},
"cancel": {},
"requests": {
"tools": {
"call": {}
},
"prompts": {
"get": {}
},
"resources": {
"read": {}
}
}
} |
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| pplx_queryA | Query Perplexity AI with explicit model selection. COSTS 1 PRO SEARCH QUERY per call. Prefer pplx_smart_query for automatic quota-aware routing. Use this only when you need a specific model or thinking mode. Args: query: The question to ask model: Model to use - auto, sonar, deep_research, gpt54, gpt55, claude_sonnet, claude_opus, gemini_pro, nemotron, kimi_k26 thinking: Enable extended thinking mode (available for gpt54, gpt55, claude_sonnet, claude_opus, kimi_k26; always on for gemini_pro and nemotron) source_focus: Source aliases, raw source IDs, or comma-separated source list |
| pplx_askA | Quick Q&A with auto model. COSTS 1 PRO SEARCH QUERY. Prefer pplx_smart_query(intent='quick') for simple lookups (Sonar 2 first). |
| pplx_deep_researchA | Deep Research — in-depth reports. COSTS 1 DEEP RESEARCH QUERY (limited monthly pool, typically 5-10 total). Only use when the user explicitly requests deep research. |
| pplx_sonarC | Sonar 2 — Perplexity's latest in-house model. Subject to your plan and Perplexity usage counters (see pplx_usage). |
| pplx_gpt54D | GPT-5.4 — OpenAI's versatile model. COSTS 1 PRO SEARCH QUERY. |
| pplx_gpt54_thinkingC | GPT-5.4 Thinking — OpenAI's versatile model with extended thinking. COSTS 1 PRO SEARCH QUERY. |
| pplx_gpt55C | GPT-5.5 — OpenAI's latest model. COSTS 1 PRO SEARCH QUERY. Requires Max subscription. |
| pplx_gpt55_thinkingC | GPT-5.5 Thinking — OpenAI's latest model with extended thinking. COSTS 1 PRO SEARCH QUERY. Requires Max subscription. |
| pplx_claude_sonnetD | Claude Sonnet 4.6 — Anthropic's fast model. COSTS 1 PRO SEARCH QUERY. |
| pplx_claude_sonnet_thinkB | Claude Sonnet 4.6 Thinking — Anthropic's fast model with extended thinking. COSTS 1 PRO SEARCH QUERY. |
| pplx_claude_opusB | Claude Opus 4.7 — Anthropic's most advanced reasoning model. COSTS 1 PRO SEARCH QUERY. Requires Max subscription. |
| pplx_claude_opus_thinkC | Claude Opus 4.7 Thinking — Anthropic's most advanced reasoning model with extended thinking. COSTS 1 PRO SEARCH QUERY. Requires Max subscription. |
| pplx_gemini_pro_thinkC | Gemini 3.1 Pro Thinking — Google's most advanced model with extended thinking. COSTS 1 PRO SEARCH QUERY. |
| pplx_nemotron_thinkingC | Nemotron 3 Super — NVIDIA's Nemotron 3 Super 120B model with extended thinking. COSTS 1 PRO SEARCH QUERY. |
| pplx_kimi_k26D | Kimi K2.6 — Moonshot's advanced model. COSTS 1 PRO SEARCH QUERY. |
| pplx_kimi_k26_thinkingC | Kimi K2.6 Thinking — Moonshot's advanced model with extended thinking. COSTS 1 PRO SEARCH QUERY. |
| pplx_smart_queryA | RECOMMENDED DEFAULT TOOL. Quota-aware query — checks limits and picks the best model automatically. USE THIS FOR EVERY QUERY unless the user explicitly requests a specific model. Default to intent='quick' for most lookups — it routes to Sonar 2 when appropriate. Only escalate intent when the question genuinely requires it. Intent guide (choose the LOWEST sufficient level):
Response includes a metadata block showing the model used, routing reason, and current quota snapshot. Args: query: The question to ask intent: Query complexity — quick (default for most), standard, detailed, research source_focus: Source aliases, raw source IDs, or comma-separated source list |
| pplx_councilA | Model Council — query multiple models in parallel, get synthesized consensus. IMPORTANT — BEFORE calling this tool, you MUST:
Default council: GPT-5.4, Claude Opus 4.7, Gemini 3.1 Pro (3 diverse providers). Args: query: The question to ask all council models source_focus: Source aliases, raw source IDs, or comma-separated source list models: Comma-separated model names to use as council members. Available: gpt54, gpt55, claude_sonnet, claude_opus, gemini_pro, nemotron, kimi_k26. Default: "gpt54,claude_opus,gemini_pro" (3 models + synthesis = 4 Pro Searches) synthesize: Whether to synthesize a consensus from all responses. Set false to get only individual responses (saves 1 Sonar 2 call). thinking: Enable extended thinking for council models (gpt54, gpt55, claude_sonnet, claude_opus, kimi_k26 support toggle; gemini_pro and nemotron are always thinking). chairman: Model to use for synthesis (default: "sonar" / Sonar 2). Non-sonar chairmen cost 1 extra Pro Search query. |
| pplx_usageA | Check current Perplexity usage limits and remaining quotas. CALL THIS AT THE START OF EVERY SESSION before making any queries. Shows remaining Pro Search (weekly), Deep Research (monthly), and other quotas. Use the results to decide whether to conserve Pro quota (e.g. quick intent before premium models). Args: refresh: Force refresh from Perplexity (ignores cache). Default False. |
| pplx_sourcesA | List live Perplexity sources/connectors available on the current account. Args: premium_only: If True, show only premium sources with monthly limits (cbinsights, pitchbook, statista, wiley). Use this to quickly check premium quota before using expensive sources. |
| pplx_auth_statusA | Check if Perplexity is authenticated. Returns the current authentication status and subscription tier if authenticated. Use this to check if re-authentication is needed before making queries. |
| pplx_auth_request_codeA | Request a verification code for Perplexity authentication. Sends a 6-digit verification code to the provided email address. After calling this, check the email inbox and use pplx_auth_complete with the code to finish authentication. Args: email: Your Perplexity account email address Returns: Status message indicating if the code was sent successfully |
| pplx_auth_completeA | Complete Perplexity authentication with the verification code. Use the 6-digit code received via email after calling pplx_auth_request_code. On success, the session token is saved and all pplx_* tools will work. Args: email: Your Perplexity account email (same as used in pplx_auth_request_code) code: The 6-digit verification code from your email Returns: Status message with authentication result and subscription tier |
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 23 tools
Many model-specific query tools (e.g., pplx_gpt54, pplx_sonar) and general query tools (pplx_ask, pplx_query, pplx_smart_query) have overlapping purposes. Descriptions attempt to differentiate them, but the large number of similar tools increases the chance of misselection.
The 'pplx_' prefix is consistent, but naming conventions vary: some use verb_noun (pplx_ask, pplx_query), others are model names (pplx_gpt54) or descriptive (pplx_deep_research). The mix is readable but lacks a uniform pattern.
23 tools is on the higher side for the apparent scope. While many are needed for different models and modes, the count feels slightly heavy and could be streamlined by combining model-specific tools into parameterized versions.
The tool set covers authentication, usage checking, source listing, and a variety of query types (quick, standard, deep research, council). No major gaps are apparent for interacting with Perplexity AI's capabilities.