Perplexity

GitHub
Integrates with
Perplexity AI

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

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