📌Overview

Purpose: To provide a real-time, web-wide research tool for Claude by integrating the Sonar API through an MCP server implementation.

Overview: The Perplexity Ask MCP Server enables users to interact with the Sonar API, allowing Claude to conduct live web searches and access a broader range of information seamlessly.

Key Features:

• Real-Time Web Searches: Engage with the Sonar API for up-to-date information retrieval during conversations, enhancing the user experience with relevant and current data.

• Easy Configuration: Simple setup process involving cloning the repository, obtaining an API key, and configuring the Claude desktop application, making it accessible for various users and applications.

---

Perplexity Ask MCP Server

An MCP server implementation that integrates the Sonar API to provide Claude with real-time web-wide research.

Tools

• perplexity_ask: Engage with the Sonar API for live web searches.
  • Inputs:
    • messages (array): An array of conversation messages, each with:
      • role (string): The role of the message (e.g., system, user, assistant).
      • content (string): The content of the message.

Configuration

1. Clone the Repository:

   git clone git@github.com:ppl-ai/modelcontextprotocol.git
   cd modelcontextprotocol/perplexity-ask && npm install
   

2. Get a Sonar API Key:

   • Sign up for a Sonar API account and generate your API key from the developer dashboard.
   • Set the API key in your environment as PERPLEXITY_API_KEY.

3. Configure Claude Desktop: Add the following to your claude_desktop_config.json:

   {
     "mcpServers": {
       "perplexity-ask": {
         "command": "docker",
         "args": [
           "run",
           "-i",
           "--rm",
           "-e",
           "PERPLEXITY_API_KEY",
           "mcp/perplexity-ask"
         ],
         "env": {
           "PERPLEXITY_API_KEY": "YOUR_API_KEY_HERE"
         }
       }
     }
   }
   

   Alternatively, for NPX:

   {
     "mcpServers": {
       "perplexity-ask": {
         "command": "npx",
         "args": [
           "-y",
           "@modelcontextprotocol/server-perplexity-ask"
         ],
         "env": {
           "PERPLEXITY_API_KEY": "YOUR_API_KEY_HERE"
         }
       }
     }
   }
   

4. Build the Docker Image:

   docker build -t mcp/perplexity-ask:latest -f Dockerfile .
   

5. Testing: Ensure Claude for Desktop recognizes the tools exposed by the server. Look for the hammer icon to confirm the integration is active.

6. Advanced Parameters: You can modify search parameters in the API call directly in the index.ts script as per the official API documentation.

Troubleshooting

Refer to the troubleshooting guide or contact us at api@perplexity.ai for support.

License

This MCP server is licensed under the MIT License, allowing you to use, modify, and distribute the software under its terms.