Perplexity

by spences10

Recommended

8 stars

121 downloads

Not rated

GitHub

About

Web search and chat completion powered by the Perplexity AI API.

Details

Author: spences10
Repository: spences10/mcp-perplexity-search
GitHub stars: 8
Downloads: 121
License: MIT License
Categories: Search, AI, Other

- 🤖 Advanced chat completion using Perplexity's AI models
- 📝 Predefined prompt templates for common scenarios:
- Technical documentation generation
- Security best practices analysis
- Code review and improvements
- API documentation in structured format
- 🎯 Custom template support for specialized use cases
- 📊 Multiple output formats (text, markdown, JSON)
- 🔍 Optional source URL inclusion in responses
- ⚙️ Configurable model parameters (temperature, max tokens)
- 🚀 Support for various Perplexity models including Sonar and LLaMA

Setting up with Highlight

Follow these steps to add this server as a custom Highlight plugin:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name Perplexity

Command (node, npx, python, etc.) npx
Arguments
- Argument 1 -y
- Argument 2 mcp-perplexity-search
Environment
- PERPLEXITY_API_KEY your-perplexity-api-key
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "perplexity": {
            "env": {
                "PERPLEXITY_API_KEY": "your-perplexity-api-key"
            },
            "args": [
                "-y",
                "mcp-perplexity-search"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "perplexity": {
            "env": {},
            "args": [
                "bash",
                "-c",
                "source ~/.nvm/nvm.sh && PERPLEXITY_API_KEY=your-perplexity-api-key /home/username/.nvm/versions/node/v20.12.1/bin/npx mcp-perplexity-search"
            ],
            "command": "wsl.exe"
        }
    }
}

JSON

