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

Quick Q&A with auto model. COSTS 1 PRO SEARCH QUERY. Prefer pplx_smart_query(intent='quick') for simple lookups (Sonar 2 first).

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.

Sonar 2 — Perplexity's latest in-house model. Subject to your plan and Perplexity usage counters (see pplx_usage).

GPT-5.4 — OpenAI's versatile model. COSTS 1 PRO SEARCH QUERY.

GPT-5.4 Thinking — OpenAI's versatile model with extended thinking. COSTS 1 PRO SEARCH QUERY.

GPT-5.5 — OpenAI's latest model. COSTS 1 PRO SEARCH QUERY. Requires Max subscription.

GPT-5.5 Thinking — OpenAI's latest model with extended thinking. COSTS 1 PRO SEARCH QUERY. Requires Max subscription.

Claude Sonnet 4.6 — Anthropic's fast model. COSTS 1 PRO SEARCH QUERY.

Claude Sonnet 4.6 Thinking — Anthropic's fast model with extended thinking. COSTS 1 PRO SEARCH QUERY.

Claude Opus 4.7 — Anthropic's most advanced reasoning model. COSTS 1 PRO SEARCH QUERY. Requires Max subscription.

Claude Opus 4.7 Thinking — Anthropic's most advanced reasoning model with extended thinking. COSTS 1 PRO SEARCH QUERY. Requires Max subscription.

Gemini 3.1 Pro Thinking — Google's most advanced model with extended thinking. COSTS 1 PRO SEARCH QUERY.

Nemotron 3 Super — NVIDIA's Nemotron 3 Super 120B model with extended thinking. COSTS 1 PRO SEARCH QUERY.

Kimi K2.6 — Moonshot's advanced model. COSTS 1 PRO SEARCH QUERY.

Kimi K2.6 Thinking — Moonshot's advanced model with extended thinking. COSTS 1 PRO SEARCH QUERY.

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):

• quick: Facts, definitions, simple lookups, 'what is X' → Sonar 2 (check pplx_usage)

• standard: How-to, comparisons, explanations needing web sources → 1 Pro Search

• detailed: Complex multi-source analysis, technical deep-dives → 1 Pro Search (premium model)

• research: Comprehensive report → 1 Deep Research (scarce monthly quota, user must request)

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

Model Council — query multiple models in parallel, get synthesized consensus.

IMPORTANT — BEFORE calling this tool, you MUST:

1. Tell the user the available models: gpt54, gpt55, claude_sonnet, claude_opus, gemini_pro, nemotron, kimi_k26

2. Ask the user WHICH models they want in their council and HOW MANY

3. Inform them of the cost: each council model = 1 Pro Search query, plus synthesis (default chairman sonar = Sonar 2 pass — still counts as a normal query toward limits)

4. Get explicit confirmation before executing

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.

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.

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.

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.

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

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