Perplexity Web Search MCP Server
A simple MCP (Model Context Protocol) server that provides web search functionality using the Perplexity API. This server allows Claude or other MCP-compatible AI assistants to search the web and get up-to-date information.
Features
- Search the web with Perplexity's powerful search capabilities
- Get comprehensive search results with sources and citations
- Filter results by time period (day, week, month, year)
- Includes a ready-to-use prompt template for web searches
- Supports loading API key from environment variables or .env file
Installation
- Clone this repository
- Install dependencies:
orpip install -e .uv pip install -e .
Configuration
You can set the PERPLEXITY_API_KEY environment variable with your Perplexity API key:
export PERPLEXITY_API_KEY="your-api-key-here"
Alternatively, you can create a .env file in the project root with the following content:
PERPLEXITY_API_KEY=your-api-key-here
A sample .env.example file is provided for reference.
To get a Perplexity API key:
- Visit Perplexity API Settings
- Create an account if you don't have one
- Generate an API key
Usage
Running the server
python server.py
Testing the server
You can test the server functionality without running the full MCP server using the included test script:
python test_server.py "your search query here" --recency month
Options for --recency are: day, week, month (default), year
Using with Claude Desktop
-
Edit your Claude Desktop configuration file:
- On macOS:
~/Library/Application\ Support/Claude/claude_desktop_config.json - On Windows:
%APPDATA%/Claude/claude_desktop_config.json
- On macOS:
-
Add the following configuration:
{ "perplexity-mcp": { "env": { "PERPLEXITY_API_KEY": "your-api-key-here" }, "command": "python", "args": [ "/path/to/server.py" ] } }
-
Restart Claude Desktop
Example Prompts for Claude
- "Search the web for the latest news about artificial intelligence"
- "Use Perplexity to find information about climate change published in the past week"
- "Search for recent research papers on quantum computing from the past month"
API Reference
Tool: search_web(query: str, recency: str = "month") -> str
Search the web using Perplexity API and return results.
Parameters:
query: The search query stringrecency: Filter results by time period - 'day', 'week', 'month' (default), or 'year'
Returns: A comprehensive text response containing:
- A detailed summary of the search results
- Key facts and information found
- Sources with URLs for verification
- Any conflicting information if present
Prompt: web_search_prompt(query: str, recency: str = "month") -> str
Creates a prompt template for searching the web with Perplexity.
Parameters:
query: The search queryrecency: Time period filter - 'day', 'week', 'month' (default), or 'year'
Returns: A formatted prompt string that instructs the AI to:
- Search for the specified query
- Focus on results from the specified time period
- Summarize key findings
- Highlight important facts
- Mention conflicting information
- Cite sources with links
License
MIT
Metadata
Release files for iflow-mcp_perplexity-mcp 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| iflow_mcp_perplexity_mcp-0.1.0.tar.gz | 3.8 kB | Without provenance | Details for iflow_mcp_perplexity_mcp-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| iflow_mcp_perplexity_mcp-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for iflow_mcp_perplexity_mcp-0.1.0-py3-none-any.whl |
Total release size: 8.3 kB
Release files / iflow_mcp_perplexity_mcp-0.1.0.tar.gz
| Download URL | iflow_mcp_perplexity_mcp-0.1.0.tar.gz |
|---|---|
| Size | 3.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4b441b96f786eae9265facfac7cc38532affe23aaf4e5b25c29f4e73315b512e
|
|
BLAKE2b-256 checksum How to use checksums |
2577f45a210eddcd5018731e2bacd602988335006356efbf4429c12185c976d0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.6.9
|
Release files / iflow_mcp_perplexity_mcp-0.1.0-py3-none-any.whl
| Download URL | iflow_mcp_perplexity_mcp-0.1.0-py3-none-any.whl |
|---|---|
| Size | 4.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
65530121051fb37e93fca2b96d6e2d2d03bd27dd971bdfa36c7beae3407cf310
|
|
BLAKE2b-256 checksum How to use checksums |
93ceed359023ac86f99cf5e3e8a014b6e9469eaad6b29ff110208db60edc0d2f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.6.9
|
Security for iflow-mcp_perplexity-mcp 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.