Modelcontextprotocol MCP Server
Access Perplexity AI search and research tools directly from your AI agent workflow.
Data last scanned today · Reviewed today
Overview
The Perplexity API Platform MCP server provides specialized tools for AI assistants to conduct real-time web searches and generate research-backed responses. It utilizes the Perplexity Search API to fetch ranked results and leverages Sonar models to augment conversational capabilities, ensuring that agents have access to up-to-date information.
Our verdict
This server carries a high risk level with a security score of 53/100. It is a community-maintained project rather than an official vendor release, and critical aspects such as authentication methods and read-only support have not yet been editorially reviewed. Given the lack of formal oversight, users should exercise caution when implementing this server in sensitive environments.
- Supports direct web search via the Perplexity Search API
- Small supply-chain surface with only five direct dependencies
- Active development repository with over 2,400 GitHub stars
- Not maintained or officially supported by the vendor
- Missing editorial review of authentication and read-only modes
- Security status and risk profile remain unverified
Setup
{
"mcpServers": {
"modelcontextprotocol": {
"args": [
"-y",
"@perplexity-ai/mcp-server"
],
"command": "npx"
}
}
}Paste into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows), then restart Claude Desktop. Some servers require API keys or tokens as environment variables — check the project's README and add an "env" object if needed.
- No read-only mode — running this grants full read/write access.
- No built-in authentication — anyone with access to this config can invoke every tool it exposes.
Tools
| Tool | Description | Risk |
|---|---|---|
| perplexity_search | Direct web search using the Perplexity Search API. Returns ranked search results with metadata, perfect for finding current information. | low |
| perplexity_ask | General-purpose conversational AI with real-time web search using the sonar-pro model. Great for quick questions and everyday searches. | low |
| perplexity_research | Deep, comprehensive research using the sonar-deep-research model. Ideal for thorough analysis and detailed reports. | low |
| perplexity_reason | Advanced reasoning and problem-solving using the sonar-reasoning-pro model. Perfect for complex analytical tasks. | low |
Compatibility
| Client | Local | Docker | Remote | Read-only |
|---|---|---|---|---|
| Claude Desktop | ||||
| Cursor | ||||
| VS Code | ||||
| Windsurf | ||||
| ChatGPT |
Frequently asked questions
›What prerequisites are needed to run this server?
You must obtain a Perplexity API key from the official Perplexity API portal. Additionally, the environment requires Node.js installed to execute the server via npx.
›Can I adjust the output format for the reasoning and research tools?
Yes, you can set the optional parameter 'strip_thinking' to 'true' in the perplexity_reason and perplexity_research tools to remove <think> tags from responses.
›How can I increase the default response timeout?
You can modify the server timeout by setting the 'PERPLEXITY_TIMEOUT_MS' environment variable, which defaults to 300,000 milliseconds.
›How do I configure the server for a corporate proxy environment?
You can route traffic through a company proxy by setting the 'PERPLEXITY_PROXY' environment variable to your proxy host and port.
›Does this server support custom API endpoints?
Yes, you can specify a custom base URL by setting the 'PERPLEXITY_BASE_URL' environment variable if you are not using the default API address.
›Is it possible to adjust the verbosity of server logs?
Yes, you can change the log detail level by setting 'PERPLEXITY_LOG_LEVEL' to DEBUG, INFO, WARN, or ERROR.
Badge
Maintain this server? Add the live badge to your README.