perplexity-web-mcp-cli 0.12.1__tar.gz → 0.12.2__tar.gz

{perplexity_web_mcp_cli-0.12.1 → perplexity_web_mcp_cli-0.12.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: perplexity-web-mcp-cli
-Version: 0.12.1
+Version: 0.12.2
 Summary: CLI, MCP server, and Anthropic/OpenAI API-compatible interface for Perplexity AI.
 Keywords: perplexity,ai,mcp,anthropic,api,client
 Author: Jacob BD
@@ -41,6 +41,13 @@ Description-Content-Type: text/markdown
 
 # Perplexity Web MCP & CLI
 
+[![PyPI version](https://img.shields.io/pypi/v/perplexity-web-mcp-cli)](https://pypi.org/project/perplexity-web-mcp-cli/)
+[![PyPI downloads](https://img.shields.io/pypi/dm/perplexity-web-mcp-cli)](https://pypistats.org/packages/perplexity-web-mcp-cli)
+[![Total downloads](https://static.pepy.tech/badge/perplexity-web-mcp-cli)](https://pepy.tech/projects/perplexity-web-mcp-cli)
+[![Python](https://img.shields.io/pypi/pyversions/perplexity-web-mcp-cli)](https://pypi.org/project/perplexity-web-mcp-cli/)
+[![License](https://img.shields.io/pypi/l/perplexity-web-mcp-cli)](https://github.com/jacob-bd/perplexity-web-mcp/blob/main/LICENSE)
+[![Buy Me a Coffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-FFDD00?style=flat-square&logo=buy-me-a-coffee&logoColor=black)](https://buymeacoffee.com/jacobbd)
+
 <p align="center">
   <a href="https://youtu.be/9xyClDvmoZ0">
     <img src="https://img.youtube.com/vi/9xyClDvmoZ0/maxresdefault.jpg" alt="Perplexity Powerhouse + Model Council Demo" width="400">

{perplexity_web_mcp_cli-0.12.1 → perplexity_web_mcp_cli-0.12.2}/README.md

@@ -4,6 +4,13 @@
 
 # Perplexity Web MCP & CLI
 
+[![PyPI version](https://img.shields.io/pypi/v/perplexity-web-mcp-cli)](https://pypi.org/project/perplexity-web-mcp-cli/)
+[![PyPI downloads](https://img.shields.io/pypi/dm/perplexity-web-mcp-cli)](https://pypistats.org/packages/perplexity-web-mcp-cli)
+[![Total downloads](https://static.pepy.tech/badge/perplexity-web-mcp-cli)](https://pepy.tech/projects/perplexity-web-mcp-cli)
+[![Python](https://img.shields.io/pypi/pyversions/perplexity-web-mcp-cli)](https://pypi.org/project/perplexity-web-mcp-cli/)
+[![License](https://img.shields.io/pypi/l/perplexity-web-mcp-cli)](https://github.com/jacob-bd/perplexity-web-mcp/blob/main/LICENSE)
+[![Buy Me a Coffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-FFDD00?style=flat-square&logo=buy-me-a-coffee&logoColor=black)](https://buymeacoffee.com/jacobbd)
+
 <p align="center">
   <a href="https://youtu.be/9xyClDvmoZ0">
     <img src="https://img.youtube.com/vi/9xyClDvmoZ0/maxresdefault.jpg" alt="Perplexity Powerhouse + Model Council Demo" width="400">

{perplexity_web_mcp_cli-0.12.1 → perplexity_web_mcp_cli-0.12.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "perplexity-web-mcp-cli"
-version = "0.12.1"
+version = "0.12.2"
 description = "CLI, MCP server, and Anthropic/OpenAI API-compatible interface for Perplexity AI."
 authors = [{ name = "Jacob BD" }]
 license = "MIT"

{perplexity_web_mcp_cli-0.12.1 → perplexity_web_mcp_cli-0.12.2}/src/perplexity_web_mcp/cli/ai_doc.py

@@ -110,7 +110,7 @@ MODELS
 Name            Identifier              Thinking   Notes
 -----------     ----------------------  ---------  ---------------------------
 auto            pplx_pro                No         Auto-selects best model
-sonar           experimental            No         Sonar 2 (latest in-house)
+sonar           experimental            No         Sonar 2 (concise search mode for grounded responses)
 deep_research   pplx_alpha              No         In-depth reports (monthly quota)
 gpt54           gpt54                   Yes        OpenAI GPT-5.4 (versatile)
 gpt55           gpt55                   Yes        OpenAI GPT-5.5 (latest, Max tier)
@@ -272,8 +272,8 @@ weekly pool (~300). Deep Research draws from a tiny monthly pool (~5-10).
 Wasting Pro queries on simple lookups means nothing left for real questions.
 
 COST MODEL:
-  Sonar 2 (pplx_sonar,     In-house model; still uses your session and Perplexity
-    quick intent)         counters — check pplx_usage() / pwm usage.
+  Sonar 2 (pplx_sonar,     In-house model; uses concise search mode to guarantee responses
+    quick intent)         are grounded. Decrements Perplexity session counters.
   Pro Search (standard,   Typically 1 from weekly Pro Search pool (~300/week
     detailed, pplx_ask,   on Pro/Max; exact rules are enforced by Perplexity).
     pplx_query, premium
@@ -284,7 +284,8 @@ COST MODEL:
 MANDATORY PROTOCOL:
   1. CHECK QUOTA FIRST: Call pplx_usage() before your first query each session.
   2. DEFAULT TO QUICK: Use pplx_smart_query(intent='quick') for most lookups.
-     It prefers Sonar 2 first and only escalates when the query needs a premium model.
+     It prefers Sonar 2 first (using concise mode to guarantee grounding) and
+     only escalates when the query needs a premium model.
   3. ESCALATE ONLY WHEN NEEDED: Use 'standard' for multi-source synthesis,
      'detailed' for complex analysis, 'research' only when user requests it.
   4. NEVER USE DEEP RESEARCH AUTONOMOUSLY — always ask the user first.
@@ -299,7 +300,7 @@ WHEN TO USE EACH INTENT:
   detailed  Complex analysis, deep reasoning, premium model       → 1 Pro
   research  Comprehensive reports (user must request explicitly)  → 1 Research
 
-DECISION RULE: Ask "Can Sonar 2 answer this?" If yes → quick. If no → standard.
+DECISION RULE: Ask "Can Sonar 2 answer this?" If yes → quick (grounded on concise search). If no → standard.
 Only use detailed/research when the complexity genuinely demands it.
 When in doubt, start with quick and escalate if the answer is insufficient.
 

{perplexity_web_mcp_cli-0.12.1 → perplexity_web_mcp_cli-0.12.2}/src/perplexity_web_mcp/data/SKILL.md

@@ -2,7 +2,7 @@
 name: perplexity-web-mcp
 description: "Search the web and query AI models via Perplexity AI using perplexity-web-mcp-cli. Supports CLI commands (pwm ask, pwm research), MCP tools (pplx_*), and Anthropic/OpenAI-compatible API server. Use when the user mentions \"perplexity\", \"pplx\", \"pwm\", \"web search with AI\", \"deep research\", \"search the internet\", or wants to query premium models like GPT-5.4, GPT-5.5, Claude, Gemini, Nemotron through Perplexity's web interface."
 metadata:
-  version: "0.10.7"
+  version: "0.12.2"
   author: "Jacob BD"
 ---
 
@@ -129,7 +129,7 @@ The smart router automatically protects you:
 - **Healthy quota**: Uses the ideal model for your intent
 - **Low quota (<20% pro remaining)**: Response footer warns you to conserve
 - **Critical quota (<10% pro remaining)**: Downgrades detailed→auto to conserve
-- **Exhausted quota**: Falls back to Sonar 2 for everything except research
+- **Exhausted quota**: Falls back to Sonar 2 for everything except research (Sonar 2 is forced to concise mode to ensure grounded responses using search results)
 - **Research exhausted**: Falls back to premium Pro Search
 - Response metadata shows what model was used, why, and remaining quota
 
@@ -312,7 +312,7 @@ For full MCP tool parameters: See [references/mcp-tools.md](references/mcp-tools
 | CLI Name | Provider | Thinking | Notes |
 |----------|----------|----------|-------|
 | auto | Perplexity | No | Auto-selects best |
-| sonar | Perplexity | No | Sonar 2 (API id `experimental`) |
+| sonar | Perplexity | No | Sonar 2 (API id `experimental`). Uses `mode="concise"` to ensure grounded answers. |
 | deep_research | Perplexity | No | Monthly quota |
 | gpt54 | OpenAI | Toggle | GPT-5.4 (versatile) |
 | gpt55 | OpenAI | Toggle | GPT-5.5 (latest, Max tier) |

{perplexity_web_mcp_cli-0.12.1 → perplexity_web_mcp_cli-0.12.2}/src/perplexity_web_mcp/data/references/models.md

@@ -16,7 +16,7 @@ Complete list of models available through Perplexity Web MCP.
 - **Thinking:** No
 - **CLI:** `pwm ask "query" -m sonar`
 - **MCP:** `pplx_sonar(query)` or `pplx_query(query, model="sonar")`
-- **Notes:** Perplexity's latest in-house model.
+- **Notes:** Perplexity's latest in-house model. Settings default to concise search mode (`mode="concise"`), which bypasses interactive copilot to guarantee responses are grounded on retrieved search citations on all accounts (including Free tier fallback).
 
 ### deep_research (Deep Research)
 - **Identifier:** `pplx_alpha`

{perplexity_web_mcp_cli-0.12.1 → perplexity_web_mcp_cli-0.12.2}/src/perplexity_web_mcp/models.py

@@ -25,7 +25,7 @@ class Models:
     BEST = Model(identifier="pplx_pro")
     """Best - Automatically selects the best model based on the query."""
 
-    SONAR = Model(identifier="experimental")
+    SONAR = Model(identifier="experimental", mode="concise")
     """Sonar 2 — Perplexity's latest in-house model (backend id: experimental)."""
 
     GEMINI_31_PRO_THINKING = Model(identifier="gemini31pro_high")