Perplexity AI MCP Server
Integrates with Perplexity AI's API to provide advanced search capabilities through the perplexity_search tool, supporting multiple Sonar models including sonar-reasoning-pro, sonar-reasoning, sonar-pro, and sonar
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Perplexity AI MCP Server search for latest developments in quantum computing with 3 results"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Perplexity AI MCP Server
An MCP server implementation that integrates Perplexity AI's API, providing advanced search capabilities with multiple model options.
Features
Search using Perplexity AI's models
Support for all official Sonar models
Configurable result count
Detailed error handling and logging
MCP Inspector compatible
Related MCP server: PPX-MCP
Available Models
sonar-reasoning-pro (127k context)
sonar-reasoning (127k context)
sonar-pro (200k context)
sonar (127k context)
Installation
pnpm install
pnpm buildConfiguration
API Key
Sign up for a Perplexity AI account
Get your API key from the dashboard
Set the environment variable:
export PERPLEXITY_API_KEY=your_api_key_hereUsage
Direct Execution
node dist/index.js
# or if you made it executable
./dist/index.jsDevelopment
pnpm devTesting with MCP Inspector
pnpm inspectTool Reference
perplexity_search
Performs a search using Perplexity AI's models.
Parameters:
query(string, required): The search querymodel(string, optional): Model to use (default: "sonar")Available options: sonar-reasoning-pro, sonar-reasoning, sonar-pro, sonar
count(number, optional): Number of results (1-10, default: 5)
Development
Project Structure
src/perplexity/
├── index.ts # Main server implementation
├── lib/
│ └── logger.ts # Logging configuration
└── adr.md # Architectural decisionsLogging
Logs are written to perplexity-mcp.log in the project root directory.
License
MIT
Contributing
Fork the repository
Create your feature branch
Commit your changes
Push to the branch
Create a new Pull Request
Available Tools
1 toolperplexity_searchC
Search using Perplexity AI's models with context-aware responses and citations
Inputs: query (required), model, count.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool, there is no possibility of ambiguity or overlap between tools. The tool's purpose is clearly defined as searching using Perplexity AI's models, making it distinct by default.
The single tool name 'perplexity_search' follows a clear and consistent verb_noun pattern (search as the verb, perplexity as a modifier). With only one tool, naming consistency is inherently perfect as there are no other tools to compare against.
A single tool is generally too few for most server purposes, as it limits functionality and flexibility. For a search-focused server, additional tools like filtering, citation management, or model selection might be expected to provide a more complete experience.
The server's domain appears to be search using Perplexity AI, but with only one search tool, there are significant gaps. Missing operations could include advanced search parameters, result refinement, citation handling, or integration with other Perplexity features, making the surface incomplete for typical search workflows.
Maintenance
Related MCP Connectors
An MCP server that integrates with Discord to provide AI-powered features.
Driflyte MCP server which lets AI assistants query topic-specific knowledge from web and GitHub.
MCP server for AI dialogue using various LLM models via AceDataCloud
MCP server for OpenAI API (chat completions, image generation, embeddings) via AceDataCloud
Related MCP Servers
- MIT
- AlicenseAqualityDmaintenanceAn unofficial MCP server for Perplexity AI that leverages Pro subscriptions and browser cookies to enable real-time web searches and model selection without an API key. It provides tools for performing queries, listing available models, and automating the login process to manage authentication.430 npmMIT
- AlicenseNot gradedqualityFmaintenanceAn MCP server that integrates with Poe's API to provide AI-powered search and research tools from Perplexity, Reka, Exa, and Linkup.28 npm8MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that enables AI agents to perform search-augmented queries and deep multi-source research using the Perplexity API.26Apache 2.0