perplexity-web-mcp-cli 0.16.1__tar.gz → 0.17.1__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (49) hide show
  1. {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/PKG-INFO +62 -61
  2. {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/README.md +61 -60
  3. {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/pyproject.toml +1 -1
  4. {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/pyproject.toml.orig +1 -1
  5. {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/api/server.py +258 -240
  6. {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/cli/ai_doc.py +56 -55
  7. {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/cli/hack.py +1 -1
  8. {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/cli/main.py +1 -1
  9. {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/council.py +1 -1
  10. {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/data/SKILL.md +55 -62
  11. {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/data/references/api-endpoints.md +13 -10
  12. {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/data/references/mcp-tools.md +26 -23
  13. {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/data/references/models.md +44 -68
  14. {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/mcp/server.py +86 -60
  15. perplexity_web_mcp_cli-0.17.1/src/perplexity_web_mcp/models.py +89 -0
  16. {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/router.py +3 -3
  17. {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/shared.py +53 -56
  18. perplexity_web_mcp_cli-0.16.1/src/perplexity_web_mcp/models.py +0 -107
  19. {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/__init__.py +0 -0
  20. {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/api/__init__.py +0 -0
  21. {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/api/responses.py +0 -0
  22. {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/api/session_manager.py +0 -0
  23. {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/api/tool_calling.py +0 -0
  24. {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/auth.py +0 -0
  25. {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/catalog.py +0 -0
  26. {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/cli/__init__.py +0 -0
  27. {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/cli/auth.py +0 -0
  28. {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/cli/doctor.py +0 -0
  29. {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/cli/setup.py +0 -0
  30. {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/cli/skill.py +0 -0
  31. {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/config.py +0 -0
  32. {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/connector_policy.py +0 -0
  33. {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/constants.py +0 -0
  34. {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/core.py +0 -0
  35. {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/enums.py +0 -0
  36. {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/exceptions.py +0 -0
  37. {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/http.py +0 -0
  38. {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/limits.py +0 -0
  39. {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/logging.py +0 -0
  40. {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/mcp/__init__.py +0 -0
  41. {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/mcp/__main__.py +0 -0
  42. {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/preferences.py +0 -0
  43. {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/py.typed +0 -0
  44. {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/rate_limits.py +0 -0
  45. {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/resilience.py +0 -0
  46. {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/sessions.py +0 -0
  47. {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/token_store.py +0 -0
  48. {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/trace.py +0 -0
  49. {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/types.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: perplexity-web-mcp-cli
3
- Version: 0.16.1
3
+ Version: 0.17.1
4
4
  Summary: CLI, MCP server, and Anthropic/OpenAI API-compatible interface for Perplexity AI.
5
5
  Keywords: perplexity,ai,mcp,anthropic,api,client
6
6
  Author: Jacob BD
@@ -62,14 +62,14 @@ Description-Content-Type: text/markdown
62
62
 
63
63
  MCP server, CLI, and API-compatible interface for Perplexity AI's web interface.
64
64
 
65
- Use your Perplexity Pro/Max subscription to access premium models (Sonar 2, GPT-6 Sol, GPT-5.6 Terra, Gemini 3.8 Flash, Claude Sonnet 5, Claude Opus 5.5, Kimi K3, GLM 5.3, Grok 4.7, and Nemotron 3 Ultra) from the terminal, through MCP tools, or as an API endpoint.
65
+ Use your Perplexity Pro/Max subscription to access premium models (GPT-6.1 Sol, GPT-6 Astra, Gemini 4 Carbon, Gemini 4 Hydrogen, Claude Sonnet 5.5, Claude Opus 5.5, Claude Fable 5.2, Grok 4.7, GLM 5.3, Kimi K3, and Nemotron 3.5 Super VL) from the terminal, through MCP tools, or as an API endpoint.
66
66
 
67
67
  ## Features
68
68
 
69
69
  - **CLI**: Query Perplexity models directly from the terminal (`pwm ask`, `pwm chat`, `pwm council`, `pwm research`, `pwm config`)
70
70
  - **MCP Server**: MCP tools for AI agents with citations, rate limit checking, and multi-turn context
71
71
  - **API Server**: Drop-in Anthropic Messages API and OpenAI Chat Completions API
72
- - **10 Models**: Sonar 2, GPT-5.6 Terra, GPT-5.6 Sol, Gemini 3.1 Pro, Claude Sonnet 5, Claude Opus 4.8, GLM 5.2, Kimi K2.6, Grok 4.5, and Nemotron 3 Ultra
72
+ - **Premium Models**: GPT-6.1 Sol, GPT-6 Astra, Gemini 4 Carbon, Gemini 4 Hydrogen, Claude Sonnet 5.5, Claude Opus 5.5, Claude Fable 5.2, Grok 4.7, GLM 5.3, Kimi K3, and Nemotron 3.5 Super VL
73
73
  - **Thinking Mode**: Extended thinking support for all compatible models
74
74
  - **Deep Research**: Full support for Perplexity's Deep Research mode
75
75
  - **Multi-Turn Conversations**: State-preserved threaded conversations for both MCP and CLI REPL
@@ -177,7 +177,7 @@ pwm ask "What is quantum computing?"
177
177
  **Choose a specific model** with `-m` (see [Models](#models) for the full list):
178
178
 
179
179
  ```bash
180
- pwm ask "Compare React and Vue" -m gpt56_terra
180
+ pwm ask "Compare React and Vue" -m gpt61_sol
181
181
  ```
182
182
 
183
183
  ```bash
@@ -223,7 +223,7 @@ pwm ask "What is Rust?" --no-citations
223
223
  **Combine flags** for full control:
224
224
 
225
225
  ```bash
226
- pwm ask "recent advances in protein folding" -m gemini_pro -s academic --json
226
+ pwm ask "recent advances in protein folding" -m gemini4_hydrogen -s academic --json
227
227
  ```
228
228
 
229
229
  **Long prompts and attachments:**
@@ -282,13 +282,13 @@ pwm research "NVIDIA competitive landscape" -s finance --json
282
282
  Query multiple models in parallel and get a synthesized consensus. Each model costs 1 Pro Search. Default synthesis uses Sonar 2 (also 1 Pro Search).
283
283
 
284
284
  ```bash
285
- # Default: GPT-5.6 Terra, Claude Sonnet, Gemini Pro + Sonar 2 synthesis (4 Pro Searches)
285
+ # Default: GPT-6.1 Sol, Claude Sonnet 5.5, Gemini 4 Hydrogen + Sonar 2 synthesis (4 Pro Searches)
286
286
  pwm council "What are best practices for microservices?"
287
287
  ```
288
288
 
289
289
  ```bash
290
290
  # Custom model selection
291
- pwm council "Compare Rust and Go" -m gpt56_terra,claude_sonnet
291
+ pwm council "Compare Rust and Go" -m gpt61_sol,claude_sonnet
292
292
  ```
293
293
 
294
294
  ```bash
@@ -337,7 +337,7 @@ Seamlessly launch external AI tools connected to the Perplexity API server. This
337
337
 
338
338
  ```bash
339
339
  pwm hack claude # Launch Claude Code
340
- pwm hack claude -m gpt56_terra # Launch Claude Code with a specific model
340
+ pwm hack claude -m gpt61_sol # Launch Claude Code with a specific model
341
341
  ```
342
342
 
343
343
  ### MCP Setup
@@ -398,26 +398,23 @@ pwm --ai # Print comprehensive AI-optimized reference
398
398
 
399
399
  ## Models
400
400
 
401
- | CLI Name | Provider | Thinking | Notes |
402
- | --------------- | ---------- | -------- | ------------------------------------------------ |
403
- | `auto` | Perplexity | No | Auto-selects best model |
404
- | `sonar` | Perplexity | No | Sonar 2 (latest in-house; API id `experimental`) |
405
- | `deep_research` | Perplexity | No | Monthly quota, in-depth reports |
406
- | `gpt56_terra` | OpenAI | Toggle | GPT-5.6 Terra |
407
- | `gpt56_sol` | OpenAI | Toggle | GPT-5.6 Sol (Max tier required) |
408
- | `gpt6_sol` | OpenAI | Toggle | GPT-6 Sol |
409
- | `grok45` | xAI | Toggle | Grok 4.5 |
410
- | `grok47` | xAI | Toggle | Grok 4.7 |
411
- | `claude_sonnet` | Anthropic | Toggle | Claude Sonnet 5 |
412
- | `claude_opus` | Anthropic | Toggle | Claude Opus 4.8 (Max tier required) |
413
- | `claude_opus55` | Anthropic | Toggle | Claude Opus 5.5 (Max tier required) |
414
- | `gemini_pro` | Google | Always | Gemini 3.1 Pro |
415
- | `gemini38` | Google | Toggle | Gemini 3.8 Flash |
416
- | `nemotron` | NVIDIA | Always | Nemotron 3 Ultra 550B |
417
- | `glm52` | Z.ai | Always | GLM 5.2 |
418
- | `glm53` | Z.ai | Always | GLM 5.3 |
419
- | `kimi_k26` | Moonshot | Toggle | Kimi K2.6 |
420
- | `kimi_k3` | Moonshot | Always | Kimi K3 |
401
+ | CLI Name | Provider | Thinking | Notes |
402
+ | ------------------ | ---------- | -------- | ------------------------------------------------ |
403
+ | `auto` | Perplexity | No | Auto-selects best model |
404
+ | `sonar` | Perplexity | No | Sonar 2 (latest in-house; API id `experimental`) |
405
+ | `deep_research` | Perplexity | No | Monthly quota, in-depth reports |
406
+ | `gpt61_sol` | OpenAI | Toggle | GPT-6.1 Sol |
407
+ | `gpt6_astra` | OpenAI | Toggle | GPT-6 Astra (Max tier required) |
408
+ | `gemini4_carbon` | Google | Toggle | Gemini 4 Carbon (Max tier required) |
409
+ | `gemini4_hydrogen` | Google | Toggle | Gemini 4 Hydrogen |
410
+ | `claude_sonnet` | Anthropic | Toggle | Claude Sonnet 5.5 |
411
+ | `claude_opus` | Anthropic | Toggle | Claude Opus 5.5 (Max tier required) |
412
+ | `claude_opus55` | Anthropic | Toggle | Alias for Claude Opus 5.5 (Max tier required) |
413
+ | `claude_fable52` | Anthropic | Toggle | Claude Fable 5.2 (Max tier required) |
414
+ | `grok47` | xAI | Toggle | Grok 4.7 |
415
+ | `nemotron` | NVIDIA | No | Nemotron 3.5 Super VL (text-only) |
416
+ | `glm53` | Z.ai | Always | GLM 5.3 |
417
+ | `kimi_k3` | Moonshot | Always | Kimi K3 |
421
418
 
422
419
  The catalog is server-driven: run `pwm models` to see the live model list (free, no query quota),
423
420
  and any identifier it shows can be passed to `pwm ask -m <identifier>`.
@@ -495,21 +492,23 @@ claude mcp add perplexity pwm-mcp
495
492
 
496
493
  **Query tools:**
497
494
 
498
- | Tool | Description |
499
- | ------------------------------------------------- | ------------------------------------------- |
500
- | `pplx_query` | Flexible: model selection + thinking toggle |
501
- | `pplx_ask` | Quick Q&A (auto-selects best model) |
502
- | `pplx_deep_research` | In-depth reports with sources |
503
- | `pplx_sonar` | Perplexity Sonar 2 (1 Pro Search) |
504
- | `pplx_gpt56_terra` / `pplx_gpt56_terra_thinking` | GPT-5.6 Terra |
505
- | `pplx_gpt56_sol` / `pplx_gpt56_sol_thinking` | GPT-5.6 Sol (Max tier) |
506
- | `pplx_grok45` / `pplx_grok45_thinking` | Grok 4.5 |
507
- | `pplx_claude_sonnet` / `pplx_claude_sonnet_think` | Claude Sonnet 5 |
508
- | `pplx_claude_opus` / `pplx_claude_opus_think` | Claude Opus 4.8 (Max tier) |
509
- | `pplx_gemini_pro_think` | Gemini 3.1 Pro (thinking always on) |
510
- | `pplx_nemotron_thinking` | Nemotron 3 Ultra (thinking always on) |
511
- | `pplx_glm52` | GLM 5.2 (thinking always on) |
512
- | `pplx_kimi_k26` / `pplx_kimi_k26_thinking` | Kimi K2.6 |
495
+ | Tool | Description |
496
+ | ------------------------------------------------------ | ------------------------------------------- |
497
+ | `pplx_query` | Flexible: model selection + thinking toggle |
498
+ | `pplx_ask` | Quick Q&A (auto-selects best model) |
499
+ | `pplx_deep_research` | In-depth reports with sources |
500
+ | `pplx_sonar` | Perplexity Sonar 2 (1 Pro Search) |
501
+ | `pplx_gpt61_sol` / `pplx_gpt61_sol_thinking` | GPT-6.1 Sol |
502
+ | `pplx_gpt6_astra` / `pplx_gpt6_astra_thinking` | GPT-6 Astra (Max tier) |
503
+ | `pplx_gemini4_carbon` / `pplx_gemini4_carbon_thinking` | Gemini 4 Carbon (Max tier) |
504
+ | `pplx_gemini4_hydrogen` / `..._thinking` | Gemini 4 Hydrogen |
505
+ | `pplx_claude_sonnet` / `pplx_claude_sonnet_think` | Claude Sonnet 5.5 |
506
+ | `pplx_claude_opus` / `pplx_claude_opus_think` | Claude Opus 5.5 (Max tier) |
507
+ | `pplx_claude_fable52` / `pplx_claude_fable52_think` | Claude Fable 5.2 (Max tier) |
508
+ | `pplx_grok47` / `pplx_grok47_thinking` | Grok 4.7 |
509
+ | `pplx_nemotron` | Nemotron 3.5 Super VL |
510
+ | `pplx_glm53` | GLM 5.3 (thinking always on) |
511
+ | `pplx_kimi_k3` | Kimi K3 (thinking always on) |
513
512
 
514
513
  **Smart routing (1):**
515
514
 
@@ -525,12 +524,12 @@ claude mcp add perplexity pwm-mcp
525
524
 
526
525
  **Usage, connectors & auth tools (5):**
527
526
 
528
- | Tool | Description |
529
- | ------------------------ | ------------------------------- |
530
- | `pplx_usage` | Check remaining quotas |
531
- | `pplx_connectors` | List connector source IDs |
532
- | `pplx_auth_status` | Check authentication status |
533
- | `pplx_auth_request_code` | Send verification code to email |
527
+ | Tool | Description |
528
+ | ------------------------ | -------------------------------------- |
529
+ | `pplx_usage` | Check remaining quotas |
530
+ | `pplx_connectors` | List connector source IDs |
531
+ | `pplx_auth_status` | Check authentication status |
532
+ | `pplx_auth_request_code` | Send verification code to email |
534
533
  | `pplx_auth_complete` | Complete email and TOTP authentication |
535
534
 
536
535
  All query tools support `source_focus`: `none`, `web`, `academic`, `social`, `finance`, `all`, or a connector source ID returned by `pplx_connectors()`.
@@ -592,21 +591,23 @@ export OPENAI_API_KEY=dummy
592
591
  codex -m sonar --local-provider lmstudio
593
592
  ```
594
593
 
595
- Our server's `MODEL_MAP` will seamlessly intercept `sonar` (or any other mapped names like `gemini-pro`, `nemotron`, `glm-5.2`, `claude-sonnet-5`) and correctly route it to Perplexity's API. You can also create an alias in your shell to make this easier: `alias codex-pplx="codex --local-provider lmstudio"`.
594
+ Our server's `MODEL_MAP` will seamlessly intercept `sonar` (or any other mapped names like `gemini-4-hydrogen`, `nemotron`, `glm-5.3`, `claude-sonnet-5-5`) and correctly route it to Perplexity's API. You can also create an alias in your shell to make this easier: `alias codex-pplx="codex --local-provider lmstudio"`.
596
595
 
597
596
  ### API Model Names
598
597
 
599
- | API Name | Perplexity Model | Thinking |
600
- | ------------------------------- | ------------------ | -------- |
601
- | `perplexity-auto` | Best (auto-select) | No |
602
- | `gpt-5.6-terra` | GPT-5.6 Terra | Toggle |
603
- | `gpt-5.6-sol` | GPT-5.6 Sol | Toggle |
604
- | `grok-4.5` | Grok 4.5 | Toggle |
605
- | `claude-sonnet-5` | Claude Sonnet 5 | Toggle |
606
- | `claude-opus-4-8` | Claude Opus 4.8 | Toggle |
607
- | `gemini-3.1-pro` | Gemini 3.1 Pro | Always |
608
- | `glm-5.2` / `glm52` | GLM 5.2 | Always |
609
- | `nemotron-3-ultra` / `nemotron` | Nemotron 3 Ultra | Always |
598
+ | API Name | Perplexity Model | Thinking |
599
+ | ----------------------- | --------------------- | -------- |
600
+ | `perplexity-auto` | Best (auto-select) | No |
601
+ | `gpt-6.1-sol` | GPT-6.1 Sol | Toggle |
602
+ | `gpt-6-astra` | GPT-6 Astra | Toggle |
603
+ | `gemini-4-carbon` | Gemini 4 Carbon | Toggle |
604
+ | `gemini-4-hydrogen` | Gemini 4 Hydrogen | Toggle |
605
+ | `claude-sonnet-5-5` | Claude Sonnet 5.5 | Toggle |
606
+ | `claude-opus-5-5` | Claude Opus 5.5 | Toggle |
607
+ | `claude-fable-5-2` | Claude Fable 5.2 | Toggle |
608
+ | `grok-4.7` | Grok 4.7 | Toggle |
609
+ | `glm-5.3` / `glm53` | GLM 5.3 | Always |
610
+ | `nemotron-3.5-super-vl` | Nemotron 3.5 Super VL | No |
610
611
 
611
612
  Legacy aliases (`claude-3-5-sonnet`, `claude-3-opus`) are supported for compatibility.
612
613
 
@@ -24,14 +24,14 @@
24
24
 
25
25
  MCP server, CLI, and API-compatible interface for Perplexity AI's web interface.
26
26
 
27
- Use your Perplexity Pro/Max subscription to access premium models (Sonar 2, GPT-6 Sol, GPT-5.6 Terra, Gemini 3.8 Flash, Claude Sonnet 5, Claude Opus 5.5, Kimi K3, GLM 5.3, Grok 4.7, and Nemotron 3 Ultra) from the terminal, through MCP tools, or as an API endpoint.
27
+ Use your Perplexity Pro/Max subscription to access premium models (GPT-6.1 Sol, GPT-6 Astra, Gemini 4 Carbon, Gemini 4 Hydrogen, Claude Sonnet 5.5, Claude Opus 5.5, Claude Fable 5.2, Grok 4.7, GLM 5.3, Kimi K3, and Nemotron 3.5 Super VL) from the terminal, through MCP tools, or as an API endpoint.
28
28
 
29
29
  ## Features
30
30
 
31
31
  - **CLI**: Query Perplexity models directly from the terminal (`pwm ask`, `pwm chat`, `pwm council`, `pwm research`, `pwm config`)
32
32
  - **MCP Server**: MCP tools for AI agents with citations, rate limit checking, and multi-turn context
33
33
  - **API Server**: Drop-in Anthropic Messages API and OpenAI Chat Completions API
34
- - **10 Models**: Sonar 2, GPT-5.6 Terra, GPT-5.6 Sol, Gemini 3.1 Pro, Claude Sonnet 5, Claude Opus 4.8, GLM 5.2, Kimi K2.6, Grok 4.5, and Nemotron 3 Ultra
34
+ - **Premium Models**: GPT-6.1 Sol, GPT-6 Astra, Gemini 4 Carbon, Gemini 4 Hydrogen, Claude Sonnet 5.5, Claude Opus 5.5, Claude Fable 5.2, Grok 4.7, GLM 5.3, Kimi K3, and Nemotron 3.5 Super VL
35
35
  - **Thinking Mode**: Extended thinking support for all compatible models
36
36
  - **Deep Research**: Full support for Perplexity's Deep Research mode
37
37
  - **Multi-Turn Conversations**: State-preserved threaded conversations for both MCP and CLI REPL
@@ -139,7 +139,7 @@ pwm ask "What is quantum computing?"
139
139
  **Choose a specific model** with `-m` (see [Models](#models) for the full list):
140
140
 
141
141
  ```bash
142
- pwm ask "Compare React and Vue" -m gpt56_terra
142
+ pwm ask "Compare React and Vue" -m gpt61_sol
143
143
  ```
144
144
 
145
145
  ```bash
@@ -185,7 +185,7 @@ pwm ask "What is Rust?" --no-citations
185
185
  **Combine flags** for full control:
186
186
 
187
187
  ```bash
188
- pwm ask "recent advances in protein folding" -m gemini_pro -s academic --json
188
+ pwm ask "recent advances in protein folding" -m gemini4_hydrogen -s academic --json
189
189
  ```
190
190
 
191
191
  **Long prompts and attachments:**
@@ -244,13 +244,13 @@ pwm research "NVIDIA competitive landscape" -s finance --json
244
244
  Query multiple models in parallel and get a synthesized consensus. Each model costs 1 Pro Search. Default synthesis uses Sonar 2 (also 1 Pro Search).
245
245
 
246
246
  ```bash
247
- # Default: GPT-5.6 Terra, Claude Sonnet, Gemini Pro + Sonar 2 synthesis (4 Pro Searches)
247
+ # Default: GPT-6.1 Sol, Claude Sonnet 5.5, Gemini 4 Hydrogen + Sonar 2 synthesis (4 Pro Searches)
248
248
  pwm council "What are best practices for microservices?"
249
249
  ```
250
250
 
251
251
  ```bash
252
252
  # Custom model selection
253
- pwm council "Compare Rust and Go" -m gpt56_terra,claude_sonnet
253
+ pwm council "Compare Rust and Go" -m gpt61_sol,claude_sonnet
254
254
  ```
255
255
 
256
256
  ```bash
@@ -299,7 +299,7 @@ Seamlessly launch external AI tools connected to the Perplexity API server. This
299
299
 
300
300
  ```bash
301
301
  pwm hack claude # Launch Claude Code
302
- pwm hack claude -m gpt56_terra # Launch Claude Code with a specific model
302
+ pwm hack claude -m gpt61_sol # Launch Claude Code with a specific model
303
303
  ```
304
304
 
305
305
  ### MCP Setup
@@ -360,26 +360,23 @@ pwm --ai # Print comprehensive AI-optimized reference
360
360
 
361
361
  ## Models
362
362
 
363
- | CLI Name | Provider | Thinking | Notes |
364
- | --------------- | ---------- | -------- | ------------------------------------------------ |
365
- | `auto` | Perplexity | No | Auto-selects best model |
366
- | `sonar` | Perplexity | No | Sonar 2 (latest in-house; API id `experimental`) |
367
- | `deep_research` | Perplexity | No | Monthly quota, in-depth reports |
368
- | `gpt56_terra` | OpenAI | Toggle | GPT-5.6 Terra |
369
- | `gpt56_sol` | OpenAI | Toggle | GPT-5.6 Sol (Max tier required) |
370
- | `gpt6_sol` | OpenAI | Toggle | GPT-6 Sol |
371
- | `grok45` | xAI | Toggle | Grok 4.5 |
372
- | `grok47` | xAI | Toggle | Grok 4.7 |
373
- | `claude_sonnet` | Anthropic | Toggle | Claude Sonnet 5 |
374
- | `claude_opus` | Anthropic | Toggle | Claude Opus 4.8 (Max tier required) |
375
- | `claude_opus55` | Anthropic | Toggle | Claude Opus 5.5 (Max tier required) |
376
- | `gemini_pro` | Google | Always | Gemini 3.1 Pro |
377
- | `gemini38` | Google | Toggle | Gemini 3.8 Flash |
378
- | `nemotron` | NVIDIA | Always | Nemotron 3 Ultra 550B |
379
- | `glm52` | Z.ai | Always | GLM 5.2 |
380
- | `glm53` | Z.ai | Always | GLM 5.3 |
381
- | `kimi_k26` | Moonshot | Toggle | Kimi K2.6 |
382
- | `kimi_k3` | Moonshot | Always | Kimi K3 |
363
+ | CLI Name | Provider | Thinking | Notes |
364
+ | ------------------ | ---------- | -------- | ------------------------------------------------ |
365
+ | `auto` | Perplexity | No | Auto-selects best model |
366
+ | `sonar` | Perplexity | No | Sonar 2 (latest in-house; API id `experimental`) |
367
+ | `deep_research` | Perplexity | No | Monthly quota, in-depth reports |
368
+ | `gpt61_sol` | OpenAI | Toggle | GPT-6.1 Sol |
369
+ | `gpt6_astra` | OpenAI | Toggle | GPT-6 Astra (Max tier required) |
370
+ | `gemini4_carbon` | Google | Toggle | Gemini 4 Carbon (Max tier required) |
371
+ | `gemini4_hydrogen` | Google | Toggle | Gemini 4 Hydrogen |
372
+ | `claude_sonnet` | Anthropic | Toggle | Claude Sonnet 5.5 |
373
+ | `claude_opus` | Anthropic | Toggle | Claude Opus 5.5 (Max tier required) |
374
+ | `claude_opus55` | Anthropic | Toggle | Alias for Claude Opus 5.5 (Max tier required) |
375
+ | `claude_fable52` | Anthropic | Toggle | Claude Fable 5.2 (Max tier required) |
376
+ | `grok47` | xAI | Toggle | Grok 4.7 |
377
+ | `nemotron` | NVIDIA | No | Nemotron 3.5 Super VL (text-only) |
378
+ | `glm53` | Z.ai | Always | GLM 5.3 |
379
+ | `kimi_k3` | Moonshot | Always | Kimi K3 |
383
380
 
384
381
  The catalog is server-driven: run `pwm models` to see the live model list (free, no query quota),
385
382
  and any identifier it shows can be passed to `pwm ask -m <identifier>`.
@@ -457,21 +454,23 @@ claude mcp add perplexity pwm-mcp
457
454
 
458
455
  **Query tools:**
459
456
 
460
- | Tool | Description |
461
- | ------------------------------------------------- | ------------------------------------------- |
462
- | `pplx_query` | Flexible: model selection + thinking toggle |
463
- | `pplx_ask` | Quick Q&A (auto-selects best model) |
464
- | `pplx_deep_research` | In-depth reports with sources |
465
- | `pplx_sonar` | Perplexity Sonar 2 (1 Pro Search) |
466
- | `pplx_gpt56_terra` / `pplx_gpt56_terra_thinking` | GPT-5.6 Terra |
467
- | `pplx_gpt56_sol` / `pplx_gpt56_sol_thinking` | GPT-5.6 Sol (Max tier) |
468
- | `pplx_grok45` / `pplx_grok45_thinking` | Grok 4.5 |
469
- | `pplx_claude_sonnet` / `pplx_claude_sonnet_think` | Claude Sonnet 5 |
470
- | `pplx_claude_opus` / `pplx_claude_opus_think` | Claude Opus 4.8 (Max tier) |
471
- | `pplx_gemini_pro_think` | Gemini 3.1 Pro (thinking always on) |
472
- | `pplx_nemotron_thinking` | Nemotron 3 Ultra (thinking always on) |
473
- | `pplx_glm52` | GLM 5.2 (thinking always on) |
474
- | `pplx_kimi_k26` / `pplx_kimi_k26_thinking` | Kimi K2.6 |
457
+ | Tool | Description |
458
+ | ------------------------------------------------------ | ------------------------------------------- |
459
+ | `pplx_query` | Flexible: model selection + thinking toggle |
460
+ | `pplx_ask` | Quick Q&A (auto-selects best model) |
461
+ | `pplx_deep_research` | In-depth reports with sources |
462
+ | `pplx_sonar` | Perplexity Sonar 2 (1 Pro Search) |
463
+ | `pplx_gpt61_sol` / `pplx_gpt61_sol_thinking` | GPT-6.1 Sol |
464
+ | `pplx_gpt6_astra` / `pplx_gpt6_astra_thinking` | GPT-6 Astra (Max tier) |
465
+ | `pplx_gemini4_carbon` / `pplx_gemini4_carbon_thinking` | Gemini 4 Carbon (Max tier) |
466
+ | `pplx_gemini4_hydrogen` / `..._thinking` | Gemini 4 Hydrogen |
467
+ | `pplx_claude_sonnet` / `pplx_claude_sonnet_think` | Claude Sonnet 5.5 |
468
+ | `pplx_claude_opus` / `pplx_claude_opus_think` | Claude Opus 5.5 (Max tier) |
469
+ | `pplx_claude_fable52` / `pplx_claude_fable52_think` | Claude Fable 5.2 (Max tier) |
470
+ | `pplx_grok47` / `pplx_grok47_thinking` | Grok 4.7 |
471
+ | `pplx_nemotron` | Nemotron 3.5 Super VL |
472
+ | `pplx_glm53` | GLM 5.3 (thinking always on) |
473
+ | `pplx_kimi_k3` | Kimi K3 (thinking always on) |
475
474
 
476
475
  **Smart routing (1):**
477
476
 
@@ -487,12 +486,12 @@ claude mcp add perplexity pwm-mcp
487
486
 
488
487
  **Usage, connectors & auth tools (5):**
489
488
 
490
- | Tool | Description |
491
- | ------------------------ | ------------------------------- |
492
- | `pplx_usage` | Check remaining quotas |
493
- | `pplx_connectors` | List connector source IDs |
494
- | `pplx_auth_status` | Check authentication status |
495
- | `pplx_auth_request_code` | Send verification code to email |
489
+ | Tool | Description |
490
+ | ------------------------ | -------------------------------------- |
491
+ | `pplx_usage` | Check remaining quotas |
492
+ | `pplx_connectors` | List connector source IDs |
493
+ | `pplx_auth_status` | Check authentication status |
494
+ | `pplx_auth_request_code` | Send verification code to email |
496
495
  | `pplx_auth_complete` | Complete email and TOTP authentication |
497
496
 
498
497
  All query tools support `source_focus`: `none`, `web`, `academic`, `social`, `finance`, `all`, or a connector source ID returned by `pplx_connectors()`.
@@ -554,21 +553,23 @@ export OPENAI_API_KEY=dummy
554
553
  codex -m sonar --local-provider lmstudio
555
554
  ```
556
555
 
557
- Our server's `MODEL_MAP` will seamlessly intercept `sonar` (or any other mapped names like `gemini-pro`, `nemotron`, `glm-5.2`, `claude-sonnet-5`) and correctly route it to Perplexity's API. You can also create an alias in your shell to make this easier: `alias codex-pplx="codex --local-provider lmstudio"`.
556
+ Our server's `MODEL_MAP` will seamlessly intercept `sonar` (or any other mapped names like `gemini-4-hydrogen`, `nemotron`, `glm-5.3`, `claude-sonnet-5-5`) and correctly route it to Perplexity's API. You can also create an alias in your shell to make this easier: `alias codex-pplx="codex --local-provider lmstudio"`.
558
557
 
559
558
  ### API Model Names
560
559
 
561
- | API Name | Perplexity Model | Thinking |
562
- | ------------------------------- | ------------------ | -------- |
563
- | `perplexity-auto` | Best (auto-select) | No |
564
- | `gpt-5.6-terra` | GPT-5.6 Terra | Toggle |
565
- | `gpt-5.6-sol` | GPT-5.6 Sol | Toggle |
566
- | `grok-4.5` | Grok 4.5 | Toggle |
567
- | `claude-sonnet-5` | Claude Sonnet 5 | Toggle |
568
- | `claude-opus-4-8` | Claude Opus 4.8 | Toggle |
569
- | `gemini-3.1-pro` | Gemini 3.1 Pro | Always |
570
- | `glm-5.2` / `glm52` | GLM 5.2 | Always |
571
- | `nemotron-3-ultra` / `nemotron` | Nemotron 3 Ultra | Always |
560
+ | API Name | Perplexity Model | Thinking |
561
+ | ----------------------- | --------------------- | -------- |
562
+ | `perplexity-auto` | Best (auto-select) | No |
563
+ | `gpt-6.1-sol` | GPT-6.1 Sol | Toggle |
564
+ | `gpt-6-astra` | GPT-6 Astra | Toggle |
565
+ | `gemini-4-carbon` | Gemini 4 Carbon | Toggle |
566
+ | `gemini-4-hydrogen` | Gemini 4 Hydrogen | Toggle |
567
+ | `claude-sonnet-5-5` | Claude Sonnet 5.5 | Toggle |
568
+ | `claude-opus-5-5` | Claude Opus 5.5 | Toggle |
569
+ | `claude-fable-5-2` | Claude Fable 5.2 | Toggle |
570
+ | `grok-4.7` | Grok 4.7 | Toggle |
571
+ | `glm-5.3` / `glm53` | GLM 5.3 | Always |
572
+ | `nemotron-3.5-super-vl` | Nemotron 3.5 Super VL | No |
572
573
 
573
574
  Legacy aliases (`claude-3-5-sonnet`, `claude-3-opus`) are supported for compatibility.
574
575
 
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "perplexity-web-mcp-cli"
3
- version = "0.16.1"
3
+ version = "0.17.1"
4
4
  description = "CLI, MCP server, and Anthropic/OpenAI API-compatible interface for Perplexity AI."
5
5
  license = "MIT"
6
6
  readme = "README.md"
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "perplexity-web-mcp-cli"
3
- version = "0.16.1"
3
+ version = "0.17.1"
4
4
 
5
5
  description = "CLI, MCP server, and Anthropic/OpenAI API-compatible interface for Perplexity AI."
6
6
  authors = [{ name = "Jacob BD" }]