This Perplexity MCP Server is a Node.js implementation of Anthropic's Model Context Protocol that enables Claude to interact with Perplexity AI's language models through two main tools:
perplexity_chat: Generate advanced chat completions with full message history support, temperature control, and access to models like mixtral-8x7b-instruct, codellama-34b-instruct, sonar-small-chat, and sonar-small-online.
perplexity_ask: Send simple, single-query requests to models including llama-3.1-sonar-small-128k-online, llama-3.1-sonar-large-128k-online, and llama-3.1-sonar-huge-128k-online.
The server is type-safe, modular, secure, and can be integrated with Claude Desktop through configuration.
Enables interaction with Perplexity AI's language models, providing capabilities to generate chat completions with full message history support and send simple queries for quick answers using various Llama-based models.
The Perplexity MCP Server is a Node.js implementation of Anthropic's Model Context Protocol (MCP) that enables Claude to interact with Perplexity's language models. This server provides a secure bridge between Claude and Perplexity AI's capabilities, allowing for enhanced AI interactions through tool use.
The server currently implements two main tools:
Advanced chat completion tool with full message history support.
Simplified single-query interface for quick questions.
Clone the repository:
Install dependencies:
Create .env file:
Build the project:
To add this server to Claude Desktop, update your claude_desktop_config.json:
The configuration file is typically located at:
Windows: %APPDATA%/Claude/config/claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/config/claude_desktop_config.json
Linux: ~/.config/Claude/config/claude_desktop_config.json
Start the development server with automatic recompilation:
The server uses TypeScript and implements the MCP protocol using the @modelcontextprotocol/sdk package.
PerplexityServer Class
Implements MCP server protocol
Handles tool registration and execution
Manages error handling and server lifecycle
Tools System
Modular tool definitions
Type-safe tool handlers
Structured input validation
Built with TypeScript for type safety
Uses @modelcontextprotocol/sdk for MCP implementation
Communicates via stdio transport
Environment-based configuration
The server implements comprehensive error handling:
API error reporting
Invalid tool requests handling
Connection error management
Process signal handling
@modelcontextprotocol/sdk: ^1.0.3
dotenv: ^16.4.7
isomorphic-fetch: ^3.0.0
Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add some amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request
API keys are managed through environment variables
Input validation for all tool parameters
Error messages are sanitized before output
Process isolation through MCP protocol
This project is licensed under the ISC License.
Common issues and solutions:
Server Not Found
Verify the path in claude_desktop_config.json is correct
Ensure the server is built (npm run build)
Check if Node.js is in your PATH
Authentication Errors
Verify your Perplexity API key in .env
Check if the API key has the required permissions
Tool Execution Errors
Verify the tool parameters match the schema
Check network connectivity
Review server logs for detailed error messages
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
A Node.js implementation that enables Claude to interact with Perplexity AI's language models through Anthropic's Model Context Protocol, providing tools for advanced chat completions and quick queries.
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/laodev1/perplexity-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server