Perplexity

Provides real-time web search via Perplexity with MCP clients, returning results and citations.

go

4

GitHub Stars

go

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "chenxilol-perplexity-mcp-go": {
      "command": "./perplexity-search-mcp",
      "args": [],
      "env": {
        "PERPLEXITY_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

You can run the Perplexity Search MCP Server to bridge Perplexity’s web search API with your MCP clients. It lets models access live web results, citations, and related data through a straightforward local or containerized server, enabling dynamic search capabilities in your MCP workflows.

How to use

Start by running the MCP server locally so your client can request searches. You will need a Perplexity API key and a working Go toolchain. Once the server is running, your MCP client can request perplexity_search actions to perform web searches, retrieve results with citations, and optionally expand with related questions or images.

How to install

Prerequisites you need before installation:

Go 1.23 or higher
Perplexity API key
A compatible MCP client

Step 1. Build the server locally from source (Go is required):

# Clone the repository
git clone https://github.com/chenxilol/perplexity-mcp-go.git
cd perplexity-mcp-go

# Build the binary
go build -o perplexity-search-mcp

Step 2. Set your Perplexity API key in your environment:

export PERPLEXITY_API_KEY="your-api-key-here"

Step 3. Run the server locally:

./perplexity-search-mcp

If you prefer a containerized setup, you can run the server in Docker. Build and run with your API key set as an environment variable in the container:

docker build -t perplexity-search-mcp:latest .
docker run -i --rm -e PERPLEXITY_API_KEY=your-api-key-here perplexity-search-mcp:latest

Configuration and integration notes

To integrate with an MCP client such as Claude Desktop, you will specify the MCP server entry with the executable path and the required environment variable.

{
  "mcpServers": {
    "perplexity_search": {
      "command": "/path/to/perplexity-search-mcp",
      "env": {
        "PERPLEXITY_API_KEY": "your-api-key-here"
      }
    }
  }
}

Troubleshooting

If you encounter issues, verify that your API key is set correctly and that the server can reach Perplexity’s API. Check network connectivity and inspect logs for error messages.

Available tools

perplexity_search

Tool to perform web searches via MCP; returns results, citations, and optional related data like related questions and images.