What is the Perplexity Insight MCP Server?

The Perplexity Insight MCP Server is an implementation of the Model Context Protocol (MCP) designed to interface with the Perplexity AI API. It allows you to easily integrate Perplexity AI’s advanced question answering capabilities into your applications.

What is MCP?

MCP stands for Model Context Protocol. It’s an open protocol that standardizes how applications provide context to Large Language Models (LLMs), enabling seamless communication and integration.

What are the key features of the Perplexity Insight MCP Server?

Key features include seamless integration with the Perplexity AI API, support for different Perplexity models (sonar-reasoning, sonar-pro, sonar-deep-research), customizable system prompts and user queries, robust error handling, rate limiting protection, and easy integration with Windsurf IDE.

What models does the Perplexity Insight MCP Server support?

It supports sonar-reasoning (general questions), sonar-pro (professional use cases), and sonar-deep-research (in-depth research).

How do I install the Perplexity Insight MCP Server?

You can install it using npm: npm install.

What environment variables do I need to set?

You need to set the PERPLEXITY_API_KEY environment variable with your Perplexity API key.

How do I run the server?

Run the server with the command: npm start.

What tools does the server expose?

The server exposes two tools: perplexity_ask (for direct questions) and perplexity_search (for search queries).

How do I specify which Perplexity model to use?

Include the model parameter in your request (e.g., Ask Perplexity using sonar-deep-research: What are the latest advancements in quantum computing?).

What is the tool response format?

The server follows the MCP specification, returning a JSON object with content (an array of text elements) and an isError flag.

How do I integrate the server with Windsurf IDE?

Configure a new MCP server in Windsurf with the correct path to your Node.js executable and the compiled index.js file. Ensure the PERPLEXITY_API_KEY environment variable is included.

What is UBOS and how does the Perplexity Insight MCP Server relate to it?

UBOS is a full-stack AI Agent Development Platform. The Perplexity Insight MCP Server can be used within the UBOS ecosystem to build AI Agents that leverage Perplexity AI’s capabilities.

What do I do if I encounter issues with the MCP server?

Check your API key, verify the response format, look for error messages in the server logs, and ensure Windsurf is properly configured.