@perplexity-ai/mcp-server 0.4.0 → 0.4.1

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

package/README.md

@@ -1,5 +1,11 @@
 # Perplexity API Platform MCP Server
 
+[![Install in Cursor](https://custom-icon-badges.demolab.com/badge/Install_in_Cursor-000000?style=for-the-badge&logo=cursor-ai-white)](https://cursor.com/en/install-mcp?name=perplexity&config=eyJ0eXBlIjoic3RkaW8iLCJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBwZXJwbGV4aXR5LWFpL21jcC1zZXJ2ZXIiXX0=)
+ 
+[![Install in VS Code](https://custom-icon-badges.demolab.com/badge/Install_in_VS_Code-007ACC?style=for-the-badge&logo=vsc&logoColor=white)](https://vscode.dev/redirect/mcp/install?name=perplexity&config=%7B%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40perplexity-ai%2Fmcp-server%22%5D%7D)
+ 
+[![npm version](https://img.shields.io/npm/v/%40perplexity-ai%2Fmcp-server?style=for-the-badge&logo=npm&logoColor=white&color=CB3837)](https://www.npmjs.com/package/@perplexity-ai/mcp-server)
+
 The official MCP server implementation for the Perplexity API Platform, providing AI assistants with real-time web search, reasoning, and research capabilities through Sonar models and the Search API.
 
 Please refer to the official [DeepWiki page](https://deepwiki.com/ppl-ai/modelcontextprotocol) for assistance with implementation.
@@ -76,9 +82,9 @@ Or add to your `claude.json`:
 }
 ```
 
-### Cursor
+### Cursor / VS Code
 
-Add to your `mcp.json`:
+Add to your `mcp.json` (Cursor) or `.vscode/mcp.json` (VS Code):
 
 ```json
 {
@@ -95,6 +101,8 @@ Add to your `mcp.json`:
 }
 ```
 
+Or use the one-click install badges at the top of this README.
+
 ### Codex
 
 Run in your terminal:
@@ -136,7 +144,7 @@ If you are running this server at work—especially behind a company firewall or
 
 **1. Get your proxy details**
 
-- Ask your IT department for your HTTP(S) proxy address and port.
+- Ask your IT department for your HTTPS proxy address and port.
 - You may also need a username and password.
 
 **2. Set the proxy environment variable**
@@ -144,20 +152,22 @@ If you are running this server at work—especially behind a company firewall or
 The easiest and most reliable way for Perplexity MCP is to use `PERPLEXITY_PROXY`. For example:
 
 ```bash
-export PERPLEXITY_PROXY=http://your-proxy-host:8080
+export PERPLEXITY_PROXY=https://your-proxy-host:8080
 ```
 
-- If your proxy needs a username and password, use:
-  ```bash
-  export PERPLEXITY_PROXY=http://username:password@your-proxy-host:8080
-  ```
+If your proxy needs a username and password, use:
+
+```bash
+export PERPLEXITY_PROXY=https://username:password@your-proxy-host:8080
+```
 
 **3. Alternate: Standard environment variables**
 
 If you'd rather use the standard variables, we support `HTTPS_PROXY` and `HTTP_PROXY`.
 
 > [!NOTE]
->The server checks proxy settings in this order: `PERPLEXITY_PROXY` → `HTTPS_PROXY` → `HTTP_PROXY`. If none are set, it connects directly to the internet.
+> The server checks proxy settings in this order: `PERPLEXITY_PROXY` → `HTTPS_PROXY` → `HTTP_PROXY`. If none are set, it connects directly to the internet.
+> URLs must include `https://`. Typical ports are `8080`, `3128`, and `80`.
 
 ## Troubleshooting
 
@@ -165,16 +175,7 @@ If you'd rather use the standard variables, we support `HTTPS_PROXY` and `HTTP_P
 - **Connection Errors**: Check your internet connection and API key validity
 - **Tool Not Found**: Make sure the package is installed and the command path is correct
 - **Timeout Errors**: For very long research queries, set `PERPLEXITY_TIMEOUT_MS` to a higher value
-- **Proxy Issues**: If you're behind a corporate firewall and experience connection errors, you likely need to set up a proxy:
-  - Obtain your proxy server address and port from your IT department.
-  - Set the environment variable before running the server, e.g.:
-    - `export PERPLEXITY_PROXY=http://proxy-address:port`
-    - If authentication is needed: `export PERPLEXITY_PROXY=http://username:password@proxy-address:port`
-    - Typical proxy ports include 8080, 3128, or 80.
-  - The format for authenticated proxies is:  
-    `http://username:password@proxy-host:port`
-  - Double-check the address, port, and credentials if connections fail or time out.
-  - If you continue to have issues, your firewall may be blocking traffic; ask IT if traffic for `api.perplexity.ai` is being restricted.
+- **Proxy Issues**: Verify your `PERPLEXITY_PROXY` or `HTTPS_PROXY` setup and ensure `api.perplexity.ai` isn't blocked by your firewall.
 
 For support, visit [community.perplexity.ai](https://community.perplexity.ai) or [file an issue](https://github.com/perplexityai/modelcontextprotocol/issues).
 

package/dist/index.js

@@ -19,6 +19,7 @@ import { fetch as undiciFetch, ProxyAgent } from "undici";
  */
 const PERPLEXITY_ASK_TOOL = {
     name: "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 ask completion response from the Perplexity model.",
@@ -46,6 +47,10 @@ const PERPLEXITY_ASK_TOOL = {
         },
         required: ["messages"],
     },
+    annotations: {
+        readOnlyHint: true,
+        openWorldHint: true,
+    },
 };
 /**
  * Definition of the Perplexity Research Tool.
@@ -53,6 +58,7 @@ const PERPLEXITY_ASK_TOOL = {
  */
 const PERPLEXITY_RESEARCH_TOOL = {
     name: "perplexity_research",
+    title: "Deep Research",
     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.",
@@ -84,6 +90,10 @@ const PERPLEXITY_RESEARCH_TOOL = {
         },
         required: ["messages"],
     },
+    annotations: {
+        readOnlyHint: true,
+        openWorldHint: true,
+    },
 };
 /**
  * Definition of the Perplexity Reason Tool.
@@ -91,6 +101,7 @@ const PERPLEXITY_RESEARCH_TOOL = {
  */
 const PERPLEXITY_REASON_TOOL = {
     name: "perplexity_reason",
+    title: "Advanced Reasoning",
     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.",
@@ -122,6 +133,10 @@ const PERPLEXITY_REASON_TOOL = {
         },
         required: ["messages"],
     },
+    annotations: {
+        readOnlyHint: true,
+        openWorldHint: true,
+    },
 };
 /**
  * Definition of the Perplexity Search Tool.
@@ -129,8 +144,10 @@ const PERPLEXITY_REASON_TOOL = {
  */
 const PERPLEXITY_SEARCH_TOOL = {
     name: "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.",
+        "Returns ranked search results with titles, URLs, snippets, and metadata. " +
+        "Perfect for finding up-to-date facts, news, or specific information.",
     inputSchema: {
         type: "object",
         properties: {
@@ -157,6 +174,10 @@ const PERPLEXITY_SEARCH_TOOL = {
         },
         required: ["query"],
     },
+    annotations: {
+        readOnlyHint: true,
+        openWorldHint: true,
+    },
 };
 // Retrieve the Perplexity API key from environment variables
 const PERPLEXITY_API_KEY = process.env.PERPLEXITY_API_KEY;
@@ -415,12 +436,23 @@ export function performSearch(query_1) {
 }
 // Initialize the server with tool metadata and capabilities
 const server = new Server({
-    name: "example-servers/perplexity-ask",
-    version: "0.1.0",
+    name: "io.github.perplexityai/mcp-server",
+    version: "0.4.1",
 }, {
     capabilities: {
         tools: {},
     },
+    instructions: `You are the Perplexity MCP Server. Use these tools appropriately:
+
+- perplexity_search: For quick web searches when you need current information or facts. Returns ranked search results.
+
+- perplexity_ask: For general questions and conversational queries with real-time web search using the sonar-pro model.
+
+- perplexity_research: For deep, comprehensive research requiring thorough analysis using the sonar-deep-research model. Use this for complex topics that require detailed investigation.
+
+- perplexity_reason: For complex analytical tasks requiring advanced reasoning using the sonar-reasoning-pro model. Use this for logical problems, analysis, and decision-making.
+
+When using perplexity_research or perplexity_reason, consider setting strip_thinking=true to save context tokens if the reasoning process isn't needed in the final output.`,
 });
 /**
  * Registers a handler for listing available tools.

package/package.json

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