perplexity-user-mcp 0.8.37 → 0.8.38

package/README.md

@@ -165,6 +165,92 @@ Claude Desktop (`claude_desktop_config.json`) uses the same shape.
 - `perplexity_login` — returns login instructions (interactive login runs via the CLI / extension)
 - `perplexity_doctor` — run diagnostic checks across browser, profile, auth, and network and return a Markdown report (pass `probe:true` for a live search probe)
 
+## Search sources and advanced queries
+
+Search-style tools support Perplexity source focus through a `sources` argument:
+
+- `web` — general web search. This is the default.
+- `scholar` — scholarly / academic source focus.
+- `social` — social discussion source focus.
+
+The source selector is explicit. If `sources` is omitted, the server sends `["web"]`.
+
+Examples:
+
+```json
+{
+  "tool": "perplexity_search",
+  "arguments": {
+    "query": "recent papers on retrieval augmented generation evaluation",
+    "sources": ["scholar"],
+    "language": "en-US"
+  }
+}
+```
+
+```json
+{
+  "tool": "perplexity_ask",
+  "arguments": {
+    "query": "What are practitioners saying about Cursor versus Windsurf for large TypeScript repos?",
+    "sources": ["social"],
+    "mode": "copilot"
+  }
+}
+```
+
+```json
+{
+  "tool": "perplexity_research",
+  "arguments": {
+    "query": "Compare academic evidence and practitioner discussion around code review automation",
+    "sources": ["scholar", "social"],
+    "language": "en-US"
+  }
+}
+```
+
+Natural-language prompts usually work too when they name the desired source mode:
+
+- "Use Perplexity scholar sources for recent papers on agentic search evaluation."
+- "Search social sources for developer reports about Claude Code memory issues."
+- "Run deep research using both scholar and web sources, and cite every claim."
+- "Use `perplexity_ask` with `sources: [\"social\"]` and keep the answer concise."
+
+Useful shorthand:
+
+- "search ..." usually maps to `perplexity_search` for quick lookup and source discovery.
+- "ask Perplexity ..." usually maps to `perplexity_ask` for a synthesized answer with citations.
+- "reason through ..." usually maps to `perplexity_reason` for multi-step analysis.
+- "research deeply ..." usually maps to `perplexity_research` for longer reports.
+- "use ASI", "Computer mode", "run a compute task", or "do code/execution-style analysis" maps to `perplexity_compute` when the account has Computer-mode access.
+
+For ASI / Computer mode, ask for `perplexity_compute` by name when precision matters:
+
+```json
+{
+  "tool": "perplexity_compute",
+  "arguments": {
+    "query": "Model the true cost of a 5 kW residential solar installation in the Philippines versus investing the same cash at 6% annually over 10 and 20 years. Show assumptions, calculations, and sensitivity cases.",
+    "language": "en-US"
+  }
+}
+```
+
+### Defaults
+
+| Tool | Model default | Mode default | Sources default | Language default |
+|---|---|---|---|---|
+| `perplexity_search` | Authenticated: `pplx_pro`; anonymous: `turbo` | Authenticated: `copilot`; anonymous: `concise` | `["web"]` | `en-US` |
+| `perplexity_ask` | `PERPLEXITY_SEARCH_MODEL` or `pplx_pro` | `copilot` | `["web"]` | `en-US` |
+| `perplexity_reason` | `PERPLEXITY_REASON_MODEL` or `claude46sonnetthinking` | `copilot` | `["web"]` | `en-US` |
+| `perplexity_research` | `PERPLEXITY_RESEARCH_MODEL` or `pplx_alpha` | `copilot` | `["web"]` | `en-US` |
+| `perplexity_compute` | Tool argument, then `PERPLEXITY_COMPUTE_MODEL`, then account ASI default, then `pplx_asi` | `asi` | web-only Computer mode | `en-US` |
+
+Model defaults are configurable with `PERPLEXITY_SEARCH_MODEL`, `PERPLEXITY_REASON_MODEL`, `PERPLEXITY_RESEARCH_MODEL`, and `PERPLEXITY_COMPUTE_MODEL`. `perplexity_ask`, `perplexity_reason`, and `perplexity_compute` also accept a per-call `model` argument. `perplexity_ask` accepts `mode: "concise" | "copilot"`.
+
+Under the hood, search-style tools post a Perplexity web-app style request from the logged-in browser session to `https://www.perplexity.ai/rest/sse/perplexity_ask`. The response is a Server-Sent Events stream, which the MCP runtime parses into answer text, citation sources, media items, suggested follow-ups, follow-up context, and the Perplexity thread URL.
+
 ## Library use
 
 Subpath exports are published for embedding the same runtime inside other Node tooling:

package/dist/daemon/attach.mjs

@@ -1,6 +1,6 @@
 import {
   attachToDaemon
-} from "../chunk-SVPRB62V.mjs";
+} from "../chunk-YUGDOXIN.mjs";
 import "../chunk-X45O6YD3.mjs";
 import "../chunk-KCXM2M4B.mjs";
 import "../chunk-6YMQVLFX.mjs";

