@perplexity-ai/mcp-server 0.6.0 → 0.6.2

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.6.0"
+    "version": "0.6.2"
   },
   "plugins": [
     {
       "name": "perplexity",
       "source": "./",
       "description": "Real-time web search, reasoning, and research through Perplexity's API",
-      "version": "0.6.0",
+      "version": "0.6.2",
       "author": {
         "name": "Perplexity AI",
         "email": "api@perplexity.ai"

package/README.md

@@ -34,7 +34,8 @@ Advanced reasoning and problem-solving using the `sonar-reasoning-pro` model. Pe
 1. Get your Perplexity API Key from the [API Portal](https://www.perplexity.ai/account/api/group)
 2. Replace `your_key_here` in the configurations below with your API key
 3. (Optional) Set timeout: `PERPLEXITY_TIMEOUT_MS=600000` (default: 5 minutes)
-4. (Optional) Set log level: `PERPLEXITY_LOG_LEVEL=DEBUG|INFO|WARN|ERROR` (default: ERROR)
+4. (Optional) Set custom base URL: `PERPLEXITY_BASE_URL=https://your-custom-url.com` (default: https://api.perplexity.ai)
+5. (Optional) Set log level: `PERPLEXITY_LOG_LEVEL=DEBUG|INFO|WARN|ERROR` (default: ERROR)
 
 ### Claude Code
 
@@ -145,6 +146,7 @@ For cloud or shared deployments, run the server in HTTP mode.
 | Variable | Description | Default |
 |----------|-------------|---------|
 | `PERPLEXITY_API_KEY` | Your Perplexity API key | *Required* |
+| `PERPLEXITY_BASE_URL` | Custom base URL for API requests | `https://api.perplexity.ai` |
 | `PORT` | HTTP server port | `8080` |
 | `BIND_ADDRESS` | Network interface to bind to | `0.0.0.0` |
 | `ALLOWED_ORIGINS` | CORS origins (comma-separated) | `*` |

package/dist/server.js

@@ -3,6 +3,7 @@ import { z } from "zod";
 import { fetch as undiciFetch, ProxyAgent } from "undici";
 import { ChatCompletionResponseSchema, SearchResponseSchema } from "./validation.js";
 const PERPLEXITY_API_KEY = process.env.PERPLEXITY_API_KEY;
+const PERPLEXITY_BASE_URL = process.env.PERPLEXITY_BASE_URL || "https://api.perplexity.ai";
 export function getProxyUrl() {
     return process.env.PERPLEXITY_PROXY ||
         process.env.HTTPS_PROXY ||
@@ -48,7 +49,7 @@ export async function performChatCompletion(messages, model = "sonar-pro", strip
     }
     // 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("https://api.perplexity.ai/chat/completions");
+    const url = new URL(`${PERPLEXITY_BASE_URL}/chat/completions`);
     const body = {
         model: model,
         messages: messages,
@@ -143,7 +144,7 @@ export async function performSearch(query, maxResults = 10, maxTokensPerPage = 1
     }
     // 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("https://api.perplexity.ai/search");
+    const url = new URL(`${PERPLEXITY_BASE_URL}/search`);
     const body = {
         query: query,
         max_results: maxResults,
@@ -199,27 +200,34 @@ export async function performSearch(query, maxResults = 10, maxTokensPerPage = 1
 export function createPerplexityServer(serviceOrigin) {
     const server = new McpServer({
         name: "io.github.perplexityai/mcp-server",
-        version: "0.6.0",
+        version: "0.6.2",
     });
+    const messageSchema = z.object({
+        role: z.string().describe("Role of the message (e.g., system, user, assistant)"),
+        content: z.string().describe("The content of the message"),
+    });
+    const messagesField = z.array(messageSchema).describe("Array of conversation messages");
+    const stripThinkingField = z.boolean().optional()
+        .describe("If true, removes <think>...</think> tags and their content from the response to save context tokens. Default is false.");
+    const responseOutputSchema = {
+        response: z.string().describe("The response from Perplexity"),
+    };
+    // Input schemas
+    const messagesOnlyInputSchema = { messages: messagesField };
+    const messagesWithStripThinkingInputSchema = { messages: messagesField, strip_thinking: stripThinkingField };
     server.registerTool("perplexity_ask", {
         title: "Ask Perplexity",
         description: "Engages in a conversation using the Sonar API. " +
             "Accepts an array of messages (each with a role and content) " +
             "and returns a chat completion response from the Perplexity model.",
-        inputSchema: {
-            messages: z.array(z.object({
-                role: z.string().describe("Role of the message (e.g., system, user, assistant)"),
-                content: z.string().describe("The content of the message"),
-            })).describe("Array of conversation messages"),
-        },
-        outputSchema: {
-            response: z.string().describe("The chat completion response"),
-        },
+        inputSchema: messagesOnlyInputSchema,
+        outputSchema: responseOutputSchema,
         annotations: {
             readOnlyHint: true,
             openWorldHint: true,
         },
-    }, async ({ messages }) => {
+    }, async (args) => {
+        const { messages } = args;
         validateMessages(messages, "perplexity_ask");
         const result = await performChatCompletion(messages, "sonar-pro", false, serviceOrigin);
         return {
@@ -232,22 +240,14 @@ export function createPerplexityServer(serviceOrigin) {
         description: "Performs deep research using the Perplexity API. " +
             "Accepts an array of messages (each with a role and content) " +
             "and returns a comprehensive research response with citations.",
-        inputSchema: {
-            messages: z.array(z.object({
-                role: z.string().describe("Role of the message (e.g., system, user, assistant)"),
-                content: z.string().describe("The content of the message"),
-            })).describe("Array of conversation messages"),
-            strip_thinking: z.boolean().optional()
-                .describe("If true, removes <think>...</think> tags and their content from the response to save context tokens. Default is false."),
-        },
-        outputSchema: {
-            response: z.string().describe("The research response"),
-        },
+        inputSchema: messagesWithStripThinkingInputSchema,
+        outputSchema: responseOutputSchema,
         annotations: {
             readOnlyHint: true,
             openWorldHint: true,
         },
-    }, async ({ messages, strip_thinking }) => {
+    }, async (args) => {
+        const { messages, strip_thinking } = args;
         validateMessages(messages, "perplexity_research");
         const stripThinking = typeof strip_thinking === "boolean" ? strip_thinking : false;
         const result = await performChatCompletion(messages, "sonar-deep-research", stripThinking, serviceOrigin);
@@ -261,22 +261,14 @@ export function createPerplexityServer(serviceOrigin) {
         description: "Performs reasoning tasks using the Perplexity API. " +
             "Accepts an array of messages (each with a role and content) " +
             "and returns a well-reasoned response using the sonar-reasoning-pro model.",
-        inputSchema: {
-            messages: z.array(z.object({
-                role: z.string().describe("Role of the message (e.g., system, user, assistant)"),
-                content: z.string().describe("The content of the message"),
-            })).describe("Array of conversation messages"),
-            strip_thinking: z.boolean().optional()
-                .describe("If true, removes <think>...</think> tags and their content from the response to save context tokens. Default is false."),
-        },
-        outputSchema: {
-            response: z.string().describe("The reasoning response"),
-        },
+        inputSchema: messagesWithStripThinkingInputSchema,
+        outputSchema: responseOutputSchema,
         annotations: {
             readOnlyHint: true,
             openWorldHint: true,
         },
-    }, async ({ messages, strip_thinking }) => {
+    }, async (args) => {
+        const { messages, strip_thinking } = args;
         validateMessages(messages, "perplexity_reason");
         const stripThinking = typeof strip_thinking === "boolean" ? strip_thinking : false;
         const result = await performChatCompletion(messages, "sonar-reasoning-pro", stripThinking, serviceOrigin);
@@ -285,28 +277,31 @@ export function createPerplexityServer(serviceOrigin) {
             structuredContent: { response: result },
         };
     });
+    const searchInputSchema = {
+        query: z.string().describe("Search query string"),
+        max_results: z.number().min(1).max(20).optional()
+            .describe("Maximum number of results to return (1-20, default: 10)"),
+        max_tokens_per_page: z.number().min(256).max(2048).optional()
+            .describe("Maximum tokens to extract per webpage (default: 1024)"),
+        country: z.string().optional()
+            .describe("ISO 3166-1 alpha-2 country code for regional results (e.g., 'US', 'GB')"),
+    };
+    const searchOutputSchema = {
+        results: z.string().describe("Formatted search results"),
+    };
     server.registerTool("perplexity_search", {
         title: "Search the Web",
         description: "Performs web search using the Perplexity Search API. " +
             "Returns ranked search results with titles, URLs, snippets, and metadata. " +
             "Perfect for finding up-to-date facts, news, or specific information.",
-        inputSchema: {
-            query: z.string().describe("Search query string"),
-            max_results: z.number().min(1).max(20).optional()
-                .describe("Maximum number of results to return (1-20, default: 10)"),
-            max_tokens_per_page: z.number().min(256).max(2048).optional()
-                .describe("Maximum tokens to extract per webpage (default: 1024)"),
-            country: z.string().optional()
-                .describe("ISO 3166-1 alpha-2 country code for regional results (e.g., 'US', 'GB')"),
-        },
-        outputSchema: {
-            results: z.string().describe("Formatted search results"),
-        },
+        inputSchema: searchInputSchema,
+        outputSchema: searchOutputSchema,
         annotations: {
             readOnlyHint: true,
             openWorldHint: true,
         },
-    }, async ({ query, max_results, max_tokens_per_page, country }) => {
+    }, async (args) => {
+        const { query, max_results, max_tokens_per_page, country } = args;
         const maxResults = typeof max_results === "number" ? max_results : 10;
         const maxTokensPerPage = typeof max_tokens_per_page === "number" ? max_tokens_per_page : 1024;
         const countryCode = typeof country === "string" ? country : undefined;

package/package.json

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