@perplexity-ai/mcp-server 0.8.1 → 0.8.3

package/.claude-plugin/marketplace.json

@@ -6,14 +6,14 @@
   },
   "metadata": {
     "description": "Official Perplexity AI plugin providing real-time web search, reasoning, and research capabilities",
-    "version": "0.8.1"
+    "version": "0.8.3"
   },
   "plugins": [
     {
       "name": "perplexity",
       "source": "./",
       "description": "Real-time web search, reasoning, and research through Perplexity's API",
-      "version": "0.8.1",
+      "version": "0.8.3",
       "author": {
         "name": "Perplexity AI",
         "email": "api@perplexity.ai"

package/dist/server.js

@@ -43,6 +43,51 @@ export function validateMessages(messages, toolName) {
 export function stripThinkingTokens(content) {
     return content.replace(/<think>[\s\S]*?<\/think>/g, '').trim();
 }
+async function makeApiRequest(endpoint, body, serviceOrigin) {
+    if (!PERPLEXITY_API_KEY) {
+        throw new Error("PERPLEXITY_API_KEY environment variable is required");
+    }
+    // Read timeout fresh each time to respect env var changes
+    const TIMEOUT_MS = parseInt(process.env.PERPLEXITY_TIMEOUT_MS || "300000", 10);
+    const url = new URL(`${PERPLEXITY_BASE_URL}/${endpoint}`);
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), TIMEOUT_MS);
+    let response;
+    try {
+        const headers = {
+            "Content-Type": "application/json",
+            "Authorization": `Bearer ${PERPLEXITY_API_KEY}`,
+        };
+        if (serviceOrigin) {
+            headers["X-Service"] = serviceOrigin;
+        }
+        response = await proxyAwareFetch(url.toString(), {
+            method: "POST",
+            headers,
+            body: JSON.stringify(body),
+            signal: controller.signal,
+        });
+    }
+    catch (error) {
+        clearTimeout(timeoutId);
+        if (error instanceof Error && error.name === "AbortError") {
+            throw new Error(`Request timeout: Perplexity API did not respond within ${TIMEOUT_MS}ms. Consider increasing PERPLEXITY_TIMEOUT_MS.`);
+        }
+        throw new Error(`Network error while calling Perplexity API: ${error}`);
+    }
+    clearTimeout(timeoutId);
+    if (!response.ok) {
+        let errorText;
+        try {
+            errorText = await response.text();
+        }
+        catch (parseError) {
+            errorText = "Unable to parse error response";
+        }
+        throw new Error(`Perplexity API error: ${response.status} ${response.statusText}\n${errorText}`);
+    }
+    return response;
+}
 export async function consumeSSEStream(response) {
     const body = response.body;
     if (!body) {
@@ -111,13 +156,7 @@ export async function consumeSSEStream(response) {
     return ChatCompletionResponseSchema.parse(assembled);
 }
 export async function performChatCompletion(messages, model = "sonar-pro", stripThinking = false, serviceOrigin, options) {
-    if (!PERPLEXITY_API_KEY) {
-        throw new Error("PERPLEXITY_API_KEY environment variable is required");
-    }
-    // Read timeout fresh each time to respect env var changes
-    const TIMEOUT_MS = parseInt(process.env.PERPLEXITY_TIMEOUT_MS || "300000", 10);
     const useStreaming = model === "sonar-deep-research";
-    const url = new URL(`${PERPLEXITY_BASE_URL}/chat/completions`);
     const body = {
         model: model,
         messages: messages,
@@ -127,42 +166,7 @@ export async function performChatCompletion(messages, model = "sonar-pro", strip
         ...(options?.search_context_size && { web_search_options: { search_context_size: options.search_context_size } }),
         ...(options?.reasoning_effort && { reasoning_effort: options.reasoning_effort }),
     };
-    const controller = new AbortController();
-    const timeoutId = setTimeout(() => controller.abort(), TIMEOUT_MS);
-    let response;
-    try {
-        const headers = {
-            "Content-Type": "application/json",
-            "Authorization": `Bearer ${PERPLEXITY_API_KEY}`,
-        };
-        if (serviceOrigin) {
-            headers["X-Service"] = serviceOrigin;
-        }
-        response = await proxyAwareFetch(url.toString(), {
-            method: "POST",
-            headers,
-            body: JSON.stringify(body),
-            signal: controller.signal,
-        });
-        clearTimeout(timeoutId);
-    }
-    catch (error) {
-        clearTimeout(timeoutId);
-        if (error instanceof Error && error.name === "AbortError") {
-            throw new Error(`Request timeout: Perplexity API did not respond within ${TIMEOUT_MS}ms. Consider increasing PERPLEXITY_TIMEOUT_MS.`);
-        }
-        throw new Error(`Network error while calling Perplexity API: ${error}`);
-    }
-    if (!response.ok) {
-        let errorText;
-        try {
-            errorText = await response.text();
-        }
-        catch (parseError) {
-            errorText = "Unable to parse error response";
-        }
-        throw new Error(`Perplexity API error: ${response.status} ${response.statusText}\n${errorText}`);
-    }
+    const response = await makeApiRequest("chat/completions", body, serviceOrigin);
     let data;
     try {
         if (useStreaming) {
@@ -217,54 +221,13 @@ export function formatSearchResults(data) {
     return formattedResults;
 }
 export async function performSearch(query, maxResults = 10, maxTokensPerPage = 1024, country, serviceOrigin) {
-    if (!PERPLEXITY_API_KEY) {
-        throw new Error("PERPLEXITY_API_KEY environment variable is required");
-    }
-    // Read timeout fresh each time to respect env var changes
-    const TIMEOUT_MS = parseInt(process.env.PERPLEXITY_TIMEOUT_MS || "300000", 10);
-    const url = new URL(`${PERPLEXITY_BASE_URL}/search`);
     const body = {
         query: query,
         max_results: maxResults,
         max_tokens_per_page: maxTokensPerPage,
         ...(country && { country }),
     };
-    const controller = new AbortController();
-    const timeoutId = setTimeout(() => controller.abort(), TIMEOUT_MS);
-    let response;
-    try {
-        const headers = {
-            "Content-Type": "application/json",
-            "Authorization": `Bearer ${PERPLEXITY_API_KEY}`,
-        };
-        if (serviceOrigin) {
-            headers["X-Service"] = serviceOrigin;
-        }
-        response = await proxyAwareFetch(url.toString(), {
-            method: "POST",
-            headers,
-            body: JSON.stringify(body),
-            signal: controller.signal,
-        });
-        clearTimeout(timeoutId);
-    }
-    catch (error) {
-        clearTimeout(timeoutId);
-        if (error instanceof Error && error.name === "AbortError") {
-            throw new Error(`Request timeout: Perplexity Search API did not respond within ${TIMEOUT_MS}ms. Consider increasing PERPLEXITY_TIMEOUT_MS.`);
-        }
-        throw new Error(`Network error while calling Perplexity Search API: ${error}`);
-    }
-    if (!response.ok) {
-        let errorText;
-        try {
-            errorText = await response.text();
-        }
-        catch (parseError) {
-            errorText = "Unable to parse error response";
-        }
-        throw new Error(`Perplexity Search API error: ${response.status} ${response.statusText}\n${errorText}`);
-    }
+    const response = await makeApiRequest("search", body, serviceOrigin);
     let data;
     try {
         const json = await response.json();
@@ -278,7 +241,7 @@ export async function performSearch(query, maxResults = 10, maxTokensPerPage = 1
 export function createPerplexityServer(serviceOrigin) {
     const server = new McpServer({
         name: "ai.perplexity/mcp-server",
-        version: "0.8.1",
+        version: "0.8.3",
     }, {
         instructions: "Perplexity AI server for web-grounded search, research, and reasoning. " +
             "Use perplexity_search for finding URLs, facts, and recent news. " +
@@ -337,7 +300,8 @@ export function createPerplexityServer(serviceOrigin) {
         annotations: {
             readOnlyHint: true,
             openWorldHint: true,
-            idempotentHint: true,
+            idempotentHint: false,
+            destructiveHint: false,
         },
     }, async (args) => {
         const { messages, search_recency_filter, search_domain_filter, search_context_size } = args;
@@ -366,7 +330,8 @@ export function createPerplexityServer(serviceOrigin) {
         annotations: {
             readOnlyHint: true,
             openWorldHint: true,
-            idempotentHint: true,
+            idempotentHint: false,
+            destructiveHint: false,
         },
     }, async (args) => {
         const { messages, strip_thinking, reasoning_effort } = args;
@@ -394,7 +359,8 @@ export function createPerplexityServer(serviceOrigin) {
         annotations: {
             readOnlyHint: true,
             openWorldHint: true,
-            idempotentHint: true,
+            idempotentHint: false,
+            destructiveHint: false,
         },
     }, async (args) => {
         const { messages, strip_thinking, search_recency_filter, search_domain_filter, search_context_size } = args;
@@ -434,7 +400,8 @@ export function createPerplexityServer(serviceOrigin) {
         annotations: {
             readOnlyHint: true,
             openWorldHint: true,
-            idempotentHint: true,
+            idempotentHint: false,
+            destructiveHint: false,
         },
     }, async (args) => {
         const { query, max_results, max_tokens_per_page, country } = args;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@perplexity-ai/mcp-server",
-  "version": "0.8.1",
+  "version": "0.8.3",
   "mcpName": "ai.perplexity/mcp-server",
   "description": "Real-time web search, reasoning, and research through Perplexity's API",
   "keywords": [