package/dist/daemon/index.mjs

@@ -5,7 +5,7 @@ import {
 } from "../chunk-ZQFUZPLO.mjs";
 import {
   attachToDaemon
-} from "../chunk-SVPRB62V.mjs";
+} from "../chunk-YUGDOXIN.mjs";
 import {
   disableDaemonTunnel,
   enableDaemonTunnel,

package/dist/index.d.ts

@@ -154,6 +154,10 @@ declare function __resetVaultPreflightForTests(): void;
  * don't need cookies (perplexity_doctor, anonymous perplexity_search).
  */
 declare function runVaultPreflight(stderr?: NodeJS.WritableStream): Promise<void>;
+declare function waitForStdioInputClose(stdin?: NodeJS.ReadableStream): Promise<void>;
+declare function shutdownClientWithTimeout(c: {
+    shutdown: () => Promise<void>;
+} | undefined, timeoutMs?: number): Promise<void>;
 declare function main(): Promise<void>;
 
-export { type HistoryEntry, PerplexityClient, type ToolProfile, __resetVaultPreflightForTests, buildAnswerPreview, buildHistoryBody, buildHistoryEntry, buildIssueBody, buildIssueUrl, buildStoredHistoryEntry, decideTransport, exportThread, formatResponse, getEnabledTools, loadToolConfig, main, redactIssueBody, registerPrompts, registerResources, registerTools, runVaultPreflight, saveToolConfig, watchToolConfig };
+export { type HistoryEntry, PerplexityClient, type ToolProfile, __resetVaultPreflightForTests, buildAnswerPreview, buildHistoryBody, buildHistoryEntry, buildIssueBody, buildIssueUrl, buildStoredHistoryEntry, decideTransport, exportThread, formatResponse, getEnabledTools, loadToolConfig, main, redactIssueBody, registerPrompts, registerResources, registerTools, runVaultPreflight, saveToolConfig, shutdownClientWithTimeout, waitForStdioInputClose, watchToolConfig };

package/dist/index.mjs

@@ -12,7 +12,7 @@ import {
 } from "./chunk-DPGMKSSA.mjs";
 import {
   attachToDaemon
-} from "./chunk-SVPRB62V.mjs";
+} from "./chunk-YUGDOXIN.mjs";
 import {
   ensureDaemon,
   startDaemon
@@ -122,6 +122,35 @@ async function runVaultPreflight(stderr = process.stderr) {
 `);
   }
 }
+async function waitForStdioInputClose(stdin = process.stdin) {
+  stdin.resume();
+  await new Promise((resolve) => {
+    const done = () => {
+      stdin.off("end", done);
+      stdin.off("close", done);
+      resolve();
+    };
+    stdin.once("end", done);
+    stdin.once("close", done);
+  });
+}
+var SHUTDOWN_TIMEOUT_MS = 5e3;
+async function shutdownClientWithTimeout(c, timeoutMs = SHUTDOWN_TIMEOUT_MS) {
+  if (!c) return;
+  let timer;
+  const timeout = new Promise((resolve) => {
+    timer = setTimeout(() => {
+      console.error(`[perplexity-mcp] WARN shutdown timeout after ${timeoutMs}ms \u2014 exiting.`);
+      resolve();
+    }, timeoutMs);
+    timer.unref?.();
+  });
+  try {
+    await Promise.race([c.shutdown().catch(() => void 0), timeout]);
+  } finally {
+    if (timer) clearTimeout(timer);
+  }
+}
 async function main() {
   client = new PerplexityClient();
   const server = new McpServer({
@@ -147,21 +176,27 @@ async function main() {
   });
   process.on("SIGINT", async () => {
     watcher.dispose();
-    await client.shutdown();
+    await shutdownClientWithTimeout(client);
     process.exit(0);
   });
   process.on("SIGTERM", async () => {
     watcher.dispose();
-    await client.shutdown();
+    await shutdownClientWithTimeout(client);
     process.exit(0);
   });
   const transport = new StdioServerTransport();
   await server.connect(transport);
+  try {
+    await waitForStdioInputClose();
+  } finally {
+    watcher.dispose();
+    await shutdownClientWithTimeout(client);
+  }
 }
 if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
   runEntrypoint().catch(async (error) => {
     console.error("[perplexity-mcp] Fatal error:", error);
-    await client?.shutdown?.().catch(() => void 0);
+    await shutdownClientWithTimeout(client);
     process.exit(1);
   });
 }
@@ -227,10 +262,12 @@ export {
   runAll as runDoctor,
   runVaultPreflight,
   saveToolConfig,
+  shutdownClientWithTimeout,
   startDaemon,
   syncCloudHistory,
   tag,
   update,
   upsertFromCloud,
+  waitForStdioInputClose,
   watchToolConfig
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "perplexity-user-mcp",
-  "version": "0.8.37",
+  "version": "0.8.38",
   "mcpName": "io.github.Automations-Project/perplexity-user-mcp",
   "type": "module",
   "description": "Perplexity AI MCP server — browser automation for search, reasoning, research, and compute. Not affiliated with Perplexity AI, Inc.",