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: Perplexity MCP Server

Available Models

• sonar-reasoning-pro (127k context)

• sonar-reasoning (127k context)

• sonar-pro (200k context)

• sonar (127k context)

Installation

pnpm install
pnpm build

Configuration

API Key

1. Sign up for a Perplexity AI account

2. Get your API key from the dashboard

3. Set the environment variable:

export PERPLEXITY_API_KEY=your_api_key_here

Usage

Direct Execution

node dist/index.js
# or if you made it executable
./dist/index.js

Development

pnpm dev

Testing with MCP Inspector

pnpm inspect

Tool Reference

perplexity_search

Performs a search using Perplexity AI's models.

Parameters:

• query (string, required): The search query

• model (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 decisions

Logging

Logs are written to perplexity-mcp.log in the project root directory.

License

MIT

Contributing

1. Fork the repository

2. Create your feature branch

3. Commit your changes

4. Push to the branch

5. Create a new Pull Request