perplexity_searchLABSCO SUMMARY
The filters are what make it worth having over plain search.
Recency and domain filtering are the two parameters that change answer quality most: restricting to the last week keeps a fast-moving topic from returning three-year-old pages, and naming domains is how you keep an answer inside sources you trust. Citations come back with the results, so a claim can be checked rather than taken. A single static binary with one environment variable is about as little operational surface as a search tool can have.
What it is
A Go implementation of a Perplexity search bridge. One tool, but with the full parameter surface of the underlying API exposed rather than a simplified wrapper.
What you get
perplexity_searchperforms a web search and returns results with citationssearch_recency_filternarrows results to the last month, week, day or hoursearch_domain_filterrestricts the search to a list of domains you namereturn_imagesandreturn_related_questionsadd image links and follow-up questions to the response- Generation controls passed straight through —
max_tokens,temperaturedefaulting to 0.2,top_pdefaulting to 0.9,presence_penalty,frequency_penaltyand streaming web_search_optionscarries additional search configuration such as context size
Requirements
Go 1.23 or higher to build the binary, or the Dockerfile in the repository. A Perplexity API key in PERPLEXITY_API_KEY, either in the shell or in the client's env block.
Setup effort
Build from source — Prerequisites: Go 1.23 or higher, and a Perplexity API key
USE CASES
01
Answering a question about something recent
Filter to the last week or day so the model is not summarising an outdated page.
02
Keeping research inside trusted sources
Limit the search to a list of domains rather than filtering the results afterwards.
03
Checking where an answer came from
Read the citations returned alongside the result instead of taking the summary on trust.
1 tool
Listed in project docs. Your client may show a different list.
BEFORE YOU INSTALL
What to know first
Tools you get
1 tool named in the project's documentation.
Requires
- Go 1.23 or later
- PERPLEXITY_API_KEY in your environment
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
You clone and build this one yourself.
Server setup
Prerequisites: Go 1.23 or higher, and a Perplexity API key
Clone the repository: git clone https://github.com/chenxilol/perplexity-mcp-go.git then cd perplexity-mcp-go
Build the application: go build -o perplexity-search-mcp (must be done before the config block, which points at this binary)
Set your Perplexity API key: export PERPLEXITY_API_KEY="<YOUR_PERPLEXITY_API_KEY>" (or put it in the config block's env)
Copy claude_desktop_config.json into your Claude config directory and edit it to contain the mcpServers block with the built binary's path and your key
Alternative to steps 2-5: run it in Docker — docker build -t perplexity-search-mcp:latest . then docker run -i --rm -e PERPLEXITY_API_KEY=<YOUR_PERPLEXITY_API_KEY> perplexity-search-mcp:latest
MCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"perplexity-search": {
"command": "<YOUR_PATH_TO_PERPLEXITY_SEARCH_MCP>",
"env": {
"PERPLEXITY_API_KEY": "<YOUR_PERPLEXITY_API_KEY>"
}
}
}
}
