Overview
Perplexity AI MCP Server is an implementation that integrates Perplexity AI's API, providing advanced search capabilities with multiple model options.
To use the server, install the necessary packages, configure your API key, and execute the server using Node.js.
- Search using Perplexity AI's models - Support for all official Sonar models - Configurable result count - Detailed error handling and logging - MCP Inspector compatible
- Performing advanced searches using AI models.
- Integrating with applications that require intelligent search capabilities.
- Analyzing search results with detailed logging and error handling.
Add to your AI client
Use these steps to connect Perplexity AI MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.
Cursor
Add this to your .cursor/mcp.json file in your project root, then restart Cursor.
.cursor/mcp.json
{
"mcpServers": {
"mkusaka-mcp-server-perplexity-mcp-mirror": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mkusaka-mcp-server-perplexity-mcp-mirror"
]
}
}
}Claude Desktop
Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
{
"mcpServers": {
"mkusaka-mcp-server-perplexity-mcp-mirror": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mkusaka-mcp-server-perplexity-mcp-mirror"
]
}
}
}Claude Code
Add this to your project's .mcp.json file. Claude Code will detect it automatically.
.mcp.json (project root)
{
"mcpServers": {
"mkusaka-mcp-server-perplexity-mcp-mirror": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mkusaka-mcp-server-perplexity-mcp-mirror"
]
}
}
}VS Code (Copilot)
Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.
.vscode/mcp.json
{
"servers": {
"mkusaka-mcp-server-perplexity-mcp-mirror": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mkusaka-mcp-server-perplexity-mcp-mirror"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mkusaka-mcp-server-perplexity-mcp-mirror": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mkusaka-mcp-server-perplexity-mcp-mirror"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"mkusaka-mcp-server-perplexity-mcp-mirror": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mkusaka-mcp-server-perplexity-mcp-mirror"
]
}
}
}FAQ
What models are supported?
The server supports multiple models including sonar-reasoning-pro, sonar-reasoning, sonar-pro, and sonar.
How do I configure the API key?
Sign up for a Perplexity AI account, obtain your API key, and set it as an environment variable.
Is there a logging feature?
Yes, logs are written to `perplexity-mcp.log` in the project root directory.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":1335,"uuid":"6a315f9a-0723-45b2-9402-3a672e1c5f61","name":"mkusaka_mcp-server-perplexity","title":"Perplexity AI MCP Server","description":"Mirror of","avatar_url":"https://avatars.githubusercontent.com/u/192820360?v=4","created_at":"$D2025-02-20T15:26:41.528Z","updated_at":"$D2025-02-23T07:12:22.397Z","status":"created","author_name":"MCP-Mirror","author_avatar_url":"https://avatars.githubusercontent.com/u/192820360?v=4","tags":"mathgpt,math-solver,math-assistant","category":"research-and-data","is_featured":false,"sort":1,"url":"https://github.com/MCP-Mirror/mkusaka_mcp-server-perplexity","target":"_self","content":"$29","summary":"$2a","img_url":null,"type":null,"metadata":null,"user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]