{
    "mcpServers": {
        "perplexity": {
            "env": {
                "PERPLEXITY_API_KEY": "your-perplexity-api-key"
            },
            "args": [
                "-y",
                "mcp-perplexity-search"
            ],
            "command": "npx"
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "perplexity": {
            "env": {
                "PERPLEXITY_API_KEY": "your-perplexity-api-key"
            },
            "args": [
                "-y",
                "mcp-perplexity-search"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "perplexity": {
            "env": {},
            "args": [
                "bash",
                "-c",
                "source ~/.nvm/nvm.sh && PERPLEXITY_API_KEY=your-perplexity-api-key /home/username/.nvm/versions/node/v20.12.1/bin/npx mcp-perplexity-search"
            ],
            "command": "wsl.exe"
        }
    }
}

JSON

{
    "mcpServers": {
        "perplexity": {
            "env": {
                "PERPLEXITY_API_KEY": "your-perplexity-api-key"
            },
            "args": [
                "-y",
                "mcp-perplexity-search"
            ],
            "command": "npx"
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "perplexity": {
            "env": {
                "PERPLEXITY_API_KEY": "your-perplexity-api-key"
            },
            "args": [
                "-y",
                "mcp-perplexity-search"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "perplexity": {
            "env": {},
            "args": [
                "bash",
                "-c",
                "source ~/.nvm/nvm.sh && PERPLEXITY_API_KEY=your-perplexity-api-key /home/username/.nvm/versions/node/v20.12.1/bin/npx mcp-perplexity-search"
            ],
            "command": "wsl.exe"
        }
    }
}

JSON

{
    "mcpServers": {
        "perplexity": {
            "env": {
                "PERPLEXITY_API_KEY": "your-perplexity-api-key"
            },
            "args": [
                "-y",
                "mcp-perplexity-search"
            ],
            "command": "npx"
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "perplexity": {
            "env": {
                "PERPLEXITY_API_KEY": "your-perplexity-api-key"
            },
            "args": [
                "-y",
                "mcp-perplexity-search"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "perplexity": {
            "env": {},
            "args": [
                "bash",
                "-c",
                "source ~/.nvm/nvm.sh && PERPLEXITY_API_KEY=your-perplexity-api-key /home/username/.nvm/versions/node/v20.12.1/bin/npx mcp-perplexity-search"
            ],
            "command": "wsl.exe"
        }
    }
}

JSON

{
    "mcpServers": {
        "perplexity": {
            "env": {
                "PERPLEXITY_API_KEY": "your-perplexity-api-key"
            },
            "args": [
                "-y",
                "mcp-perplexity-search"
            ],
            "command": "npx"
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "perplexity": {
            "env": {
                "PERPLEXITY_API_KEY": "your-perplexity-api-key"
            },
            "args": [
                "-y",
                "mcp-perplexity-search"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "perplexity": {
            "env": {},
            "args": [
                "bash",
                "-c",
                "source ~/.nvm/nvm.sh && PERPLEXITY_API_KEY=your-perplexity-api-key /home/username/.nvm/versions/node/v20.12.1/bin/npx mcp-perplexity-search"
            ],
            "command": "wsl.exe"
        }
    }
}

JSON

{
    "mcpServers": {
        "perplexity": {
            "env": {
                "PERPLEXITY_API_KEY": "your-perplexity-api-key"
            },
            "args": [
                "-y",
                "mcp-perplexity-search"
            ],
            "command": "npx"
        }
    }
}

From the repository

This server requires configuration through your MCP client. Here are
examples for different environments:

Add this to your Cline MCP settings:

{
	"mcpServers": {
		"mcp-perplexity-search": {
			"command": "npx",
			"args": ["-y", "mcp-perplexity-search"],
			"env": {
				"PERPLEXITY_API_KEY": "your-perplexity-api-key"
			}
		}
	}
}

For WSL environments, add this to your Claude Desktop configuration:

{
	"mcpServers": {
		"mcp-perplexity-search": {
			"command": "wsl.exe",
			"args": [
				"bash",
				"-c",
				"source ~/.nvm/nvm.sh && PERPLEXITY_API_KEY=your-perplexity-api-key /home/username/.nvm/versions/node/v20.12.1/bin/npx mcp-perplexity-search"
			]
		}
	}
}

The server requires the following environment variable:

- PERPLEXITY_API_KEY: Your Perplexity API key (required)

`chat_completion`

Generate chat completions using the Perplexity API with support for specialized prompt templates. Parameters: messages (array, required), prompt_template (string, optional), custom_template (object, optional), format (string, optional), include_sources (boolean, optional), model (string, optional), temperature (number, optional), max_tokens (number, optional).

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "perplexity": {
            "env": {
                "PERPLEXITY_API_KEY": "your-perplexity-api-key"
            },
            "args": [
                "-y",
                "mcp-perplexity-search"
            ],
            "command": "npx"
        }
    }
}

Linux

{
    "env": {
        "PERPLEXITY_API_KEY": "your-perplexity-api-key"
    },
    "args": [
        "-y",
        "mcp-perplexity-search"
    ],
    "command": "npx"
}

Macos

{
    "env": {
        "PERPLEXITY_API_KEY": "your-perplexity-api-key"
    },
    "args": [
        "-y",
        "mcp-perplexity-search"
    ],
    "command": "npx"
}

Windows

{
    "env": [],
    "args": [
        "bash",
        "-c",
        "source ~/.nvm/nvm.sh && PERPLEXITY_API_KEY=your-perplexity-api-key /home/username/.nvm/versions/node/v20.12.1/bin/npx mcp-perplexity-search"
    ],
    "command": "wsl.exe"
}

This repository is no longer maintained.

The functionality of this tool is now available inmcp-omnisearch, which combines multiple MCP tools in one unified package.

A Model Context Protocol (MCP) server for integrating Perplexity's AI API with LLMs. This server provides advanced chat completion capabilities with specialized prompt templates for various use cases.

- 🤖 Advanced chat completion using Perplexity's AI models
- 📝 Predefined prompt templates for common scenarios:

- Technical documentation generation
- Security best practices analysis
- Code review and improvements
- API documentation in structured format

This server requires configuration through your MCP client. Here are examples for different environments:

{ "mcpServers": { "mcp-perplexity-search": { "command": "npx", "args": ["-y", "mcp-perplexity-search"], "env": { "PERPLEXITY_API_KEY": "your-perplexity-api-key" } } } }

For WSL environments, add this to your Claude Desktop configuration:

{ "mcpServers": { "mcp-perplexity-search": { "command": "wsl.exe", "args": [ "bash", "-c", "source ~/.nvm/nvm.sh && PERPLEXITY_API_KEY=your-perplexity-api-key /home/username/.nvm/versions/node/v20.12.1/bin/npx mcp-perplexity-search" ] } } }

The server requires the following environment variable:

- PERPLEXITY_API_KEY: Your Perplexity API key (required)

The server implements a single MCP tool with configurable parameters:

Generate chat completions using the Perplexity API with support for specialized prompt templates.

- messages(array, required): Array of message objects with:

- role(string): 'system', 'user', or 'assistant'
- content(string): The message content

- technical_docs: Technical documentation with code examples
- security_practices: Security implementation guidelines
- code_review: Code analysis and improvements
- api_docs: API documentation in JSON format

- system(string): System message for assistant behaviour
- format(string): Output format preference
- include_sources(boolean): Whether to include sources
- Clone the repository
- Install dependencies:

The project uses changesets for version management. To publish:

Contributions are welcome! Please feel free to submit a Pull Request.

MIT License - see theLICENSEfile for details.

- Built on the Model Context Protocol
- Powered by Perplexity SONAR

Search global news using natural language. Webz.io News Search API returns the most relevant articles and content, with filters for source, country, language, date, sentiment, and category.

A connector for the Perplexity API to enable web search within the MCP ecosystem.

Structural AI Search Readiness MCP. Audit, dry-run fixes, rescore, doctor. No LLM rankings.

Perform web searches with the Brave Search API and analyze research papers using Google's Gemini model.

Provides AI-powered web search and summarization using the Gemini API's grounding feature.

Integrate search grounded Gemini output into your workflow.

Generates responses using the Gemini API and Google Search for up-to-date information.

Performs web searches using the Gemini Web Search Tool via the local gemini-cli.

A server providing Google AI-powered search and documentation tools for developers.

Comprehensive web, news, and social media search and analysis using xAI's Grok API.

Enhances LLM responses with factual, real-time web content using Jina AI's grounding capabilities.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

chat_completion

Claude Desktop / Cursor

Linux

Macos

Windows

Install

More like this

Sequential Thinking

Brave Search

Filesystem

EverArt

Google Drive

Context 7

`chat_completion`